HP Caliper 5.3 User Guide (5900-1558, February 2011)

• The origin column, which identifies whether the process was created via a fork, vfork, or
exec.
• The handling column, which shows whether the process was measured, tracked, or ignored.
• The exit status, which is the final exit code for the process.
Figure 22 (page 97) shows an example process tree report.
Figure 22 Example of a Process Tree Report
Process Tree
-----------------------------------------------------------------------------
Program argv[0] PID PPID Origin Handling ExitStat
-----------------------------------------------------------------------------
cc cc 16725 - start measure 1
cc cc 16726 16725 fork measure n/a
`ld /usr/ccs/bin/ld 16726 16725 exec measure 1
-----------------------------------------------------------------------------
HP Caliper reports the process tree for a multiprocess run, but not for a system-wide run.
Syntax for -p Option
Table 2 (page 97) shows the command-line syntax for the -p option and the corresponding
measurement configuration file syntax.
Table 2 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.
Configuring Data Collection 97