]> git.lizzy.rs Git - plan9front.git/blob - sys/man/4/rdbfs
merge
[plan9front.git] / sys / man / 4 / rdbfs
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 -t
15 .I text
16 ]
17 [
18 .I device
19 ]
20 .SH DESCRIPTION
21 .I Rdbfs
22 presents in 
23 .BI /proc/ pid
24 (default
25 .BR /proc/1 )
26 a set of process files for debugging
27 a kernel over the serial line 
28 .I device
29 (default 
30 .BR /dev/eia0 ).
31 .PP
32 The 
33 .B text
34 file presented is just a copy of
35 .I text
36 (default
37 .BR /386/9pc ).
38 It can usually be ignored, since
39 the debuggers open kernel
40 files directly rather than
41 using
42 .BI /proc/ n /text\fR.
43 .PP
44 Kernels can be remotely debugged  only when they are
45 suspended and serving
46 a textual debugging protocol over their serial lines.
47 (see
48 .IR cons (3))
49 .PP
50 Because the debugging protocol is textual, a console
51 provided by
52 .IR consolefs (4)
53 may be substituted for the serial device.
54 .SH SOURCE
55 .B /sys/src/cmd/rdbfs.c
56 .br
57 .B /sys/src/9/port/rdb.c
58 .SH "SEE ALSO"
59 .IR acid (1),
60 .IR db (1),
61 .IR cons (3),
62 .IR consolefs (4)