9c7fbc3f9b
Introduce a FreeBSDKernel plugin that provides the ability to read FreeBSD kernel core dumps. The plugin utilizes libfbsdvmcore to provide support for both "full memory dump" and minidump formats across variety of architectures supported by FreeBSD. It provides the ability to read kernel memory, as well as the crashed thread status with registers on arm64, i386 and x86_64. Differential Revision: https://reviews.llvm.org/D114911
37 lines
1.3 KiB
ReStructuredText
37 lines
1.3 KiB
ReStructuredText
How to create vmcores for tests
|
|
===============================
|
|
|
|
1. Boot a FreeBSD VM with as little memory as possible and create a core dump
|
|
per `FreeBSD Handbook Kernel Debugging Chapter`_. Note that you may need to
|
|
reboot with more memory after the kernel panic as otherwise savecore(8) may
|
|
fail.
|
|
|
|
For instance, I was able to boot FreeBSD and qemu-system-x86_64 with 128 MiB
|
|
RAM but had to increase it to 256 MiB for the boot after kernel panic.
|
|
|
|
2. Transfer the kernel image (``/boot/kernel/kernel``) and vmcore
|
|
(``/var/crash/vmcore.latest``) from the VM.
|
|
|
|
3. Patch libfbsdvmcore using ``libfbsdvmcore-print-offsets.patch`` and build
|
|
LLDB against the patched library.
|
|
|
|
4. Do a test run of ``test.script`` in LLDB against the kernel + vmcore::
|
|
|
|
lldb -b -s test.script --core /path/to/core /path/to/kernel
|
|
|
|
If everything works fine, the LLDB output should be interspersed with
|
|
``%RD`` lines.
|
|
|
|
5. Use the ``copy-sparse.py`` tool to create a sparse version of the vmcore::
|
|
|
|
lldb -b -s test.script --core /path/to/core /path/to/kernel |
|
|
grep '^% RD' | python copy-sparse.py /path/to/core vmcore.sparse
|
|
|
|
6. Compress the sparse vmcore file using ``bzip2``::
|
|
|
|
bzip2 -9 vmcore.sparse
|
|
|
|
|
|
.. _FreeBSD Handbook Kernel Debugging Chapter:
|
|
https://docs.freebsd.org/en/books/developers-handbook/kerneldebug/
|