dump(1) (Software Generation System Utilities) dump(1)
NAME
dump - dump selected parts of an object file
SYNOPSIS
dump [ options ] files
DESCRIPTION
The dump command dumps selected parts of each of its object file
arguments.
This command will accept both object files and archives of object
files. It processes each file argument according to one or more of
the following options:
-a Dump the archive header of each member of an archive.
-C Dump decoded C++ symbol table names.
-c Dump the string table(s).
-D Dump debugging information.
-f Dump each file header.
-g Dump the global symbols in the symbol table of an archive.
-h Dump the section headers.
-L Dump dynamic linking information and static shared library
information, if available.
-l Dump line number information.
-o Dump each program execution header.
-r Dump relocation information.
-s Dump section contents in hexadecimal.
-T index or -T index1,index2
Dump only the indexed symbol table entry defined by index
or a range of entries defined by index1,index2.
-t Dump symbol table entries.
-u When reading a COFF object file, dump translates the file
to ELF internally (this translation does not affect the
file contents). This option controls how much translation
occurs from COFF values to ELF. Normally (without -u),
the COFF values are preserved as much as possible, showing
the actual bytes in the file. If -u is used, dump updates
7/91 Page 1
dump(1) (Software Generation System Utilities) dump(1)
the values and completes the internal translation, giving
a consistent ELF view of the contents. Although the bytes
displayed under this option might not match the file
itself, they show how the file would look if it were
converted to ELF. (See cof2elf(1) for more information.)
-V Print version information.
The following modifiers are used in conjunction with the options
listed above to modify their capabilities.
-d number or -d number1,number2
Dump the section number indicated by number or the range
of sections starting at number1 and ending at number2.
This modifier can be used with -h, -s, and -r. When -d is
used with -h or -s, the argument is treated as the number
of a section or range of sections. When -d is used with
-r, the argument is treated as the number of the section
or range of sections to which the relocation applies. For
example, to print out all relocation entries associated
with the .text section, specify the number of the section
as the argument to -d. If .text is section number 2 in
the file, dump -r -d 2 will print all associated entries.
To print out a specific relocation section use
dump -s -n name for raw data output, or dump -sv -n name
for interpreted output.
-n name Dump information pertaining only to the named entity.
This modifier can be used with -h, -s, -r, and -t. When
-n is used with -h or -s, the argument will be treated as
the name of a section. When -n is used with -t or -r, the
argument will be treated as the name of a symbol. For
example, dump -t -n .text will dump the symbol table entry
associated with the symbol whose name is dump -h -n .text
will dump the section header information for the section.
-p Suppress printing of the headings.
-v Dump information in symbolic representation rather than
numeric. This modifier can be used with -a (date, user
id, group id), -f (class, data, type, machine, version,
flags), -h (type, flags), -o (type, flags), -r (name,
type), -s (interpret section contents wherever possible),
-t (type, bind), and -L (value). When -v is used with -s,
all sections that can be interpreted, such as the string
table or symbol table, will be interpreted. For example,
dump -sv -n .symtab files will produce the same formatted
output as dump -tv files, but dump -s -n .symtab files
will print raw data in hexadecimal. Without additional
modifiers, dump -sv files will dump all sections in the
files interpreting all those that it can and dumping the
Page 2 7/91
dump(1) (Software Generation System Utilities) dump(1)
ar(4).
7/91 Page 3