HP Caliper User Guide Release 5.5 (5900-2351, August 2012)

Branch Targets in Disassembly Listings
By default, the symbols shown for branch targets in disassembly are limited to 30 characters. You
can change the limit by setting the following variable in the measurement configuration file or the
.caliperinit file:
disasm_target_name_limit = limit
Source Position Correlation
In addition to printing address and function names, HP Caliper prints source position information
when it is available and appropriate. This capability depends on extra information generated by
the compiler and is not always available. For example, if the executable was stripped, this
information cannot be shown.
If a program was compiled at a high optimization level, the source position is shown with a ~
sign.
NOTE: On Linux, correlating sample data to source files created with GNU compilers requires
that you use the -g compiler option to produce debug information. For example: gcc —g —O
foo.c
Source Line Data
Performance data shown for source lines is, by default, enclosed in parentheses to help differentiate
it from bundle-level and instruction-level data. To have reports show source line data without
parentheses, set the following variable in the measurement configuration file or the .caliperinit
file:
use_parens_for_statement_data = False
Alternatively, you can turn off reporting of source line data altogether by setting the following
variable in the measurement configuration file or the .caliperinit file:
suppress_statement_data = True
Data attributed to a source line is data-aggregated across all bundles whose first instruction is
associated with the source line. This occurs even though the instruction bundle might cross source
line boundaries. Therefore, data attributed to source statements will not always be completely
accurate.
Column numbers emitted by the C and C++ and Fortran compilers and shown in reports are not
generally accurate, except for legacy HP C. However, they correctly reflect relative positions in
the source line. For example, column 4 represents a location in the source line that occurs before
column 5, though neither column 4 nor column 5 necessarily refers to the specific columns in the
source line.
Address Types Shown
The following list describes the address types reported by HP Caliper:
• In the list of included and excluded load modules near the top of reports, HP Caliper reports
the run-time address range of each load module.
• For function start addresses, HP Caliper reports link-time addresses, the offset from the text
base of the containing load module.
• HP Caliper reports each disassembled instruction address as an offset from a function start
address.
• HP Caliper reports addresses with no known function name and no known load module as
run-time addresses.
Source Position Correlation 111