HP Caliper User's Guide

Table 8-1 Command-Line and Measurement Configuration File Syntax for -p Option
Measurement Configuration File SyntaxCommand-Line Syntax
• process="default"
• process="root"
• process="root-forks"
• process="all"
• process="custom:function_name"
• process="[some:][(opt1,[opt2,...])]pattern"
• -p default
• -p root
• -p root-forks
• -p all
• -p custom
• -p custom:function_name
• -p
[some:][(opt1[,opt2,...])]pattern
When using multiple process=some items, use this syntax in the measurement
configuration file:
process=["[some:][(opt1[,opt2,...])]pattern1",
"[some:][(opt3[,opt4,...])]pattern2", ...]
This list explains the syntax for the -p option:
-p default The default behavior is equivalent to -p all.
-p root
Measures only the root process.
-p root-forks
Measures only the root process and forks from
the root process.
-p all
Measures all processes in the process tree. The
root of the process tree is the initial process that
HP Caliper creates, or the one that launches HP
Caliper (automatic invocation), or the one to
which HP Caliper attaches (when the pid
argument list is given on the command line).
This is the default setting for all measurements.
-p custom:function_name
Allows you to provide a Python function to use
as a filter for processes to measure. This option
should only be necessary in rare cases, while -p
some: should cover most special needs.
-p
[some:][(opt1,...)]pattern
For simple uses:
-p glob1[:glob2:...]
Matches the executable base name of each new
process against each glob pattern. A glob pattern
follows the Unix shell-style rules to expand file
names. If one or more of those patterns match,
the process is measured. Otherwise the process
is tracked.
Configuring Data Collection 129