xref: /plan9/sys/man/4/rdbfs (revision 062a8c8840a3d90da07e65a643f21404edb5ec69)
RDBFS 4
NAME
rdbfs - remote kernel debugging file system
SYNOPSIS
rdbfs [ -d ] [ -p pid ] [ -s srvname ] [ -t text ] [ device ]
DESCRIPTION
Rdbfs presents in /proc/ pid (default /proc/1 ) a set of process files for debugging a kernel over the serial line device (default /dev/eia0 ). If the -s option is given, rdbfs will post its channel in /srv/ srvname (see srv (3)), allowing the session to be shared or reattached later.

The text file presented is just a copy of text (default /386/9pc ). It can usually be ignored, since the debuggers open kernel files directly rather than using /proc/ n /text.

Kernels can be remotely debugged only when they are suspended and serving a textual debugging protocol over their serial lines. Typing `` ^t^td '' (control- t ", control-" t ", d)" at the console will cause the kernel to enter this mode when it `panics'. Typing `` ^t^tD '' causes the kernel to enter this mode immediately.

Because the debugging protocol is textual, a console provided by consolefs (4) may be substituted for the serial device.

SOURCE
/sys/src/cmd/rdbfs.c

/sys/src/9/port/rdb.c

"SEE ALSO"
acid (1), db (1), consolefs (4)