dump(1) manual page
Table of Contents
dump - dump selected parts of an object file
dump [ -aCcDfghLlorstV
] [ -T index [ , indexn ] ] filename ...
dump [ -afhorstL [ v ] ] filename ...
dump [ -hsr [ -d number [ , numbern ] ] ] filename ...
dump [ -hsrt [ -n name ] ] filename ...
SUNWbtool
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
the string table(s).
- -C
- Dump decoded C++ symbol table names.
- -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 line number information.
- -L
- Dump dynamic linking information and static shared library information,
if available.
- -o
- Dump each program execution header.
- -r
- Dump relocation information.
- -s
- Dump section contents in hexadecimal.
- -t
- Dump symbol table entries.
- -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.
- -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 .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
filename... will produce the same formatted output as dump -tv filename..., but
dump -s -n .symtab filename... will print raw data in hexadecimal. Without additional
modifiers, dump -sv filename... will dump all sections in the files 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.
nm(1)
, a.out(4)
,
ar(4)
Table of Contents