


nm(1)                 GNU Development Tools                 nm(1)



NAME
     nm-list symbols from object files.


SYNOPSIS
     nm   [-a|+debug-syms] [-g|+extern-only] [-s|+print-armap]
          [-o|+print-file-name] [-n|+numeric-sort] [-p|+no-sort]
          [-r|+reverse-sort] [-u|+undefined-only]
          [+target _b_f_d_n_a_m_e] [_o_b_j_f_i_l_e_s...]

DESCRIPTION
     GNU nm will list the symbols from object files _o_b_j_f_i_l_e_s.


OPTIONS
     The long and short forms of options, shown here as  alterna-
     tives, are equivalent.


     _o_b_j_f_i_l_e_s...
          Object files whose symbols are to be listed.  If no ob-
          ject files are listed as arguments, nm assumes `a.out'.


     -a

     +debug-syms
          Display debugger-only symbols; normally these  are  not
          listed.


     -g

     +extern-only
          Display only external symbols.


     -p

     +no-sort
          Don't bother to sort the symbols  in  any  order;  just
          print them in the order encountered.


     -n

     +numeric-sort
          Sort symbols numerically by their addresses, not alpha-
          betically by their names.


     -s



cygnus support    Last change: 5 November 1991                  1






nm(1)                 GNU Development Tools                 nm(1)



     +print-armap
          When listing symbols from archive members, include  the
          index:  a  mapping (stored in the archive by ar or ran-
          lib) of  what  modules  contain  definitions  for  what
          names.


     -o

     +print-file-name
          Precede each symbol by the name of the input file where
          it  was  found,  rather than identifying the input file
          once only before all of its symbols.


     -r

     +reverse-sort
          Reverse the sense of the sort (whether numeric  or  al-
          phabetic); let the last come first.


     +target _b_f_d_n_a_m_e
           Specify an object code format other than your system's
          default  format.   See  objdump(1),  for information on
          listing available formats.


     -u

     +undefined-only
          Display only undefined symbols (those external to  each
          object file).


SEE ALSO
     `binutils' entry in info; _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); ar(1), objdump(1), ranlib(1).



COPYING
     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 per-
     mission notice are preserved on all copies.

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



cygnus support    Last change: 5 November 1991                  2






nm(1)                 GNU Development Tools                 nm(1)



     this one.

     Permission is granted to copy and distribute translations of
     this  manual  into  another language, under the above condi-
     tions for modified versions, except that this permission no-
     tice  may  be  included in translations approved by the Free
     Software Foundation instead of in the original English.
















































cygnus support    Last change: 5 November 1991                  3



