2 # .gdbinit file for remote serial debugging.
4 # XXX Do not use this file directly. It contains parameters which are
5 # XXX substituted by the kernel Makefile when you do a 'make gdbinit'.
6 # XXX This also removes lines starting with '# XXX'.
8 # To debug kernels, do:
10 # cd /usr/obj/usr/src/sys/GENERIC (or kernel build directory)
14 # Read gdb(4) for more details.
16 # The following lines (down to "***** End" comment) may need to be changed
18 # Bit rate for serial link. Due to problems in the interface,
19 # this may not work well above 9600 bps.
30 # ***** End of things you're likely to need to change.
32 # Connect to remote target via a serial port.
34 # Remote debugging port
39 Debug a remote system via serial or firewire interface. For example, specify 'tr /dev/cuau0' to use first serial port, or 'tr localhost:5556' for default firewire port. See also tr0, tr1 and trf commands.
42 # Convenience functions. These call tr.
56 Debug a remote system via serial interface /dev/cuau0. See also tr, tr1 and trf commands.
59 Debug a remote system via serial interface /dev/cuau1. See also tr, tr0 and trf commands.
62 Debug a remote system via firewire interface at default port 5556. See also tr, tr0 and tr1 commands.
65 # Get symbols from klds. Unfortunately, there are a number of
66 # landmines involved here:
68 # When debugging the same machine (via /dev/mem), we can get the
69 # script to call kldstat and pass the info on to asf(8). This won't
70 # work for crashes or remote debugging, of course, because we'd get
71 # the information for the wrong system. Instead, we use the macro
72 # "kldstat", which extracts the information from the "dump". The
73 # trouble here is that it's a pain to use, since gdb doesn't have the
74 # capability to pass data to scripts, so we have to mark it and paste
75 # it into the script. This makes it silly to use this method for
76 # debugging the local system. Instead, we have two scripts:
78 # getsyms uses the information in the "dump", and you have to paste it.
79 # kldsyms uses the local kld information.
81 # Improvements in gdb should make this go away some day.
84 # This will be replaced by the path of the real modules directory.
85 shell asf -f -k MODPATH
89 Read in the symbol tables for the debugging machine. This only makes sense when debugging /dev/mem; use the 'getsyms' macro for remote debugging.
95 echo Select the list above with the mouse, paste into the screen\n
96 echo and then press ^D. Yes, this is annoying.\n
97 # This will be replaced by the path of the real modules directory.
103 Display kldstat information for the target machine and invite user to paste it back in. This causes the symbols for the KLDs to be loaded. When doing memory debugging, use the command kldsyms instead.
106 source gdbinit.kernel
107 source gdbinit.machine
109 echo Ready to go. Enter 'tr' to connect to the remote target\n
110 echo with /dev/cuau0, 'tr /dev/cuau1' to connect to a different port\n
111 echo or 'trf portno' to connect to the remote target with the firewire\n
112 echo interface. portno defaults to 5556.\n
114 echo Type 'getsyms' after connection to load kld symbols.\n
116 echo If you're debugging a local system, you can use 'kldsyms' instead\n
117 echo to load the kld symbols. That's a less obnoxious interface.\n