dump(1) dump(1)
NAME
dump - dump selected parts of an object file
SYNOPSIS
dump options file . . .
DESCRIPTION
The dump command dumps selected parts of each of its object
file arguments. You must provide at least one option.
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 Decode C++ symbol table names before dumping.
-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.
Copyright 1994 Novell, Inc. Page 1
dump(1) dump(1)
-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 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
Copyright 1994 Novell, Inc. Page 2
dump(1) dump(1)
with the symbol whose name is .text, where dump -h
-n .text will dump the section header information
for the .text 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 file will produce the
same formatted output as dump -tv file, but dump -s
-n .symtab file will print raw data in hexadecimal.
Without additional modifiers, dump -sv file will
dump all sections in file interpreting all those
that it can and dumping the rest (such as .text or
.data) as raw data.
The dump command attempts to format the information it dumps
in a meaningful way, printing certain information in
character, hexadecimal, octal or decimal representation as
appropriate.
REFERENCES
a.out(4), ar(4), cof2elf(1)
Copyright 1994 Novell, Inc. Page 3