JJonas Devlieghere[NFC][Py Reformat] Reformat python files in lldb

2238dcc3创建于 2023年5月26日历史提交

文件	最后提交记录	最后更新时间
README.rst	[lldb] [Process/FreeBSDKernel] Support finding all processes Include the complete list of threads of all running processes in the FreeBSDKernel plugin. This makes it possible to inspect the states (including partial register dumps from PCB) of all kernel and userspace threads at the time of crash, or at the time of reading /dev/mem first. Differential Revision: https://reviews.llvm.org/D116255	4 年前
copy-sparse.py	[NFC][Py Reformat] Reformat python files in lldb This is an ongoing series of commits that are reformatting our Python code. Reformatting is done with `black` (23.1.0). If you end up having problems merging this commit because you have made changes to a python file, the best way to handle that is to run `git checkout --ours <yourfile>` and then reformat it with black. RFC: https://discourse.llvm.org/t/rfc-document-and-standardize-python-code-style Differential revision: https://reviews.llvm.org/D151460	3 年前
libfbsdvmcore-hacks.patch	[lldb] [Process/FreeBSDKernel] Support finding all processes Include the complete list of threads of all running processes in the FreeBSDKernel plugin. This makes it possible to inspect the states (including partial register dumps from PCB) of all kernel and userspace threads at the time of crash, or at the time of reading /dev/mem first. Differential Revision: https://reviews.llvm.org/D116255	4 年前
lldb-minimize-processes.patch	[lldb] [Process/FreeBSDKernel] Support finding all processes Include the complete list of threads of all running processes in the FreeBSDKernel plugin. This makes it possible to inspect the states (including partial register dumps from PCB) of all kernel and userspace threads at the time of crash, or at the time of reading /dev/mem first. Differential Revision: https://reviews.llvm.org/D116255	4 年前
test.script	[lldb] [Process/FreeBSDKernel] Support finding all processes Include the complete list of threads of all running processes in the FreeBSDKernel plugin. This makes it possible to inspect the states (including partial register dumps from PCB) of all kernel and userspace threads at the time of crash, or at the time of reading /dev/mem first. Differential Revision: https://reviews.llvm.org/D116255	4 年前

How to create vmcores for tests

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.
Transfer the kernel image (/boot/kernel/kernel) and vmcore (/var/crash/vmcore.latest) from the VM.
Patch libfbsdvmcore using libfbsdvmcore-hacks.patch and build LLDB against the patched library.
Patch LLDB using lldb-minimize-processes.patch and build it.

WARNING: LLDB will now modify core files in order to make the resulting test vmcores smaller. Make a backup if necessary.
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. The vmcore will also be modified to shorten the process list in allproc.
Open the vmcore in the patched LLDB again and choose interesting threads for testing. Update thread numbers in test.script if necessary.

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

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/