caliper.1 (2010 09)

c
caliper(1)
Integrity Systems
caliper(1)
(Requires Optional HP Caliper Software)
suppress_init_warnings=TRUE
|FALSE
If TRUE, no warnings will be issued if unrecognized variables are detected in the initialization file or
in measurement configuration files.
Default: False
The initialization file can be in the current working directory, your home directory, or in both locations.
When you start HP Caliper, it searches for the presence of an initialization in this order:
1.
.caliperinit in the current working directory
2.
.caliperinit in your home directory.
and when
caliper finds one, it executes based on that initialization file.
An initialization file is a Python script, similar to Caliper measurement configuration file. Here is a sam-
ple
.caliperinit file:
application="ls"
if caliper_config_file == ’branch’:
process=’all’
elif caliper_config_file == ’my_count’:
application="/opt/mpi/bin/mpirun"
arguments = "-np 2 /proj/dynopt/test_fe/mpi_hello_world"
elif caliper_config_file == ’dcache’:
application="/opt/mpi/bin/mpirun"
arguments = "-np 2 /proj/dynopt/test_fe/mpi_hello_world"
elif caliper_config_file == ’itlb’:
application="/opt/mpi/bin/mpirun"
arguments = "-np 2 /proj/dynopt/test_fe/mpi_hello_world"
module_exclude="/usr/bin/sh"
The syntax inside the initialization file is the same as in measurement configuration files. In particular
most long options that are specified in the command line could be specified in the initialization file,
replacing the dash (-) in the option long name with underscore (_) to form the variable name.
Process Selection
When dealing with multi-process applications, it is important to be able to select processes to be meas-
ured in a process tree. This section explains how to do this selection by using the
--process option.
Caliper has a choice between three behaviors when considering what to do with a process:
measure The process is measured. Caliper is informed of new processes generated via fork,
vfork,orexec.
track The process is not measured. Caliper is informed of new processes generated via
fork, vfork,orexec.
ignore The process is not measured. Caliper is not informed of new processes generated via
fork, vfork,orexec.
Caliper will pick which behavior is chosen depending on the
process option. See PLATFORM-
SPECIFIC ADDENDA below for additional information on process selection.
This section uses the term root process. The root process is the process at the root of the process tree. It
is either the process started by Caliper or the process to which Caliper attaches.
The simple options are:
--process=root
Only the root process is measured.
--process=root-forks
Only the root process and processes forked from the root process are measured.
--process=all
Every process in the process tree is measured. This is the default for all measurements.
--process=default
This option is available to be able to explicitly request the default behavior. This is equivalent to
specifying root for all measurements.
HP-UX 11i Version 3: September 2010 − 15 − Hewlett-Packard Company 15