Windows sysinternals

228 Part II Usage Guide
Command-Line Syntax
The following code block shows the full command-line syntax for ProcDump, and Table 7-1
gives brief descriptions of each of the options. They are discussed in greater detail in the
following sections.
procdump [-c percent [-u]] [-s n] [-n count] [-m commit] [-h] [-e [1] [-b]] [-t]
[-p counter threshold]
[-ma | -mp] [-r] [-o] [-64]
{ {processname | PID} [dumpfile] | -x {imagefile} {dumpfile} [arguments] }
TABLE 7-1 ProcDump Command-Line Options
Option
Description
Target Process and Dump File
processname
PID
dumpfile
Name of the target process. It must be a unique instance and already running.
Process ID of the target process.
Name of dump file. This is optional if the process is already running; it’s required
if using –x.
–x Starts the target process, using imagefile and command-line arguments.
imagefile Name of executable file to launch.
arguments Optional command-line arguments to pass to new process.
Dump Criteria
–c percent CPU usage above which to capture a dump.
–u Used with –c to scale threshold against number of CPUs present.
–s n Used with –c, sets duration of high CPU usage to trigger a dump.
Used with –p, sets duration of a performance counter threshold exceeded to
trigger a dump.
Used with –n and no other dump criteria, dumps process every n seconds.
–n count Used with –c, –s, or –p, specifies number of dumps to capture.
–m commit Specifies commit charge limit in MB at which to capture a dump.
–h Captures a dump when a hung window is detected.
–e Captures a dump when an unhandled exception occurs. If followed with 1, it also
captures a dump on a first-chance exception.
–b Used with –e, treats breakpoints as exceptions. Otherwise, it ignores them.
–t Captures a dump when the process terminates.
–p counter Captures a dump when the named performance counter exceeds the threshold.
threshold
Dump File Options
–ma
–mp
Include all process memory in the dump.
“Miniplus”; creates the equivalent of a full dump but with large allocations
omitted.
www.it-ebooks.info