NM(1,C)                     AIX Commands Reference                      NM(1,C)



-------------------------------------------------------------------------------
nm



PURPOSE

Displays the symbol table of an object file.

SYNTAX


      +--------+   +--------+   +--------+
nm ---| +----+ |---| one of |---| one of |--- file ---|
      +-| -e |-+   | +----+ |   | +----+ | ^        |
       ^| -f ||    +-| -n |-+   +-| -d |-+ +--------+
       || -h ||      | -v |       | -o |
       || -r ||      +----+       | -x |
       || -T ||                   +----+
       || -u ||
       || -O ||
       |+----+|
       +------+


DESCRIPTION

The nm command writes the symbol table of each specified object file to
standard output.  file can be a single relocatable or absolute common object
file or an archive library of relocatable or absolute common object files.  nm
displays the following information for each symbol:

Name        The name of the symbol.

Value       Its value expressed as an offset or an address depending on its
            storage class.

Class       Its storage class.

Type        Its type and derived type.  If the symbol refers to a structure or
            a union, the structure or union tag follows the type declaration.
            If the symbol is an array, the array dimensions follow the type.

Size        Its size in bytes, if available.

Line        The source line number at which it is defined, if available.

Section     For static and external storage classes, this is the object file
            section containing the symbol.






Processed November 8, 1990          NM(1,C)                                   1

NM(1,C)                     AIX Commands Reference                      NM(1,C)



            Note:  The debug information (type, size and line) is not currently
                   put in the symbol table of object files generated by the AIX
                   Compilers (C, VS, FORTRAN, and VS Pascal).

FLAGS

-e Displays only static and external symbols.

-f Displays the symbols (.text, .data, .lib and .bss) that are normally
   suppressed.

-h Does not display output header data.

-d Displays a symbol's value and size as a decimal number.

-n Sorts external symbols by name before displaying them.

-o Displays a symbol's value and size as an octal rather than a decimal number.

-O Prepends file/archive name to each symbol.

-r Sorts symbols in reverse order.

-T Truncates every name that would otherwise overflow its column, making the
   last character displayed in the name an asterisk.  By default, nm displays
   the entire name of the symbols listed, and a name that is longer than the
   width of the column set aside for it causes every column after the name to
   be misaligned.

-u Displays only undefined symbols.

-v Sorts external symbols by value before displaying them.

-x Displays a symbol's value and size as a hexadecimal rather than a decimal
   number.

FILES

a.out               Default input file.

RELATED INFORMATION

See the following commands:  "ar,"  "as,"  "backup," "cc,"  "ld,"  "nm,"
"size," and "strip."

See the a.out and ar files in AIX Operating System Technical Reference.









Processed November 8, 1990          NM(1,C)                                   2