


nm(1)                 GNU Development Tools                 nm(1)


NNAAMMEE
       nm - list symbols from object files.


SSYYNNOOPPSSIISS
       nnmm     [--aa|----ddeebbuugg--ssyymmss] [--gg|----eexxtteerrnn--oonnllyy] [--BB]
              [--CC|----ddeemmaannggllee] [--DD|----ddyynnaammiicc] [--ss|----pprriinntt--aarrmmaapp]
              [--oo|----pprriinntt--ffiillee--nnaammee] [--nn|----nnuummeerriicc--ssoorrtt]
              [--pp|----nnoo--ssoorrtt] [--rr|----rreevveerrssee--ssoorrtt]
              [--uu|----uunnddeeffiinneedd--oonnllyy] [----hheellpp] [----vveerrssiioonn] [--tt
              _r_a_d_i_x|----rraaddiixx==_r_a_d_i_x] [--PP|----ppoorrttaabbiilliittyy] [--ff
              _f_o_r_m_a_t|----ffoorrmmaatt==_f_o_r_m_a_t] [----ttaarrggeett==_b_f_d_n_a_m_e]
              [_o_b_j_f_i_l_e...]

DDEESSCCRRIIPPTTIIOONN
       GNU nnmm lists the symbols from object files _o_b_j_f_i_l_e.  If no
       object files are given as arguments, nnmm assumes `aa..oouutt'.


OOPPTTIIOONNSS
       The  long and short forms of options, shown here as alter-
       natives, are equivalent.


       --AA

       --oo

       ----pprriinntt--ffiillee--nnaammee
              Precede each symbol by the name of the  input  file
              where it was found, rather than identifying the in-
              put file once only before all of its symbols.


       --aa

       ----ddeebbuugg--ssyymmss
              Display debugger-only symbols; normally  these  are
              not listed.


       --BB     The  same  as  ----ffoorrmmaatt==bbssdd (for compatibility with
              the MIPS nnmm).


       --CC

       ----ddeemmaannggllee
              Decode (_d_e_m_a_n_g_l_e) low-level symbol names into user-
              level  names.   Besides removing any initial under-
              score prepended by the system, this makes C++ func-
              tion names readable.





cygnus support           5 November 1991                        1





nm(1)                 GNU Development Tools                 nm(1)


       --DD

       ----ddyynnaammiicc
              Display  the dynamic symbols rather than the normal
              symbols.  This is only meaningful for  dynamic  ob-
              jects, such as certain types of shared libraries.


       --ff _f_o_r_m_a_t
              Use the output format _f_o_r_m_a_t, which can be ``bsd'',
              ``sysv'', or ``posix''.   The  default  is  `bsd''.
              Only  the first character of _f_o_r_m_a_t is significant;
              it can be either upper or lower case.


       --gg

       ----eexxtteerrnn--oonnllyy
              Display only external symbols.


       --nn

       --vv

       ----nnuummeerriicc--ssoorrtt
              Sort symbols numerically by  their  addresses,  not
              alphabetically by their names.


       --pp

       ----nnoo--ssoorrtt
              Don't bother to sort the symbols in any order; just
              print them in the order encountered.


       --PP

       ----ppoorrttaabbiilliittyy
              Use the POSIX.2 standard output format  instead  of
              the default format.  Equivalent to ``-f posix''.


       --ss

       ----pprriinntt--aarrmmaapp
              When  listing symbols from archive members, include
              the index: a mapping (stored in the archive  by  aarr
              or  rraannlliibb) of what modules contain definitions for
              what names.


       --rr



cygnus support           5 November 1991                        2





nm(1)                 GNU Development Tools                 nm(1)


       ----rreevveerrssee--ssoorrtt
              Reverse the sense of the sort (whether  numeric  or
              alphabetic); let the last come first.


       --tt _r_a_d_i_x

       ----rraaddiixx==_r_a_d_i_x
              Use _r_a_d_i_x as the radix for printing the symbol val-
              ues.  It must be ``d'' for decimal, ``o''  for  oc-
              tal, or ``x'' for hexadecimal.


       ----ttaarrggeett==_b_f_d_n_a_m_e
               Specify an object code format other than your sys-
              tem's default format.  See oobbjjdduummpp(11), for informa-
              tion on listing available formats.


       --uu

       ----uunnddeeffiinneedd--oonnllyy
              Display  only  undefined symbols (those external to
              each object file).


       --VV

       ----vveerrssiioonn
              Show the version number of nnmm and exit.


       ----hheellpp Show a summary of the options to nnmm and exit.


SSEEEE AALLSSOO
       `bbiinnuuttiillss' entry in iinnffoo; _T_h_e _G_N_U _B_i_n_a_r_y _U_t_i_l_i_t_i_e_s, Roland
       H. Pesch (October 1991); aarr(11), oobbjjdduummpp(11), rraannlliibb(11).



CCOOPPYYIINNGG
       Copyright (c) 1991 Free Software Foundation, Inc.

       Permission  is  granted  to  make  and distribute verbatim
       copies of this manual provided the  copyright  notice  and
       this permission notice are preserved on all copies.

       Permission is granted to copy and distribute modified ver-
       sions of this manual under  the  conditions  for  verbatim
       copying,  provided  that the entire resulting derived work
       is distributed under the  terms  of  a  permission  notice
       identical to this one.




cygnus support           5 November 1991                        3





nm(1)                 GNU Development Tools                 nm(1)


       Permission  is granted to copy and distribute translations
       of this manual into another language, under the above con-
       ditions for modified versions, except that this permission
       notice may be included in  translations  approved  by  the
       Free  Software  Foundation  instead of in the original En-
       glish.



















































cygnus support           5 November 1991                        4


