Options to control what what minidumps contain and where they are stored
What data to save in a minidump
To save a standard minidump just specify this flag.
Include just the information necessary to capture stack traces for all existing threads in a process.
/flagMiniDumpNormal
To save a custom minidump specify one or more of these flags.
These flags add data to the minidump.
For a detailed explanation of these flags please consult Microsoft's Minidump documentation.
Only minimal memory necessary to reconstruct a stack trace.
/flagMiniDumpFilterMemory:On|Off
Example: /flagMiniDumpFilterMemory:On
Example: /flagMiniDumpFilterMemory:Off
/flagMiniDumpFilterModulePaths
Restrict module paths if important information present.
/flagMiniDumpFilterModulePaths:On|Off
Example: /flagMiniDumpFilterModulePaths:On
Example: /flagMiniDumpFilterModulePaths:Off
Include filter triage data.
/flagMiniDumpFilterTriage:On|Off
Example: /flagMiniDumpFilterTriage:On
Example: /flagMiniDumpFilterTriage:Off
/flagMiniDumpIgnoreInaccessibleMemory
Ignore memory errors when building the minidump.
/flagMiniDumpIgnoreInaccessibleMemory:On|Off
Example: /flagMiniDumpIgnoreInaccessibleMemory:On
Example: /flagMiniDumpIgnoreInaccessibleMemory:Off
/flagMiniDumpWithAvxXStateContext
Include AVX crash state context registers.
/flagMiniDumpWithAvxXStateContext:On|Off
Example: /flagMiniDumpWithAvxXStateContext:On
Example: /flagMiniDumpWithAvxXStateContext:Off
Include the executable code sections from all loaded modules.
/flagMiniDumpWithCodeSegs:On|Off
Example: /flagMiniDumpWithCodeSegs:On
Example: /flagMiniDumpWithCodeSegs:Off
Include the data sections from all loaded modules.
/flagMiniDumpWithDataSegs:On|Off
Example: /flagMiniDumpWithDataSegs:On
Example: /flagMiniDumpWithDataSegs:Off
/flagMiniDumpWithFullAuxiliaryState
Include data from 3rd party minidump providers.
/flagMiniDumpWithFullAuxiliaryState:On|Off
Example: /flagMiniDumpWithFullAuxiliaryState:On
Example: /flagMiniDumpWithFullAuxiliaryState:Off
Include all accessible memory in the process.
/flagMiniDumpWithFullMemory:On|Off
Example: /flagMiniDumpWithFullMemory:On
Example: /flagMiniDumpWithFullMemory:Off
/flagMiniDumpWithFullMemoryInfo
Include memory region information.
/flagMiniDumpWithFullMemoryInfo:On|Off
Example: /flagMiniDumpWithFullMemoryInfo:On
Example: /flagMiniDumpWithFullMemoryInfo:Off
Include information about operating system handles that are active.
/flagMiniDumpWithHandleData:On|Off
Example: /flagMiniDumpWithHandleData:On
Example: /flagMiniDumpWithHandleData:Off
/flagMiniDumpWithIndirectlyReferencedMemory
Include pages with data referenced by locals or other stack memory.
/flagMiniDumpWithIndirectlyReferencedMemory:On|Off
Example: /flagMiniDumpWithIndirectlyReferencedMemory:On
Example: /flagMiniDumpWithIndirectlyReferencedMemory:Off
Include Intel Processor Trace data
/flagMiniDumpWithIptTrace:On|Off
Example: /flagMiniDumpWithIptTrace:On
Example: /flagMiniDumpWithIptTrace:Off
/flagMiniDumpWithModuleHeaders
Include module header data
/flagMiniDumpWithModuleHeaders:On|Off
Example: /flagMiniDumpWithModuleHeaders:On
Example: /flagMiniDumpWithModuleHeaders:Off
/flagMiniDumpWithPrivateReadWriteMemory
Include memory with PAGE_READWRITE access in the minidump.
/flagMiniDumpWithPrivateReadWriteMemory:On|Off
Example: /flagMiniDumpWithPrivateReadWriteMemory:On
Example: /flagMiniDumpWithPrivateReadWriteMemory:Off
/flagMiniDumpWithPrivateWriteCopyMemory
Include memory with PAGE_WRITECOPY status in the minidump.
/flagMiniDumpWithPrivateWriteCopyMemory:On|Off
Example: /flagMiniDumpWithPrivateWriteCopyMemory:On
Example: /flagMiniDumpWithPrivateWriteCopyMemory:Off
/flagMiniDumpWithProcessThreadData
Include process and thread information in the minidump.
/flagMiniDumpWithProcessThreadData:On|Off
Example: /flagMiniDumpWithProcessThreadData:On
Example: /flagMiniDumpWithProcessThreadData:Off
Include thread state information.
/flagMiniDumpWithThreadInfo:On|Off
Example: /flagMiniDumpWithThreadInfo:On
Example: /flagMiniDumpWithThreadInfo:Off
/flagMiniDumpWithTokenInformation
Include security token information.
/flagMiniDumpWithTokenInformation:On|Off
Example: /flagMiniDumpWithTokenInformation:On
Example: /flagMiniDumpWithTokenInformation:Off
/flagMiniDumpWithUnloadedModules
The list of modules that were recently unloaded, if available.
/flagMiniDumpWithUnloadedModules:On|Off
Example: /flagMiniDumpWithUnloadedModules:On
Example: /flagMiniDumpWithUnloadedModules:Off
These flags prevent data being added the minidump
For a detailed explanation of these flags please consult Microsoft's Minidump documentation.
/flagMiniDumpScanInaccessiblePartialPages
Scan inaccessible partial page data.
/flagMiniDumpScanInaccessiblePartialPages:On|Off
Example: /flagMiniDumpScanInaccessiblePartialPages:On
Example: /flagMiniDumpScanInaccessiblePartialPages:Off
Memory is scanned to see if modules are referenced.
/flagMiniDumpScanMemory:On|Off
Example: /flagMiniDumpScanMemory:On
Example: /flagMiniDumpScanMemory:Off
/flagMiniDumpWithoutAuxiliaryState
Don't include data from 3rd party minidump providers.
/flagMiniDumpWithoutAuxiliaryState:On|Off
Example: /flagMiniDumpWithoutAuxiliaryState:On
Example: /flagMiniDumpWithoutAuxiliaryState:Off
/flagMiniDumpWithoutOptionalData
Minimise the size of the minidump by excluding optional data.
/flagMiniDumpWithoutOptionalData:On|Off
Example: /flagMiniDumpWithoutOptionalData:On
Example: /flagMiniDumpWithoutOptionalData:Off
Where to store a minidump
Specify the directory where minidumps will be written.
/miniDumpDir directory-name
Example: /miniDumpDir e:\my-minidumps
Example: /miniDumpDir "e:\path with spaces in it\my-minidumps"
Minidump Name
Minidumps are named using a root name that is either specified or taken from the process name. The root name then has the date and time appended to it.
An example minidump name might be: "UnitTest442-20231129-113748.dmp" for a minidump created at 11:37:48 on 29 November 2023.
Note that this date and time format makes the minidumps naturally date and time ordered using their name.
The date is also unambiguous (unlike the conflict between DDMMYYYY (least significant date) and MMDDYYY (no significant order) used in USA and a few other countries).
Specify the name to use for a minidump.
/miniDumpName mini-dump name.
Example: /miniDumpName "UnitTest48"
When creating a minidump name use the process name without the path and without the file extension.
For example a process named e:\test\mytest.exe would give a minidump name of "mytest".
/miniDumpNameUseProcessName
When creating a minidump name use the name specified with /miniDumpRootName.
/miniDumpNameUseSpecificName
Specify the root name of a minidump that is used in conjunction with a specific minidump name.
This option overwrites the name specified with /miniDumpName.
/miniDumpRootName root-name
Example: /miniDumpRootName "Test384"
Triggering a minidump
A minidump is written when the process being monitored gets to ExitProcess().
/miniDumpAtExitProcess:On|Off
A minidump is written when exceptions are thrown.
/miniDumpOnException:On|Off
/miniDumpOnExceptionEveryException
A minidump is written for first chance exceptions.
/miniDumpOnExceptionEveryException
Note that /miniDumpOnException must be set to On and the exception must match the exception filters.
/miniDumpOnExceptionUnhandledExceptions
A minidump is written for second chance exceptions.
/miniDumpOnExceptionUnhandledExceptions
Note that /miniDumpOnException must be set to On and the exception must match the exception filters.
The default behaviour of Exception Tracer is as if /miniDumpOnExceptionUnhandledExceptions has been specified.
/miniDumpOnExceptionAllExceptions
A minidump is written for first chance exceptions and second chance exceptions.
/miniDumpOnExceptionAllExceptions
Note that /miniDumpOnException must be set to On and the exception must match the exception filters.
A minidump is written when DLLs load and when DLLs unload.
/miniDumpOnDLLLoadUnload:On|Off
A minidump is written when threads are created and when threads exit.
/miniDumpOnThreadCreateExit:On|Off
Exceptions
A minidump is written for every exception that is thrown, or minidumps are written if the exception matches the exceptions filter list
/miniDumpAllExceptions:On A minidump is written for every exception thrown
/miniDumpAllExceptions:Off A minidump is written if the exception matches the enabled exceptions in the exception filter list
Add an exception to the exception filter list. This exception will be marked as enabled.
/miniDumpAddExceptionFilter exception-code
The exception code can be in decimal or hexadecimal (specify with a leading 0x).
Example: /miniDumpAddExceptionFilter 0xC0000005
/miniDumpClearExceptionFilters
The list of exceptions is cleared. Use this option prior to specifying your own list of filters with /miniDumpAddExceptionFilter.
/miniDumpClearExceptionFilters
/miniDumpResetExceptionFilters
The list of exceptions is reset to the standard list of exceptions monitored by Exception Tracer.
/miniDumpResetExceptionFilters
