Subversion Repositories planix.SVN

Rev

Rev 2 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 1 
.TH RDBFS 4
2 
.SH NAME
3 
rdbfs \- remote kernel debugging file system
4 
.SH SYNOPSIS
5 
.B rdbfs
6 
[
7 
.B -d
8 
]
9 
[
10 
.B -p
11 
.I pid
12 
]
13 
[
14 
.B -s
15 
.I srvname
16 
]
17 
[
18 
.B -t
19 
.I text
20 
]
21 
[
22 
.I device
23 
]
24 
.SH DESCRIPTION
25 
.I Rdbfs
26 
presents in
27 
.BI /proc/ pid
28 
(default
29 
.BR /proc/1 )
30 
a set of process files for debugging
31 
a kernel over the serial line
32 
.I device
33 
(default
34 
.BR /dev/eia0 ).
35 
If the
36 
.B -s
37 
option is given,
38 
.I rdbfs
39 
will post its channel in
40 
.BI /srv/ srvname
41 
(see
42 
.IR srv (3)),
43 
allowing the session to be shared or reattached later.
44 
.PP
45 
The
46 
.B text
47 
file presented is just a copy of
48 
.I text
49 
(default
50 
.BR /386/9pc ).
51 
It can usually be ignored, since
52 
the debuggers open kernel
53 
files directly rather than
54 
using
55 
.BI /proc/ n /text\fR.
56 
.PP
57 
Kernels can be remotely debugged  only when they are
58 
suspended and serving
59 
a textual debugging protocol over their serial lines.
60 
Typing
61 
.RB `` ^t^td ''
62 
.RB (control- t ", control-" t ", d)"
63 
at the console will cause the kernel to enter
64 
this mode when it `panics'.
65 
Typing
66 
.RB `` ^t^tD ''
67 
causes the kernel to enter this mode immediately.
68 
.PP
69 
Because the debugging protocol is textual, a console
70 
provided by
71 
.IR consolefs (4)
72 
may be substituted for the serial device.
73 
.SH SOURCE
74 
.B /sys/src/cmd/rdbfs.c
75 
.br
76 
.B /sys/src/9/port/rdb.c
77 
.SH "SEE ALSO"
78 
.IR acid (1),
79 
.IR db (1),
80 
.IR consolefs (4)