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

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 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 com-
pilation 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: February 2007 − 1 − Hewlett-Packard Company 375