mozcrash — Print stack traces from minidumps left behind by crashed processes

Gets stack traces out of processes that have crashed and left behind a minidump file using the Google Breakpad library.

mozcrash is a library for getting a stack trace out of processes that have crashed and left behind a minidump file using the Google Breakpad library.

mozcrash.check_for_crashes(dump_directory, symbols_path=None, stackwalk_binary=None, dump_save_path=None, test_name=None, quiet=False, keep=False)

Print a stack trace for minidump files left behind by a crashing program.

dump_directory will be searched for minidump files. Any minidump files found will have stackwalk_binary executed on them, with symbols_path passed as an extra argument.

stackwalk_binary should be a path to the minidump-stackwalk binary. If stackwalk_binary is not set, the MINIDUMP_STACKWALK environment variable will be checked and its value used if it is not empty. If neither is set, then ~/.mozbuild/minidump-stackwalk/minidump-stackwalk will be used.

symbols_path should be a path to a directory containing symbols to use for dump processing. This can either be a path to a directory containing Breakpad-format symbols, or a URL to a zip file containing a set of symbols.

If dump_save_path is set, it should be a path to a directory in which to copy minidump files for safekeeping after a stack trace has been printed. If not set, the environment variable MINIDUMP_SAVE_PATH will be checked and its value used if it is not empty.

If test_name is set it will be used as the test name in log output. If not set the filename of the calling function will be used.

If quiet is set, no PROCESS-CRASH message will be printed to stdout if a crash is detected.

If keep is set, minidump files will not be removed after processing.

Returns number of minidump files found.