nm man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

nm(1)									 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.

       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 in 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 lower‐
			  case letter indicates a local (nonexternal) symbol.

			  (absolute)
			  (bss symbol)
			  (common symbol)
			  (data symbol)
			  (milli symbol)  ELF only
			  (notype)  ELF only
			  (section region)
			  (tstorage symbol)  SOM only
			  (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

	      (SOM only) Silence some warning messages.

	      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.  Equiva‐
				 lent to

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

	      (SOM only) Truncate every name that would otherwise overflow its
	      column
			  and place an asterisk as the last character  in  the
			  displayed  name  to  mark it as truncated.  If or is
			  also specified, the file prefix is truncated first.

	      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

   Operands
       recognizes the following operand:

	      file	  A  relocatable  object  file or an executable object
			  file, or an archive  of  relocatable	or  executable
			  object files.

   Default Output Format - SOM
       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 - ELF
       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 defi‐
			  nition.

	      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 section
			  tables (>65K	sections).   For  smaller  files,  the
			  value of this field is 0.

	      Shndx	  Identifies  the index of the section that the symbol
			  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.

	 ·  If decimal is specified:

	 ·  If octal is specified:

	 ·  If hexadecimal is specified, or by default:

       where library-object is a string preformatted as follows:

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

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

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

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

	 ·  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)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net