Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
nm(1)			    General Commands Manual			 nm(1)

       nm - name list dump of RISC object files

       nm [-adefghnopruvxABTV] [ file1 ... filen ]

       The nm command prints listings formats for the symbol and external sec-
       tions 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 default  is	Berkeley  (4.3
       BSD).  Some options can change the version-specific defaults. These op-
       tions change the	meaning	of overloaded flags after -A or	-B  is	speci-

       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 generates:

       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

       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 pro-
       vide an expanded	listing	with these columns:

       Name    the symbol or external name

       Value   the value field for the symbol or external, usually an  address
	       or interesting debugging	information

       Class   the symbol type

       Type    the symbol's language declaration

       Size    unused

       Index   the symbol's index field

       Section the  symbol's  storage  class  Every effort was made to map the
	       field's functionality into System V nomenclature.  The nm  com-
	       mand 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  ig-
	    nores it

       -h   does not print headers

       -n   for	 System	 V, sorts external symbols by name (default for	Berke-
	    ley), 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  de-

       -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	an  asterisk  (*)  as the last
	    printed character

       -V   prints version information on stderr

				     RISC				 nm(1)

Name | Syntax | Description | Options

Want to link to this manual page? Use this URL:

home | help