How crash-utility/crash works
Crash is a command-line suite for inspecting live Linux kernels and kernel dumps. The main workflow is to start the program with a kernel image and, optionally, a dump; initialize the analysis environment; then use built-in commands or GDB commands to inspect kernel state. Its major branches include architecture-specific analysis, dump-format readers, kernel data and memory analysis, stack unwinding, and extensions. The map follows documented capabilities and visible startup calls; unsampled implementation details are not inferred as call relationships.
Main entry points: main.c CLI and Startup · xendump.c Xen Dump Reader · lkcd_x86_trace.c LKCD Traces · vmcore.h Vmcore Structures
Components 24
Startup and Commands
- CLI and Startup
main.c - GDB Interface
gdb_interface.c - Command Help
help.c
Kernel Analysis
- Kernel Initialization
kernel.c - Symbols and Types
symbols.c - Tasks and Traces
task.c - Stack Unwinding
unwind.c - Unwind Decoder
unwind_decoder.c - Filesystem Analysis
filesys.c - Device Analysis
dev.c - Shared Definitions
defs.h
Memory and Dumps
- Disk and Kdump
diskdump.c - Netdump and ELF
netdump.c - Xen Dump Reader
xendump.c - LKCD Traces
lkcd_x86_trace.c - Vmcore Structures
vmcore.h
Architecture Support
- x86 Analysis
x86_64.c - ARM64 Analysis
arm64.c - Alpha Analysis
alpha.c - IA64 Analysis
ia64.c - Xen Hypervisor
xen_hyper.c
Extensions
- Device Mapper
extensions/dminfo.c - Memory Capture
extensions/snap.c
Other components
- Analyst
Connections 13
- Analyst → CLI and Startup: starts
README - CLI and Startup → GDB Interface: enters loop
main.c - CLI and Startup → Kernel Initialization: initializes
main.c - Stack Unwinding → Unwind Decoder: uses
unwind.c - Disk and Kdump → Vmcore Structures: uses definitions
diskdump.c - Netdump and ELF → Vmcore Structures: uses definitions
- Xen Dump Reader → Xen Dump Reader: reads Xen dumps
README - LKCD Traces → LKCD Traces: supports LKCD traces
README - Analyst → Command Help: requests guidance
README - Analyst → Tasks and Traces: runs analysis commands
README - Analyst → Filesystem Analysis: runs analysis commands
README - Analyst → Device Analysis: runs analysis commands
- Analyst → Memory Capture: captures memory
extensions/snap.c