Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ odump(1) — Tru64 UNIX 5.0a

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

Files:  a.out(4)

ar(4)

odump(1)  —  Commands

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:

−aDumps the archive header for each member of an archive file. 

−cDumps the string table (local and external strings). 

−cm
Dumps the contents of the .comment section. 

−fDumps the file header. 

−gDumps the global symbols from the symbol table of an archive file. 

−hDumps section headers. 

−iDumps the symbolic information header. 

−jDumps compact relocations stored in the .comment section. 

−jfIn addition to dumping information associated with −j, dumps compact relocations that are predicted and not stored. 

−jsDumps brief statistics on the compact relocations stored in the .comment section. 

−lDumps line numbers. 

−lxDumps the contents of a literal section; with x specifying the section to dump, as follows:

−l4Dumps the 4-byte literal section. 

−l8Dumps the 8-byte literal section. 

−laDumps the literal address section (.lita). 

−oDumps the optional header. 

−rDumps relocation information. 

−sDumps section contents. 

−tDumps 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. 

−xDumps 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. 

−DDisplays 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 conflict 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 section.  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 symbol 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. 

−FDumps the file descriptor table. 

−PDumps the procedure descriptor table. 

−RDumps the relative file descriptor table. 

−VDisplays 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 section 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. 

−pDoes not display headers. The modifier can be used with all of the command options. 

−uUnderlines the name of the file for emphasis. The modifier can be used with all of the command options. 

−vDumps 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 Assembly Language Programmer’s Guide. 

SEE ALSO

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

Programmer’s Guide

Assembly Language Programmer’s Guide

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026