Open Native Crash Dump
debug_open_dumpOpen a recorded core/minidump with a local debugger adapter and capture bounded postmortem evidence (stack, locals, registers, modules, disassembly) without executing the crashed program.
Instructions
Open a local native core/minidump with CodeLLDB, upstream LLVM lldb-dap, or GNU GDB DAP and capture bounded postmortem evidence. Use this when the failure is already recorded and no target process should execute; use debug_run_to_stop or debug_this_crash for a live reproduction instead. The tool starts only the selected local debugger adapter, never launches or resumes the crashed program, treats the dump as read-only, and returns the initial stack/locals/registers plus optional modules and disassembly.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Working directory for the local debugger adapter process; this does not execute the crashed target. | |
| adapter | No | Debugger adapter used for postmortem inspection. lldb-dap and gdb use their native coreFile attach semantics. | codelldb |
| program | No | Path to the matching executable image. Optional for CodeLLDB/GDB, but required when adapter=lldb-dap because LLVM coreFile loading binds the dump to its program image. | |
| dumpPath | Yes | Absolute or local path to the native core/minidump file to inspect. | |
| threadId | No | Specific dump thread to inspect; omit to use the debugger-selected stopped/crashed thread. | |
| sessionId | No | Optional DAP session ID. Omit to use the backward-compatible default session. | |
| sourceMap | No | Optional mapping from source paths recorded in symbols to local source paths. Supported by CodeLLDB/lldb-dap; GDB currently rejects this field rather than guessing undocumented semantics. | |
| adapterPath | No | Optional explicit executable path for the selected debugger adapter; omit to use its normal discovery logic. | |
| moduleCount | No | Maximum number of modules to include when includeModules is true. | |
| stackLevels | No | Maximum stack frames to include in the initial postmortem snapshot. | |
| includeModules | No | Include loaded executable images and libraries recorded in the dump. | |
| requestTimeoutMs | No | Per-request DAP timeout in milliseconds while opening and inspecting the dump. | |
| includeDisassembly | No | Include best-effort instructions around the selected crash frame. | |
| maxVariablesPerScope | No | Maximum variables returned per scope in the initial snapshot. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| attach | Yes | ||
| adapter | Yes | ||
| program | No | ||
| dumpPath | Yes | ||
| guidance | Yes | ||
| snapshot | Yes | ||
| adapterKind | Yes | ||
| capabilities | Yes | ||
| readOnlyTarget | Yes |