FreeBSD kernel debugging scripts
This simple repository holds things I find useful for kernel debugging on FreeBSD.
The gdb/ subdirectory holds a set of scripts useful with the kgdb front-end to gdb. To use these scripts, do the following in kgdb:
% git clone https://github.com/bsdjhb/kdbg.git
% cd kdbg/gdb
% kgdb
....
(kgdb) source gdb6
| Filename | Description |
|---|---|
| build | Wrapper script to configure and build gdb from git using the same setup as the devel/gdb port. |
| chelsio | Commands for use with the cxgb(4) and cxgbe(4) drivers (Chelsio T3/T4/T5 NICs). Requires gdb6. |
| dot.gdbinit.kernel | Older scripts from the main source tree. My plan is to eventually move useful scripts out of here to gdb6 and remove this. |
| dot.gdbinit.paths | See above. |
| gdb4 | General commands for use with FreeBSD 4.x |
| gdb6 | General commands for use with FreeBSD 6.x and later |
| gdb6.amd64 | amd64-specific commands for gdb6. Included automatically by gdb6 on amd64 kernels. |
| gdb6.i386 | i386-specific commands for gdb6. Included automatically by gdb6 on i386 kernels. |
| gdb6.riscv | riscv-specific commands for gdb6. |
The dtrace/ subdirectory holds various DTrace scripts.
| Filename | Description |
|---|---|
| callout_funcs.d | Simple histograms of timer functions |
| crypto_drivers.d | Histogram of which drivers are used to service OpenCrypto requests |
| crypto_new_session.d | Trace crypto drivers probing crypto sessions |
| eperm.d | Determine the source of an EPERM error from stat() |
| g_media.d | Trace source of ZFS SPA_PROBE requests. |
| ipmi_req.d | Trace ioctl requests to /dev/ipmi0 |
| rendezvous.d | Generate stats of SMP rendezvous. |
| schedgraph.d | Generate KTR_SCHED-like output for use with schedgraph. Use the make_ktr script to convert the output of this script into what schedgraph expects. I got the original version from rstone@FreeBSD.org. |
| set_regs_diff.py | Output the registers actually changed by each PT_SETREGS ptrace(2) operation |
| syscalls.d | Simple system call histogram. |
| vfsfilt.d | Trace EVFILT_VNODE event activations |
The bhyve/ subdirectory holds various variants of vmrun.sh.