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

FreeBSD Manual Pages

  
 
  

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

NAME
       nm - print name list of common object file

SYNOPSIS
       format] file ...

DESCRIPTION
       The command displays the	symbol table of	each object file, file.

       file  can be a relocatable object file or an executable object file, or
       it can be an archive of relocatable or executable object	files.

       There are three general output formats: the default (neither nor	speci-
       fied),  specified,  and	specified.   The  output formats are described
       after the "Options" subsection.

       By default, prints the entire name of the symbols listed.  Since	object
       files  can  have	symbol names with an arbitrary number of characters, a
       name that is longer than	the width of the column	set  aside  for	 names
       will  overflow  its  column,  forcing every column after	the name to be
       misaligned.

   Options
       recognizes the following	options:

	      Prefix each output line with the name of the object file or  ar-
	      chive,
			     file.  Equivalent to

	      Demangle C++ names before	printing them (ELF only).

	      Display the    value  and	 size of a symbol in decimal.  This is
			     the default for the default format	or the format.
			     Equivalent	to

	      Display only   and symbols.  This	option is ignored (see

	      Display full output.
			     This option is in force by	default.

	      Display only   (global) symbol information.

	      Do not display the output	header data.

	      Distinguish  between  weak  and global symbols by	appending * to
	      the key
			     letter of weak symbols.  Only takes  effect  with
			     and/or

	      Sort symbols by
			     name,  in	ascending collation order, before they
			     are printed.  This	is the default.	 See "Environ-
			     ment Variables" in	EXTERNAL INFLUENCES below.

	      Display  symbols in the order in which they appear in the	symbol
	      table.

	      Display the    value and size of a symbol	in octal.   Equivalent
			     to

	      Display information in a blank-separated output format.
			     Each symbol name is preceded by its value (blanks
			     if	undefined) and a letter	to indicate  type.   A
			     lowercase	letter indicates a local (nonexternal)
			     symbol.

			     (absolute)

			     (bss symbol)

			     (common symbol)

			     (data symbol)

			     (milli symbol)

			     (notype)

			     (section region)

			     (text symbol)

			     (undefined)

			     If	the symbol is a	secondary definition, the type
			     letter is followed	by the letter

			     Note that is not compatible with

	      Display  information  in	a portable output format, as specified
	      below,
			     to	standard output.  Note that is not  compatible
			     with

	      Prefix  each output line with the	name of	the object file	or ar-
	      chive,
			     file.  Equivalent to

	      Print the	section	index instead of the section name (ELF only).

	      Display each numeric value in the	specified format.
			     format can	be one of:

			     Display the
				    value and size of  a  symbol  in  decimal.
				    This is the	default	for the	default	format
				    or the format.  Equivalent to

			     Display the
				    value and  size  of	 a  symbol  in	octal.
				    Equivalent to

			     Display the
				    value and size of a	symbol in hexadecimal.
				    This  is  the  default  for	 the   format.
				    Equivalent to

	      Display undefined	symbols	only.

	      Print the	usage menu.

	      Sort symbols by
			     value before they are printed.

	      Display the executing version of the
			     command on	standard error.

	      Display the    value  and	size of	a symbol in hexadecimal.  This
			     is	the default for	the format.  Equivalent	to

   Default Output Format - 32 bit
       If the default (neither the nor the option) output format is specified,
       each  symbol  has the following columns,	separated by vertical bars The
       default for numbers is decimal or

       If decimal:

       If octal:

       If hexadecimal:

   Default Output Format - 64 bit
       If the default (neither the nor the option) output format is specified,
       each  symbol  has the following columns,	separated by vertical bars The
       default for numbers is decimal or

       If decimal:

       If octal:

       If hexadecimal:

       The descriptions	are explained below:

	      name	     The name of the symbol.

	      value	     Its value expressed as an offset  or  an  address
			     depending on its storage class.

	      scope	     The scope of the symbol or	The scope indicates an
			     external symbol that is flagged  as  a  secondary
			     definition.

	      type	     The type of the symbol

	      subspace	     The subspace to which the symbol belongs.

	      bind	     Specifies	the  symbol binding type (local, weak,
			     global).

	      O		     This field	is used	for files that have large sec-
			     tion  tables (>65K	sections).  For	smaller	files,
			     the value of this field is	0.

	      Shndx	     Identifies	the index of the section that the sym-
			     bol belongs to.

	      Identifies the index of the symbol in the	symbol table.

   Output Format for -p
       If  the option is specified, information	is displayed using the follow-
       ing portable C-language formats.	 The default for numbers is decimal or

       If decimal:

       If octal:

       If hexadecimal:

       If or the line is preceded by:

   Output Format for -P
       If the option is	specified, information is displayed using the  follow-
       ing  portable C-language	formats.  The default for numbers is hexadeci-
       mal or In the format string, represents string output; represents deci-
       mal  output;  represents	 octal	output;	represents hexadecimal output;
       represents newline; all other characters	represent themselves.

	 o  If decimal is specified:

	 o  If octal is	specified:

	 o  If hexadecimal is specified, or by default:

       where library-object is a string	preformatted as	follows:

	 o  If and are not specified, library-object is	an empty string.

	 o  If or is specified,	and the	corresponding file  operand  does  not
	    name a library:

	 o  If	or  is	specified  and	the corresponding file operand names a
	    library, object-file names the object file in the library contain-
	    ing	the symbol being described:

       If  and	are not	specified, and if more than one	file operand is	speci-
       fied, or	if a single file operand that names a  library	is  specified,
       then prints a line identifying the object containing the	symbols	before
       the lines containing those symbols, in one of the following forms:

	 o  If the corresponding file operand does not name a library:

	 o  If the corresponding file operand  names  a	 library,  object-file
	    names  the	object file in the library containing the symbol being
	    described:

EXTERNAL INFLUENCES
   Environment Variables
       The following internationalization variables affect the execution of

       determines the locale category for native language, local  customs  and
       coded  character	 set in	the absence of or other	environment variables.
       If is not specified or is null, it defaults to (see lang(5)).

       if set to a nonempty string value, determines the values	for all	locale
       categories and has precedence over and other environment	variables.

       determines the locale category for character collation.

       determines the locale category for character handling functions.

       determines the locale that should be used to affect the format and con-
       tents of	diagnostic messages written to standard	error.

       determines the locale category for numeric formatting.

       and determine the location of message catalogues	for processing

       If an internationalization variable is not specified  or	 is  null,  it
       defaults	to the value of

       If is not specified or is null, it defaults to (see lang(5)).

       If  any internationalization variable contains an invalid setting, then
       all internationalization	variables default to (see environ(5)).

   International Code Set Support
       Single-byte character code sets are supported.

EXAMPLES
       Display which object files have undefined references for	the symbol

       Display which object files have a definition for	the text symbol	leap:

WARNINGS
       By default, now sorts symbols by	name (the option).  To turn off	 sort-
       ing, use	the option.

       Some  options added for standards conformance duplicate the functional-
       ity of options that previously  existed.	  This	duplication  has  been
       retained	for backward compatibility.

SEE ALSO
   System Tools
       cc_bundled(1)	   HP-UX C compiler
       ld(1)		   Link	editor

   Miscellaneous
       crt0(3)		   Execution startup routine
       end(3C)		   Symbol of the last locations	in program

STANDARDS CONFORMANCE
									 nm(1)

NAME | SYNOPSIS | DESCRIPTION | EXTERNAL INFLUENCES | EXAMPLES | WARNINGS | SEE ALSO | STANDARDS CONFORMANCE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=nm&sektion=1&manpath=HP-UX+11.22>

home | help