footprints.1 (2010 09)

f
footprints(1) footprints(1)
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 direc-
tories 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
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1