0a7e9ba1f5
Add a -s srvname option to rdbfs, allowing debugging sessions to be shared or later reattached after disconnection.
75 lines
1.1 KiB
Text
75 lines
1.1 KiB
Text
.TH RDBFS 4
|
|
.SH NAME
|
|
rdbfs \- remote kernel debugging file system
|
|
.SH SYNOPSIS
|
|
.B rdbfs
|
|
[
|
|
.B -d
|
|
]
|
|
[
|
|
.B -p
|
|
.I pid
|
|
]
|
|
[
|
|
.B -s
|
|
.I srvname
|
|
]
|
|
[
|
|
.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 ).
|
|
If the
|
|
.B -s
|
|
option is given,
|
|
.I rdbfs
|
|
will post its channel in
|
|
.BI /srv/ srvname
|
|
(see
|
|
.IR srv (3)),
|
|
allowing the session to be shared or reattached later.
|
|
.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.
|
|
(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),
|
|
.IR cons (3),
|
|
.IR consolefs (4)
|