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 Typing
  48 .RB `` ^t^td ''
  49 .RB (control- t ", control-" t ", d)"
  50 at the console will cause the kernel to enter
  51 this mode when it `panics'.
  52 Typing
  53 .RB `` ^t^tD ''
  54 causes the kernel to enter this mode immediately.
  55 .PP
  56 Because the debugging protocol is textual, a console
  57 provided by
  58 .IR consolefs (4)
  59 may be substituted for the serial device.
  60 .SH SOURCE
  61 .B /sys/src/cmd/rdbfs.c
  62 .br
  63 .B /sys/src/9/port/rdb.c
  64 .SH "SEE ALSO"
  65 .IR acid (1),
  66 .IR db (1),
  67 .IR consolefs (4)