Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ nm(1) — NEWS-os 5.0.1

Media Vault

Software Library

Restoration Projects

Artifacts Sought



nm(1)                    USER COMMANDS                      nm(1)



NAME
     nm - name list dump of MIPS object files

SYNOPSIS
     nm [-abdefghnopruvxABTV] [ 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  run-
     ning  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



                                                                1





nm(1)                    USER COMMANDS                      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



                                                                2





nm(1)                    USER COMMANDS                      nm(1)



          -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  Guide,  MIPS  Languages  Programmer
     Guide

























                                                                3



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