DRGN-CRASH(1)

📦
version 0.3.0 · 6 versions
, in centos-stream 9

Hiii bestie 💖 this is the drgn-crash(1) page from the drgn manual. We're about to make crash(8) feel like a group chat that actually understands kernel debugging. ✨

💖 NAME 💖

drgn-crash — drgn's crash(8) compatibility mode. Basically the debugger wearing a crash-core costume, and it ate. 💅

🌸 SYNOPSIS 🌸

drgn-crash [VMLINUX] [CORE]

✨ DESCRIPTION ✨

Okay so drgn-crash runs the drgn debugger in crash(8) compatibility mode. Lowkey iconic.

In this mode, drgn imitates the UI of the crash(8) command, and it provides implementations of most of its commands. Not me giving you the crash-core look with drgn energy 🫶. Also, the --drgn option can be given to any command to print example drgn code that does the equivalent of the command. Yes bestie, it shows you the drgn code — very "show your work" of it.

The drgn command can be used to run snippets of drgn code:

%crash> drgn stack_trace(1)[0]["next"].pid
(pid_t)0

Or without arguments to enter drgn's usual interactive mode:

%crash> drgn
>>>

Documentation of all implemented commands is available online at https://drgn.readthedocs.io/en/latest/crash_compatibility.html or in-program with the help command. Go off, help. 📚✨

🎀 OPTIONS 🎀

  • VMLINUX — path to kernel image (vmlinux). This corresponds to the crash(8) NAMELIST argument. By default, drgn searches for this automatically. For more control over debugging symbols, use drgn -s and related options of the main drgn CLI and then enter crash compatibility mode with %crash. Slay, but with symbols. 🧚
  • CORE — path to kernel core dump. This corresponds to the crash(8) MEMORY-IMAGE argument. By default, this debugs the running kernel. No cap, it just looks at the live kernel unless you hand it a core. 💀

Omar Sandoval.

Made with 💜 and main-character energy by Omar Sandoval — this is 0.3.0, dated Oct 22, 2026. Byeee bestie, go debug something iconic. 🎀✨

📦 where this page comes from