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)
Copyright © 2024 Plan 9 Foundation. All rights reserved.