unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



odump(1)							     odump(1)



NAME

  odump	- Dumps	selected parts of an object file

SYNOPSIS

  odump	[-a c[m] fghi j[f|s] l[a|4|8] orstxz D[cghlmrst] FPRV X[p|x]
  flag_modifiers] file1...fileN

OPTIONS

  This command works for object	files and archives of object files. It
  accepts one or more of the following options:

  -a  Dumps the	archive	header for each	member of an archive file.

  -c  Dumps the	string table (local and	external strings).

  -cm Dumps the	contents of the	.comment section.

  -f  Dumps the	file header.

  -g  Dumps the	global symbols from the	symbol table of	an archive file.

  -h  Dumps section headers.

  -i  Dumps the	symbolic information header.

  -j  Dumps compact relocations	stored in the .comment section.

  -jf In addition to dumping information associated with -j, dumps compact
      relocations that are predicted and not stored.

  -js Dumps brief statistics on	the compact relocations	stored in the .com-
      ment section.

  -l  Dumps line numbers.

  -lx Dumps the	contents of a literal section; with x specifying the section
      to dump, as follows:

      -l4 Dumps	the 4-byte literal section.

      -l8 Dumps	the 8-byte literal section.

      -la Dumps	the literal address section (.lita).

  -o  Dumps the	optional header.

  -r  Dumps relocation information.

  -s  Dumps section contents.

  -t  Dumps symbol table entries.  Indexed symbol table	entries	only can be
      dumped by	using the -t index and +t index	options:

      -t index
	  Dumps	indexed	symbol table entries in	a range	starting at the
	  specified entry (index) and ending at	the last entry or the entry
	  specified by +t.

      +t index
	  Dumps	symbol table entries in	a range	starting at the	first entry
	  or the entry specified by -t and ending at the entry specified by
	  +t.

  -x  Dumps the	auxiliary symbol table.

  -z name
      Dumps line number	entries	for the	specified function (name). A range of
      line number entries can be dumped	by using -z name,number	and +z number
      options:

      -z name,number
	  Dumps	a range	of line	number entries starting	at number for the
	  named	function (name)	and ending at the last line number or the
	  line number specified	by +z.

      +z number
	  Dumps	line numbers for a specified range.  The range starts at
	  either the name or number specified by -z.  The range	ends with the
	  number specified by +z.

	  The name and number specified	by a -z	modifier can be	separated by
	  a blank instead of a comma.

  -D  Displays the .dynamic section for	each file specified. This section
      contains basic information describing where other	sections related to
      dynamic loading are located and the size of those	sections. You can use
      the following modifiers with the -D option:

      -Dc Displays the .conflict section for each file specified. This con-
	  flict	table lists symbols whose normal definition is overridden at
	  run time.

      -Dg Displays the .got section for	each file specified. The GOT (global
	  offset table)	contains the run-time addresses	of each	symbol
	  exported or imported by the shared object.

      -Dh Displays the .hash section for each file specified. This hash	table
	  contains entries for each name in the	.dynsym	section	and is used
	  for fast lookup of symbols.

      -Dl Displays the .liblist	section	for each file specified. This section
	  contains a list of the shared	libraries needed by this object.

      -Dm Displays the .msym section for each file specified. The msym table
	  contains entries corresponding to each symbol	in the .dynsym sec-
	  tion.	 Each entry contains the symbol's hash value and an index
	  into the dynamic relocation table. The msym table is used to speed
	  up loader processing and reduce the dynamic memory allocated by the
	  loader.

      -Dr Displays the dynamic relocation section (.rel.dyn) for each file
	  specified.  Each relocation entry represents a reference to a	sym-
	  bol in a shared library.

      -Ds Displays the .dynstr section for each	file specified.	This section
	  contains strings referenced by other dynamic loading sections.

      -Dt Displays the .dynsym section for each	file specified.	This is	a
	  table	of external symbols in a shared	object.

  -F  Dumps the	file descriptor	table.

  -P  Dumps the	procedure descriptor table.

  -R  Dumps the	relative file descriptor table.

  -V  Displays the version of the odump	command.

  -Xp Dumps the	exception procedure table.

  -Xx Enhances the -Xp output to show scope table information for each entry.
      The -Xx option must be used with the -Xp option.

  The following	modifiers (flag_modifiers) can be used with odump command
  options:

  d number
      Dumps a section or a range of sections.  The range starts	either at the
      first section or at number (if specified).  The range ends at either
      the last section or the section you specify with +d. This	modifier can
      be used with -r and -s.

  +d number
      Dumps sections in	the range beginning with either	the first section or
      the section specified by -d. The range ends with either the last sec-
      tion or the section specified by +d. This	modifier can be	used with -r
      and -s.

  -n name
      Dumps information	about only the specified name.	You can	use this
      modifier with -h,	-l, -r,	and -s.

  -p  Does not display headers.	The modifier can be used with all of the com-
      mand options.

  -u  Underlines the name of the file for emphasis. The	modifier can be	used
      with all of the command options.

  -v  Dumps information	symbolically rather than numerically (for example,
      Static rather than 0X02).	This modifier can be used with -a, -cm,	-f,
      -la, -o, -r, -t, and -x.

  Optionally, an option	and its	modifier can be	separated by using blanks.

  [Tru64 UNIX]	The DEC	C++ compiler encodes type information in function,
  template, variable, and virtual table	names to enable	type-safe linkages.
  This encoding	is referred to as "name	mangling". The following options can
  be used with the -r, -t, and -P options to instruct the odump	command	to
  print	either the original name (that is, the demangled name),	the mangled
  name,	or both	names by specifying one	of the following options.  By
  default, odump shows the demangled names only.

  -mangled_name_only
      [Tru64 UNIX]  Prints only	the mangled name.

  -mangled_name_also
      [Tru64 UNIX]  Prints both	the mangled and	the demangled names.

  The odump command tries to format information	in a helpful way, displaying
  information in character, hexadecimal, octal,	or decimal, as appropriate.



DESCRIPTION

  The odump command dumps selected parts of each file that is specified.  For
  details on the object	file parts presented in	the odump output, see the
  Object File/Symbol Table Format Specification.

SEE ALSO

  Files:  a.out(4), ar(4)

  Object File/Symbol Table Format Specification

  Programmer's Guide