caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) NAME caliper - measure, report, and analyze program performance data SYNOPSIS caliper measurement [collect_options] [report_options] program [program_args ] caliper measurement [collect_options] [report_options] pid [pid ]... caliper measurement [collect_options] [report_options] -w caliper {report|merge|diff} [report_options] [database ]... caliper advise [advise_options] [database ]...
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) Common Measurements cpu cstack dcache/icache ecount fprof scgprof cpu execution statistics sampled call stack profile cache miss profiles total cpu event counts flat execution profile sampled call graph profile Common Options Save measurement results to named database: -d DATABASE Set length of measurement (in seconds): A cA -e ELAPSED_TIME Specify which cpu metric sets to measure: -m EVENT_SET[:all|:user|:kernel][,EVE
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) conventions are followed) or a mixture of these languages. You can specify the program to be measured using an absolute path, a relative path or a simple file name. caliper searches $PATH when you specify a simple file name and looks in the current directory only if $PATH includes it. Alternatively, you can specify one or more already running processes to measure by listing their pid(s) on the command line.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) and repeat. Note that because every program is unique, not all of the suggestions will apply. There are several defaults assumed when portions of the caliper command-line are omitted. If measurement is omitted, but either a program name or process ID list is given, then the scgprof measurement is assumed. If report is omitted, but a database is given, then report is assumed.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) Options There are a number of command line options available which alter caliper’s operation. Option names and literal arguments can be abbreviated to their shortest, non-ambiguous spelling. Although the command line synopsis above shows caliper options following measurement , in reality they can precede and/or follow it.
caliper(1) all Integrity Systems (Requires Optional HP Caliper Software) caliper(1) This is a synonym for the src argument. --dbrp=DBRP_INDEX,PLM,ADDR_MATCH,ADDR_MASK,PROC_FLAGS Specifies the bits to program the PMU’s data address range matching registers. Forces event monitoring to be constrained by data address ranges. DBRP_INDEX can be 0, 1, 2 or 3. It identifies one of the four Data Breakpoint Registers (DBRs) used to specify the desired address range. PLM specifies the privilege level setting.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) --metrics=EVENT_SET[:all|:user|:kernel][,EVENT_SET] ... --metrics=CPU_EVENT[:EVENT_PARAM] ... [ ,CPU_EVENT ] ... (Can also be specified with the -m option.) Specifies the event set or CPU events to measure. If no event is specified (or --metrics= is specified), then no metrics will be reported. (Note: Specifying --metrics= is not valid for the cpu and ecount measurements.
caliper(1) b Integrity Systems (Requires Optional HP Caliper Software) caliper(1) Match B-slot OPCODE_MATCH is the opcode bits against which the instruction encoding is to be matched. On Dual-Core Itanium and Quad-Core processors, it an integer of 41-bits or less. On Itanium, it is an integer of 27-bits or less. OPCODE_MASK is the mask bits to apply to the instruction encoding before matching the OPCODE_MATCH bits. On Dual-Core Itanium and Quad-Core processors, it an integer of 41-bits or less.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) To specify multiple sampling specifications, the --sampling-spec or -s option can be used multiple times in the command-line. An user can specify up to 4 sampling events on Itanium 2 systems and up to 8 sampling events on new quad-core systems. Note: Specifying multiple -s options overrides the default fprof sampling specification.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) Specifies how much detail to print in the per-process or per application sections of every caliper report (default: target:times:sampling). target prints information about the target application or attached process measured. times reports basic time data about the execution. sampling reports the sampling parameters and counts. images lists the load modules that are part of the application measured.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) --percent-columns={total|cumulative|total:cumulative} Specifies what types of percentages are shown in reports. Specify total to have a column showing percentage of samples with respect to total number of samples taken. Specify cumulative to have a column showing cumulative percentage of samples. Applies to PMU histogram reports only.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) Applies to PMU histogram reports only. --stop-functions=FUNC[,FUNC]... Valid only for cstack; specifies kernel functions beyond which frames will not be shown. This is useful to exclude the obvious sleep functions in the kernel and by default some functions are specified in config/cstack.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) Advice is sorted with the most important items first and the list stops when the index value of an item is below MIN_INDEX (default: 5.0) or MAX_COUNT (default: 15) items have been printed. The MIN_COUNT (default: 5) argument sets the minimum amount of advice to report regardless of the setting for MIN_INDEX.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) --output-file=OUT_FILE[,append|,create] (Can also be specified with the -o option.) Specifies the file in which to write the caliper information report (default is stdout). The file can be opened in append or create mode (default: create). --report=all|REPORT_TYPE (Can also be specified with the -r option.) Specifies that information about the report types which match the given (partial) REPORT_TYPE name be output.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) 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. .
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) The complex options are: --process=[some:][OPT1,...]PATTERN Each --process=some:... argument provided to Caliper is interpreted as an additional filter. Those filters are applied in order to each new process. If a filter matches the process, the behavior (measure, track, ignore) associated with the process is memorized. Caliper will use the behavior of the last matching filter to determine what to do with the process.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) • Replace the executable invocation with --scope=system (or -w) • Define a measurement duration (--duration=seconds or -eseconds) or measure until SIGINT (Ctrl-C) is received. On HP-UX, the --scope pset=pset_id[:pset_id]... option can be used to measure activity on all CPUs belonging to the specified processor sets. For example, --scope pset=1:2 measures activity on all CPUs in processor sets 1 and 2.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) PLATFORM-SPECIFIC ADDENDA HP-UX There are some situations where caliper cannot insert probe code in a program or portions of a program due to non-standard or unusual conditions, such as when an assembly routine violates standard runtime conventions. In such situations, caliper will issue warning messages and proceed to measure as much of the program as it can.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) This option is used only with the cstack measurement. --ktrace-path=PATH Specifies the location of the ktracer and ktracedump commands to be invoked from Caliper. The default is caliper_root /lbin. --ktracer-log=PATH Specifies the logfile where ktracer output will be redirected. --ktracedump-args="ktracedump_arguments" Specifies the arguments to be passed to the ktracedump command.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) Alternatively, you can choose the type of data collected by assigning arc-stride or dcache to the environment variable, PBO_DATA_TYPE. --report This option also supports these report types: cgprof, fcount, and fcover. --system-usage=[all]|[ runstatus][:io][:syscalls] Controls the collection and reporting of system usage data.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) c2c Provides metrics related to cache coherence activity. Not available on quad-core processors. cpi Provides metrics related to Cycles Per Instruction (CPI) cpubus Provides information on the demand that a specific CPU presents to the CEC chip set, and the demand the CPU experiences due to the CEC traffic initiated by other CPUs or I/O components in the system. Not available on quad-core processors.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) By default, HP Caliper measures PMU events for your entire program. However using --userregions=rum-sum allows you to restrict measurements to performance-sensitive regions of code. To use this feature: • Modify the application source code to use the header file provided with HP Caliper. The default location of the header file is caliper_root /include/caliper_control.h.
caliper(1) Integrity Systems (Requires Optional HP Caliper Software) caliper(1) LINUX --kernel-path There is no default kernel path used when sampling is done while in kernel mode. By default, only kernel module and function information is produced for samples; this option must be used to display disassembled instructions for kernel modules.
caliper(1) caliper(1) Integrity Systems (Requires Optional HP Caliper Software) This will measure both /usr/bin/ls and /usr/bin/echo processes. caliper ecount --process=*[ho] \ sh -c ’/usr/bin/ls; /usr/bin/echo done’ This will measure both /usr/bin/sh and /usr/bin/echo processes.
caliper(1) caliper(1) Integrity Systems (Requires Optional HP Caliper Software) The online HP Caliper Rule Writer Guide is located at caliper_root /doc/rule_writer_guide.pdf (PDF version). The online HP Caliper Ktrace Feature Guide is located at caliper_root /doc/ktrace_guide.pdf (PDF version). There are detailed information caliper_root /doc/text/*.help files describing each HP There are complete lists of cpu_event values caliper_root /doc/text/itanium2_cpu_counters.txt.
(Notes) A (Notes) cA 26 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010
