footprints(1)						      General Commands Manual						     footprints(1)

NAME

       footprints - summarize information from compiler footprint records

SYNOPSIS

       filename...

DESCRIPTION

       The  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:

	      o  Total number of compilation units found.

	      o  Earliest and latest compiler timestamp, and the linker timestamp (if available).

	      o  Total size of text and data segments.

	      o  List of compiler versions used, with number of compilation units compiled with each version.

	      o  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:

	      o  Executable files and shared libraries.

		 The  command  will  attempt  to  find all dependent, non-system shared libraries and will print a separate report for each shared
		 library.  If the or environment variable is set, it will search for dependent libraries in the directories listed in the environ-
		 ment  variable  (if is set, 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.

	      o  Archive libraries.

		 The command will scan each object file member of the archive.

	      o  Relocatable object files.

		 The command will scan the named object files.

       The 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 command recognizes the following options:

	      Print the version number and quit.

	      Verbose mode: prints detail information about each compilation unit found.

	      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 line shows that all 51 compilation units were compiled with Version A.06.11 of the ANSI C compiler.	The line shows that  the  applica-
       tion was compiled for Integrity systems (Itanium(R) Product Family) in the 32-bit data model.

       The  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 line, all 51 were compiled without profile-based optimization.

       The line shows that no compilation units were compiled with the symbolic debug option.  Otherwise, the line would show the number of compi-
       lation units compiled with various combinations of symbolic debug and higher optimization levels.

       For on/off options like 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

       was developed by HP.

SEE ALSO

       cc(1), elfdump(1), odump(1).

																     footprints(1)