Unix/Linux Go Back    


OpenDarwin 7.2.1 - man page for nm (opendarwin section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


NM(1)											    NM(1)

NAME
       nm - display name list (symbol table)

SYNOPSIS
       nm [ -agnoprumxjlf [ s segname sectname ]] [ file ... ]

DESCRIPTION
       Nm  displays the name list (symbol table) of each object file in the argument list.  If an
       argument is an archive, a listing for each object file in the archive  will  be	produced.
       File  can  be  of the form libx.a(x.o), in which case only symbols from that member of the
       object file are listed.	(The parentheses have to be quoted to get by the shell.)   If  no
       file is given, the symbols in a.out are listed.

       Each  symbol name is preceded by its value (blanks if undefined).  Unless the -m option is
       specified, this value is followed by one of the	following  characters,	representing  the
       symbol  type:  U  (undefined), A (absolute), T (text section symbol), D (data section sym-
       bol), B (bss section symbol), C (common symbol), - (for debugger symbol table entries; see
       -a below), S (symbol in a section other than those above), or I (indirect symbol).  If the
       symbol is local (non-external), the symbol's type is instead  represented  by  the  corre-
       sponding  lowercase  letter.  A lower case u in a dynamic shared library indicates a unde-
       fined reference to a private external in another module in the same library.

       If the symbol is a Objective C method, the  symbol  name  is  +-[Class_name(category_name)
       method:name:],  where  `+'  is  for class methods, `-' is for instance methods, and (cate-
       gory_name) is present only when the method is in a category.

       The output is sorted alphabetically by default.

       Options are:

       -a     Display all symbol table entries, including those inserted for use by debuggers.

       -g     Display only global (external) symbols.

       -n     Sort numerically rather than alphabetically.

       -o     Prepend file or archive element name to each output line, rather than only once.

       -p     Don't sort; display in symbol-table order.

       -r     Sort in reverse order.

       -u     Display only undefined symbols.

       -m     Display the N_SECT type symbols (Mach-O symbols)	as  (segment_name,  section_name)
	      followed	by  either external or non-external and then the symbol name.  Undefined,
	      common, absolute and indirect  symbols  get  displayed  as  (undefined),	(common),
	      (absolute), and (indirect), respectively.

       -x     Display  the  symbol  table entry's fields in hexadecimal, along with the name as a
	      string.

       -j     Just display the symbol names (no value or type).

       -s segname sectname
	      List only those symbols in the section (segname,sectname).

       -l     List a pseudo symbol .section_start if no symbol has  as	its  value  the  starting
	      address of the section.  (This is used with the -s option above.)

       -arch arch_type
	      Specifies the architecture, arch_type, of the file for nm(1) to operate on when the
	      file is a fat file (see arch(3) for the currently known arch_types).  The arch_type
	      can  be  "all" to operate on all architectures in the file.  The default is to dis-
	      play the symbols from only the host architecture, if the file contains  it;  other-
	      wise, symbols for all architectures in the file are displayed.

       -f     Display  the  symbol table of a dynamic library flat (as one file not separate mod-
	      ules).

SEE ALSO
       ar(1), ar(5), Mach-O(5), stab(5), nlist(3)

BUGS
       Displaying Mach-O symbols with -m is too verbose.  Without the -m, symbols in  the  Objec-
       tive C sections get displayed as an `s'.

Apple Computer, Inc.			 October 23, 1997				    NM(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 04:20 PM.