HP-UX Reference (11i v2 07/12) - 1 User Commands A-M (vol 1)

c
caliper(1)
For Integrity Systems Only
caliper(1)
Caliper 4.3 Caliper 4.3
(Requires Optional HP Caliper Software)
Specifying Settings with an Initialization File
You can save settings in a file, named
.caliperinit , that HP Caliper automatically uses at start-up.
Putting the options in an initialization file simplifies the command line you use to launch HP Caliper.
For example, you can specify global settings for all of your reports, such as system libraries to exclude and
output file locations. With your preferences in the initialization file, you can then simply type:
$ caliper fprof
The resulting report would use your predefined preferences. Using this approach you could, for example,
change your preferences without having to change the HP Caliper command line in a
Makefile.
Note: Any option specified on the command line overrides the corresponding setting in an initialization
file.
There are a number of reporting options not available from the command line that you can set in an option
file. These are:
disasm_mark_branch_targets=TRUE
|FALSE
Determines if targets of branch instructions are preceded by a colon (
:) in disassembly.
Default: False
disasm_target_name_limit=
LIMIT
Specifies the maximum number of characters to print for branch target symbols in disassembly.
Default: 30
use_parens_for_statement_data=TRUE
|FALSE
If TRUE, statement-level data in reports is placed in parentheses.
Default: True
suppress_statement_data=TRUE
|FALSE
If TRUE, no statement-level data will be reported.
Default: False
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 sample
.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, replac-
ing the dash (-) in the option long name with underscore (_) to form the variable name.
HP-UX 11i Version 2: December 2007 Update − 13 − Hewlett-Packard Company 103