X-Git-Url: https://gitweb.dragonflybsd.org/ikiwiki.git/blobdiff_plain/60e3e16209e069995ec2b6a432b615f724190605..HEAD:/docs/user/DebugKernelCrashDumps.mdwn diff --git a/docs/user/DebugKernelCrashDumps.mdwn b/docs/user/DebugKernelCrashDumps.mdwn index 9459c892..caf01497 100644 --- a/docs/user/DebugKernelCrashDumps.mdwn +++ b/docs/user/DebugKernelCrashDumps.mdwn @@ -37,9 +37,9 @@ If you are unsure about your swap partition device, use [swapinfo(8)](http://lea /dev/ad0s1b none swap sw 0 0 -### Enable debugging options in your kernel config +### Enable debugging options in your custom kernel config -If you don't know how to configure a custom kernel, look into [Configuring the DragonFly Kernel](kernelconfig.html). You have to add the following lines to compile your kernel with debugging symbols: +If you run a custom kernel you have to add the following lines to compile your kernel with debugging symbols: @@ -56,6 +56,7 @@ If you want additional support for the interactive kernel debugger [ddb(4)](http options INVARIANTS +You don't have to do anything to get debugging enabled in the default GENERIC kernel as it's already there. ## How does a crash look like? @@ -93,7 +94,6 @@ Before your machine reboots a crash dump is saved into your swap partition (if y Now your machine reboots, checks its file system and finally extracts the crash dump from the swap partition to your `dumpdir` (see `rc.conf` setting above). If your `/var` partition is to small, you'll see an error similar to the following: - savecore: reboot after panic: from debugger savecore: no dump, not enough free space on device (231420 available, need 541840) @@ -114,19 +114,21 @@ You can use [savecore(8)](http://leaf.dragonflybsd.org/cgi/web-man?command#savec -This will take some time dependent on the speed of your machine. See the man page of savecore(8) for more available options. +This will take some time dependent on the speed of your machine. See the man page of `savecore(8)` for more available options. + ### Upload the crash dump -If you don't have the ability or skills to debug are crash yourselves, please upload the complete content of your crash directory to a public available location (HTTP, FTP web space or your leaf account) and send a detailed bug report to the bugs@dragonflybsd.org list. If its possible please tar and compress (gzip, bzip2) the directory to save disk space and bandwith. +If you don't have the ability or skills to debug the crash yourselves, please upload the complete content of your crash directory to somewhere private (e.g., cloud share with a password, your leaf account), and open a detailed bug report. Please tar and compress the crash dump to save disk space and bandwidth. +**WARNING**: The saved core file (in `/var/crash`) contains *sensitive* data, e.g., passwords, certificates, decrypted private keys. Therefore, do *not* upload it to somewhere that can be publicly accessed! ## Debug the crash dump with kgdb The [kgdb(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#kgdb§ion1) utility is a debugger based on gdb(1) that allows debugging of kernel core files. -### kgdb extesions +### kgdb extensions To get some handy helper command execute the following command before starting kgdb: