Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ odump(1) — Digital UNIX 4.0d

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

a.out(4)

ar(4)

odump(1)  —  Commands

NAME

odump − Dumps selected parts of an object file

SYNOPSIS

odump [−acfghi l[a|4|8] orstxz D[cghilprst] FPRV X[p|x] flag_modifiers] file1 ... fileN

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. 

The odump command works for object files and archives of object files. It accepts one or more of the following flags:

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

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

−fDumps each file header. 

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

−hDumps section headers. 

−iDumps the symbolic information header. 

−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 each 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 flags:

−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 flags:

−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 −D flag with modifiers:

−DcDisplays the .conflict section for each file specified.  This conflict table lists symbols whose normal definition is overridden at run time. 

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

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

−DlDisplays the .liblist section for each file named.  This section contains a list of the shared libraries needed by this object. 

−DmDisplays the .msym section for each specified file.  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. 

−DrDisplays the dynamic relocation section (.rel.dyn) for each file specified.  Each relocation entry represents a reference to a symbol in a shared library. 

−DsDisplays the .dynstr section for each file specified.  This section contains strings referenced by other dynamic loading sections. 

−DtDisplays 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 ID of the odump command. 

−XpDumps the exception procedure table. 

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

The odump command accepts the following modifiers (flag_modifiers) with the preceding flags:

−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 with −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 only about the specified name.  This modifier can be used with −h, −l, −r, and −s. 

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

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

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

Optionally, a flag and its modifier can be separated by using blanks. 

[Digital]  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 flags 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 flags.  By default, odump shows the demangled names only. 

−mangled_name_only
[Digital]  Prints only the mangled name.

−mangled_name_also
[Digital]  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. 

RELATED INFORMATION

a.out(4), ar(4)

Programmer’s Guide
Assembly Language Programmer’s Guide

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