rdbfs 1.1 KB

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