kdbg

FreeBSD kernel debugging scripts

This simple repository holds things I find useful for kernel debugging on FreeBSD.

gdb/

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.

dtrace/

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

bhyve/

The bhyve/ subdirectory holds various variants of vmrun.sh.