Python library to parse and read Microsoft minidump file format. Can create minidumps on Windows machines using the windows API (implemented with ctypes).
Python >= 3.6
This module is primarily intended to be used as a library, however for the sake of demonstarting its capabilities there is a command line tool implemented called minidump
. This tool has the following modes of operation.
Console
One-shot parsing and information retrieval.
minidump.py --all <mindidump file>
See help for possible options.
Shell
There is and interactive command shell to get all info (modules, threads, excetpions etc) and browse the virtual memory of the process dumped (read/read int/read uint/move/peek/tell)
minidump.py -i <mindidump file>
Once in the shell, all commands are documented. Use the ?
command to see all options.
After parsing the minidump file, you can use the MinidumpFileReader and MinidumpBufferedReader objects to perform various searches/reads in the dumped process' address space.
Those objects will be able to read and search the VA of the dumped process and have a notion on integer sizes based on the CPU arch.
The createminidump.py
script in the utils folder uses the Windows API to create minidump files. This script can also dump processes running on a different user context by enabling SeDebugPrivilege
.
Of course it only works if you are running it as administrator or a use that has SeDebugPrivilege
.
python3 setup.py install