-
Notifications
You must be signed in to change notification settings - Fork 3
Manual Dump
Sometimes you want a report right now without waiting for a crash or freeze, for example the server feels sluggish and you want to see what the game thread is doing.
An external process can force a capture without touching the game.
The report is written just like a freeze report (game-thread stack, Lua traces, modules, diagnostics) and lands in the crash folder with a dump type.
Requires CRASHCAPTURE_MANUAL_DUMP (on by default), see Configuration.
Send SIGUSR1 to the server process:
kill -USR1 <pid>
# or, if it's the only srcds_linux on the box:
pkill -USR1 srcds_linuxNote that on Linux this claims SIGUSR1.
If another component in your process already uses that signal, the plugin chains to it after capturing, but you can turn the dump trigger off with manual_dump.
Signal the per-pid named event Local\CrashCapture_Dump_<pid>:
HANDLE h = OpenEventA(EVENT_MODIFY_STATE, FALSE, "Local\\CrashCapture_Dump_1234");
SetEvent(h);
CloseHandle(h);If you require to dump via lua, simply call crashcapture.dump(), this will generate in-place of where this was called from:
crashcapture.dump()Third-party binary modules can also request dumps through the C API (cc->dump(reason)).
Getting started
Usage
Features
For module developers