Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ nm(1) — mips UMIPS RISC/os 5.01

Media Vault

Software Library

Restoration Projects

Artifacts Sought



NM(1)               RISC/os Reference Manual                NM(1)



NAME
     nm - name list dump of MIPS object files

SYNOPSIS
     nm [-adefghnopruvxABTV] [ 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 gen-
     erates:

          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

          S    external small zeroed data




                        Printed 11/19/92                   Page 1





NM(1)               RISC/os Reference Manual                NM(1)



          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, usu-
               ally an address or interesting debugging informa-
               tion

          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

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



 Page 2                 Printed 11/19/92





NM(1)               RISC/os Reference Manual                NM(1)



          -g   prints only global symbols

          -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
     MIPS System Programmer's Guide.
     RISCompiler and C Programmer's Guide.























                        Printed 11/19/92                   Page 3



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026