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 -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 (see
  61 .IR cons (3))
  62 .PP
  63 Because the debugging protocol is textual, a console
  64 provided by
  65 .IR consolefs (4)
  66 may be substituted for the serial device.
  67 .SH SOURCE
  68 .B /sys/src/cmd/rdbfs.c
  69 .br
  70 .B /sys/src/9/port/rdb.c
  71 .SH "SEE ALSO"
  72 .IR acid (1),
  73 .IR db (1),
  74 .IR cons (3),
  75 .IR consolefs (4)