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

FreeBSD Manual Pages


home | help
nm(1)			     GNU Development Tools			 nm(1)

       nm - list symbols from object files.

       nm     [-a|--debug-syms]	[-g|--extern-only] [-B]	[-C|--demangle]
	      [-D|--dynamic] [-s|--print-armap]	[-o|--print-file-name]
	      [-n|--numeric-sort] [-p|--no-sort] [-r|--reverse-sort]
	      [--size-sort] [-u|--undefined-only] [-l|--line-numbers] [--help]
	      [--version] [-t radix|--radix=radix] [-P|--portability] [-f
	      format|--format=format] [--target=bfdname] [objfile...]

       GNU nm lists the	symbols	from object files objfile.  If no object files
       are given as arguments, nm assumes `a.out'.

       The  long  and  short forms of options, shown here as alternatives, are



	      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.


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

       -B     The same as --format=bsd (for compatibility with the MIPS	nm).


	      Decode (demangle)	low-level symbol names into user-level	names.
	      Besides removing any initial underscore prepended	by the system,
	      this makes C++ function names readable.


	      Display the dynamic symbols  rather  than	 the  normal  symbols.
	      This  is	only  meaningful  for dynamic objects, such as certain
	      types of shared libraries.

       -f format
	      Use the output format format, which can be ``bsd'', ``sysv'', or
	      ``posix''.  The default is ``bsd''.  Only	the first character of
	      format is	significant; it	can be either upper or lower case.


	      Display only external symbols.



	      Sort symbols numerically by their	addresses, not	alphabetically
	      by their names.


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


	      Use the POSIX.2 standard output format instead  of  the  default
	      format.  Equivalent to ``-f posix''.


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


	      Reverse  the  sense of the sort (whether numeric or alphabetic);
	      let the last come	first.

	      Sort symbols by size.  The size is computed  as  the  difference
	      between the value	of the symbol and the value of the symbol with
	      the next higher value.  The  size	 of  the  symbol  is  printed,
	      rather than the value.

       -t radix

	      Use  radix as the	radix for printing the symbol values.  It must
	      be ``d'' for decimal, ``o'' for octal, or	``x'' for hexadecimal.

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


	      Display only undefined symbols (those external  to  each	object


	      For  each	 symbol,  use  debugging  information to try to	find a
	      filename and line	number.	 For a defined symbol,	look  for  the
	      line number of the address of the	symbol.	 For an	undefined sym-
	      bol, look	for the	line number of a relocation entry which	refers
	      to  the  symbol.	If line	number information can be found, print
	      it after the other symbol	information.


	      Show the version number of nm and	exit.

       --help Show a summary of	the options to nm and exit.

       `binutils' entry	in info; The GNU Binary	 Utilities,  Roland  H.	 Pesch
       (October	1991); ar(1), objdump(1), ranlib(1).

       Copyright (c) 1991, 2000	Free Software Foundation, Inc.

       This document is	distributed under the terms of the GNU Free Documenta-
       tion License, version 1.1.  That	license	is described  in  the  sources
       for  this  manual  page,	 but it	is not displayed here in order to make
       this manual more	consise.  Copies of this license can also be  obtained

Free Software Foundation	5 November 1991				 nm(1)


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

home | help