plan9fox/sys/man/4/rdbfs
cinap_lenrek 0a7e9ba1f5 rdbfs: add -s srvname (from charles forsyth's rdbfs-srvname patch)
Add a -s srvname option to rdbfs, allowing debugging sessions to be shared
or later reattached after disconnection.
2013-06-14 23:28:59 +02:00

76 lines
1.1 KiB
Plaintext

.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)