NM(1)                                                       NM(1)



     NAME
          nm - name list dump of MIPS object files

     SYNOPSIS
          nm [-a -d -e -f -g -h -n -o -p -r -u -v -x -A -B -T -V] [
          file1 ... fileN ]

     DESCRIPTION
          The nm command prints listings formats for the symbol and
          external sections of the symbol table.  A file can be an
          object or an archive.  If you do not specify a file, this
          command assumes a.out.

          The -A and -B options specify AT&T System V style output or
          Berkeley (4.3
           BSD) style output, respectively. The version of UNIX
          running at your site determines the default.  NOTE: Some
          options can change the version-specific defaults.  These
          options change the meaning of overloaded flags after -A or
          -B is specified.

          A normal Berkeley system produces the address or value field
          followed by a letter showing what section the symbol or
          external is in and the name of the symbol or external.

          These section letters describe the information that nm
          generates

               N    nil storage class, compiler internal usage

               T    external text

               t    local text

               D    external initialized data

               d    local initialized data

               B    external zeroed data

               b    local zeroed data

               A    external absolute

               a    local absolute

               U    external undefined

               G    external small initialized data

               g    local small initialized data




     Page 1                                        (last mod. 8/20/87)

     NM(1)                                                       NM(1)



               S    external small zeroed data

               s    local small zeroed data

               R    external read only

               r    local read only

               C    common

               E    small common

               V    external small undefined

          The standard System V format and the -a specified Berkeley
          format provide an expanded listing with these columns:

               Name the symbol or external name

               Value
                    the value field for the symbol or external,
                    usually an address or interesting debugging
                    information

               Class
                    the symbol type

               Type the symbol's language declaration

               Size unused

               Index
                    the symbol's index field

               Section
                    the symbol's storage class

          NOTE: Every effort was made to map the field's functionality
          into System V nomenclature.

          The nm command accepts these options:

               -a   prints debugging information, effectively turning
                    Berkeley into System V format

               -b   prints the value field in octal

               -d   prints the value field in decimal (the System V
                    default)

               -e   prints external and statics only




     Page 2                                        (last mod. 8/20/87)

     NM(1)                                                       NM(1)



               -f   produces full output-nm still accepts this old
                    option, but ignores it

               -h   does not print headers

               -n   for System V, sorts external symbols by name
                    (default for Berkeley), and for Berkeley, sorts
                    all symbols by value

               -o   for System V, prints the value field in octal, and
                    for Berkeley prepends the filename to each
                    symbol-good for grepping through nm of libraries

               -p   prints symbols as they are found in the file (the
                    System V default)

               -r   reverses the sense of a value or name sort

               -u   prints only undefined symbols

               -v   sorts external symbols by value

               -x   prints value field in hexadecimal (Berkeley
                    default)

               -T   truncates long names, inserting a `*' as the last
                    printed character

               -V   prints version information on stderr

     SEE ALSO
          coff(5), MIPS System Programmer Guide, MIPS Languages
          Programmer Guide

     ORIGIN
          MIPS Computer Systems



















     Page 3                                        (last mod. 8/20/87)