User Commands dump(1)
NAME
dump - dump selected parts of an object file
SYNOPSIS
dump [-aCcfghLorstV [-p] [-T index [, indexn] filename...
dump [-afhorstL [-p] [v] filename...
dump [-hsr [-p] [-d number [, numbern] filename...
dump [-hsrt [-p] [-n name] filename...
DESCRIPTION
The dump utility dumps selected parts of each of its object
file arguments.
The dump utility is best suited for use in shell scripts,
whereas the elfdump(1) command is recommended for more
human-readable output.
OPTIONS
This utility 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 Dumps the archive header of each member
of an archive.
-c Dumps the string table(s).
-C Dumps decoded C] symbol table names.
-f Dumps each file header.
-g Dumps the global symbols in the symbol
table of an archive.
-h Dumps the section headers.
-L Dumps dynamic linking information and
static shared library information, if
SunOS 5.11 Last change: 6 Sep 2002 1
User Commands dump(1)
available.
-o Dumps each program execution header.
-r Dumps relocation information.
-s Dumps section contents in hexadecimal.
-t Dumps symbol table entries.
-T index Dumps only the indexed symbol table
-T index1,index2 entry defined by index or a range of
entries defined by index1,index2.
-V Prints version information.
The following modifiers are used in conjunction with the
options listed above to modify their capabilities.
-d number Dumps the section number indicated by
-d number1,number2 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 sec-
tion, specify the number of the sec-
tion 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 relo-
cation section, use dump -s -n name
for raw data output, or dump -sv -n
name for interpreted output.
-n name Dumps information pertaining only to
the named entity. This modifier can be
SunOS 5.11 Last change: 6 Sep 2002 2
User Commands dump(1)
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 sec-
tion. 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 .text, where dump -h -n .text
will dump the section header informa-
tion for the .text section.
-p Suppresses printing of the headings.
-v Dumps 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)
-L (value)
-o (type, flags)
-r (name, type)
-s (interpret section contents
wherever possible)
-t (type, bind)
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 filename... will produce the
same formatted output as dump -tv
filename..., but dump -s -n .symtab
SunOS 5.11 Last change: 6 Sep 2002 3
User Commands dump(1)
filename... will print raw data in
hexadecimal. Without additional modif-
iers, dump -sv filename... will dump
all sections in the files, interpret-
ing all those that it can and dumping
the rest (such as .text or .data) as
raw data.
The dump utility attempts to format the information it dumps
in a meaningful way, printing certain information in charac-
ter, hexadecimal, octal, or decimal representation as
appropriate.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWbtool
SEE ALSO
elfdump(1), nm(1), ar.h(3HEAD), a.out(4), attributes(5)
SunOS 5.11 Last change: 6 Sep 2002 4
|
