plan9fox/sys/man/4/rdbfs

63 lines
945 B
Text
Raw Normal View History

.TH RDBFS 4
.SH NAME
rdbfs \- remote kernel debugging file system
.SH SYNOPSIS
.B rdbfs
[
.B -d
]
[
.B -p
.I pid
]
[
.B -t
.I text
]
[
.I device
]
.SH DESCRIPTION
.I Rdbfs
presents in
.BI /proc/ pid
(default
.BR /proc/1 )
a set of process files for debugging
a kernel over the serial line
.I device
(default
.BR /dev/eia0 ).
.PP
The
.B text
file presented is just a copy of
.I text
(default
.BR /386/9pc ).
It can usually be ignored, since
the debuggers open kernel
files directly rather than
using
.BI /proc/ n /text\fR.
.PP
Kernels can be remotely debugged only when they are
suspended and serving
a textual debugging protocol over their serial lines.
2012-09-06 00:45:15 +00:00
(see
.IR cons (3))
.PP
Because the debugging protocol is textual, a console
provided by
.IR consolefs (4)
may be substituted for the serial device.
.SH SOURCE
.B /sys/src/cmd/rdbfs.c
.br
.B /sys/src/9/port/rdb.c
.SH "SEE ALSO"
.IR acid (1),
.IR db (1),
2012-09-06 00:45:15 +00:00
.IR cons (3),
.IR consolefs (4)