Series 500 Only

NAME

linkinfo − object file link information utility

SYNOPSIS

linkinfo [ [option] ... [file] ... ] ... 

Remarks:

Linkinfo is implemented on the Series 500 only. 

DESCRIPTION

Linkinfo examines the object files that are part of a program and prints statistics about sizes of the various data areas and symbol table information.  Linkinfo searches libraries and examines object files in the same fashion as the link editor ld.  Thus your command line should reflect the same ordering of object files and libraries as it does for the corresponding link. 

Linkinfo is intended for developers of large FORTRAN applications who want information about data sizes in order to tune their application for the Series 500 architecture.  It prints a file-by-file summary of sizes for code segments and for the D-data and I-data areas (both initialized and uninitialized).  There are options for including information about COMMON blocks, linker-generated pointers, and linker symbol entries (again, file-by-file).  There is also provision for generating a crude cross-reference of COMMON block usage by file. 

Linkinfo options may occur anywhere on the command line after the command name itself.  Some options take a modifier immediately following the option letter (e.g. ... -e entryname).  The space between the option and the modifier is optional. 

This utility recognizes the following options.  Note that a colon indicates that the option takes an argument; the colon itself is not a literal, and must not appear when specifying arguments. 

-c requests the name and size of COMMON blocks in the input files. 

-e: names an alternate entry point for the user program, other than _main.  The loader calls this alternate entry point at run-time. 

-l: abbreviates a library name.  Linkinfo searches a default set of directories to locate the desired library.  These directories are /lib and /usr/lib. 

The utility searches these directories in the above order, looking for the library libxxx.a, where xxx is a string of one or more ASCII characters specified as the modifier for the -l option.  Since linkinfo searches a library immediately upon encountering the library’s name on the command line, the placement of the -l option is significant.  A -l with no modifier is the same as -lc, which causes linkinfo to search the standard C library. 

-p requests size information on linker-generated pointers. 

-s forces inclusion of symbol table size information for each input file. 

-u: specifies a name to enter in the symbol table as undefined.  This entry appears as an unresolved reference to the command name.  You can use it to force loading object information solely from a library. 

-x produces a cross-referenced listing of COMMON block usage.  This information is saved in the file xref.out. 

SEE ALSO

ld(1), getopt(1). 

DIAGNOSTICS

Linkinfo returns the following exit codes:
0 − no errors
1 − abort (killed by signal)
2 − error during link
 

Hewlett-Packard Company  —  April 12, 1993