xref: /freebsd-14.2/tools/debugscripts/README (revision 0fa02ea5)
1*0fa02ea5SGreg Lehey$FreeBSD$
2*0fa02ea5SGreg Lehey
3*0fa02ea5SGreg LeheyThis directory contains gdb macros for kernel debugging.  When you
4*0fa02ea5SGreg Leheybuild a debug kernel, the target "gdbinit" in the kernel Makefile will
5*0fa02ea5SGreg Leheycreate the correct .gdbinit files in the kernel build directory.  To
6*0fa02ea5SGreg Leheyperform kernel debugging, you would do:
7*0fa02ea5SGreg Lehey
8*0fa02ea5SGreg Lehey  # cd /usr/obj/usr/src/sys/GENERIC  (or name of kernel config)
9*0fa02ea5SGreg Lehey  # make gdbinit
10*0fa02ea5SGreg Lehey  # gdb kernel.debug
11*0fa02ea5SGreg Lehey  This GDB was configured as "i386-undermydesk-freebsd"...
12*0fa02ea5SGreg Lehey  Ready to go.  Enter 'tr' to connect to remote target
13*0fa02ea5SGreg Lehey  and 'getsyms' after connection to load kld symbols.
14*0fa02ea5SGreg Lehey  (kgdb)
15*0fa02ea5SGreg Lehey
16*0fa02ea5SGreg Lehey
17