•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 -poption and the corresponding measurement configuration file syntax.

Table 2 Command-Line and Measurement Configuration File Syntax for -p Option

Command-Line Syntax

Measurement Configuration File Syntax

 

 

 

 

•

-p default

•

process="default"

•

-p root

•

process="root"

• -p root-forks

•

process="root-forks"

•

-p all

•

process="all"

•

-p custom

• process="custom:function_name"

•

-p custom:function_name

•

process="[some:][(opt1,[opt2,...])]pattern"

•-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 -poption:

-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