minidump is a Python library designed for parsing Windows minidump (.dmp) files. It allows developers and security researchers to programmatically extract information such as modules, threads, handles, and exception data from crash dumps. Currently at version 0.0.24, the library receives updates primarily for bug fixes and feature enhancements related to parsing accuracy and additional stream support.
pip install minidumpVerified import paths — ran on the pinned version, not inferred.
This example demonstrates how to parse a minidump file and access its basic streams like modules, threads, and exception records. It assumes a file named 'example.dmp' exists in the same directory. Note that for actual parsing, 'example.dmp' must be a valid Windows minidump file.
Upgrade to `minidump>=0.0.24` to benefit from the latest parsing fixes and improvements.
Ensure you are using `minidump>=0.0.17` or newer for better performance, especially with large files. Always open files in binary read mode (`'rb'`).
Verify the integrity and format of your `.dmp` files before parsing. Consider adding robust error handling (`try-except`) around `MinidumpFile.parse()` calls.
Ensure the file path is correct and the file exists. Use an absolute path or verify the relative path from your script's execution directory. Example: `MinidumpFile.parse(open('/path/to/your_minidump.dmp', 'rb'))`Verify the integrity of your `.dmp` file. Try opening it with a dedicated minidump viewer (like WinDbg or a similar forensic tool) to confirm its validity. Ensure it's not truncated or corrupted.
Not all minidump files contain all possible streams. Always check if a stream exists before attempting to iterate or access its contents. Example: `if md.threads: for thread in md.threads: ...`
No dependency data recorded yet.