NAME
footprints — summarize information from compiler footprint records
SYNOPSIS
/usr/ccs/bin/footprints
[-V]
[-v]
[-w]
filename...
DESCRIPTION
The
footprints
command scans the named object files, analyzes the compiler footprint
records stored in those files, and generates a summary report.
This report is intended for use by HP support and lab engineers
to assist in problem diagnosis.
The report contains the following information:
Total number of compilation units found.
Earliest and latest compiler timestamp, and the linker timestamp
(if available).
Total size of text and data segments.
List of compiler versions used,
with number of compilation units compiled with each version.
List of options used,
with number of compilation units compiled with each option setting.
This list is separated into two groups, with the most interesting options
in the first group, followed by all remaining options alphabetized in the
second group.
The following file types are recognized:
Executable files and shared libraries.
The
footprints
command will attempt to find all dependent, non-system shared libraries
and will print a separate report for each shared library.
If the
LD_LIBRARY_PATH
or
SHLIB_PATH
environment variable is set, it will search for dependent libraries
in the directories listed in the environment variable (if
LD_LIBRARY_PATH
is set,
SHLIB_PATH
will be ignored).
It will also use the embedded search path in the object file.
If a shared library cannot be located, a diagnostic will be printed
and execution will continue.
Archive libraries.
The
footprints
command will scan each object file member of the archive.
Relocatable object files.
The
footprints
command will scan the named object files.
The
footprints
command supports SOM and ELF object file formats,
32-bit and 64-bit code,
and PA-RISC and Integrity systems.
It supports compiler footprints produced by the HP C and C++ compilers.
Compilation units produced by other compilers may not be reflected
in the summary.
Options
The
footprints
command recognizes the following options:
- -V
Print the version number and quit.
- -v
Verbose mode: prints detail information about each compilation unit found.
- -w
Prints warnings for possible compatibility problems.
Currently, it prints a warning for any compilation units
built for Integrity systems with a C/C++ compiler earlier than Version A.05.50.
Warnings are printed to
stderr
with three asterisks at the beginning of the line.
EXAMPLES
The following example shows the beginning of a typical summary report:
Scanning /usr/bin/ksh ...
Compiler footprint summary
Number of compilation units: 51
Earliest compiler timestamp: N/A
Latest compiler timestamp: N/A
Linker timestamp: 15-Jul-2006 13:07 UTC
Total size: 425.8K (text) 24.8K (data)
version [A.06.11/ANSI C 51]
architecture [ipf32 51]
-O [01 1] [02 50]
PBO [off 51]
-g [off 51]
debugopt [off 51]
+Ointeger_overflow [moderate 51]
+Olit [const 51]
+eh [off 51]
-fpeval [float 51]
-inline [1 1] [2 50]
-link_type [dynamic 51]
-mt [(off) 51]
-rodata [cond 51]
...
The
version
line shows that all 51 compilation units were compiled
with Version A.06.11 of the ANSI C compiler.
The
architecture
line shows that the application was compiled for Integrity systems
(Itanium(R) Product Family) in the 32-bit data model.
The
-O
line shows that one compilation unit was compiled
at the default level of optimization (level 01),
and the other 50 were compiled at level 02.
According to the
PBO
line, all 51 were compiled without profile-based optimization.
The
-g
line shows that no compilation units were compiled with the
symbolic debug option.
Otherwise, the
debugopt
line would show the number of compilation units compiled with
various combinations of symbolic debug and higher optimization levels.
For on/off options like
-mt,
settings listed in parentheses represent a default setting
not overridden by a compiler option.
Many of the options in the footprint record do not correspond directly
to a command-line compiler switch, or have a different spelling,
and are included in this report for use by HP support and lab engineers.
See
cc(1)
for a description of supported command-line switches.
AUTHOR
footprints
was developed by HP.
Printable version
