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

-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.
For more information, see “Using -p some ” (p. 98).
If you specify multiple -p options, the last one takes precedence.
Using -p some
The syntax for -p some is the most complex.
-p [some:][(opt1[,opt2,...])]pattern
where:
opt1, opt2 represent the options from the following tables that either specify the action to
take or a condition the process must meet
pattern represents the string that HP Caliper uses to compare with options that require a
pattern
When you specify multiple some: arguments for process, the result of each some: argument is
passed the subsequent some: argument, typically reducing the number of matching results.
The (opt1[,opt2,...]) are optional and only required to change the default behavior. The
absence of options is equivalent to providing the options (measure, file).
Options can be grouped in categories, as shown in the tables below.
Table 3 Action Options Used with -p some
DescriptionOption
Default. Measures the process.measure
The process is not measured. However, HP Caliper learns about events in this process, in particular,
creation of new processes via fork, vfork, and exec.
track
The process is not measured. HP Caliper does not track events for this process or any child the
process may create.
ignore
The last option specified takes precedence.
Table 4 Pattern String Interpretation Options Used with -p some
DescriptionOption
Default. Interprets the string as a “:”-separated list of glob patterns.glob
HP Caliper interprets the string as a single Python or Perl type regular expression that is used
with search.
regexp
The last option specified takes precedence.
Table 5 Name Source Options Used with -p some
DescriptionOption
Default. The name is the executable base name of the process.file
The name is argument 0 of the process.arg0 or argv0
98 Configuring HP Caliper