DUMP(8,C) AIX Commands Reference DUMP(8,C)
-------------------------------------------------------------------------------
dump
PURPOSE
Dumps selected parts of an object file.
SYNTAX
+------------+ +------------------------+ +----------+
dump ---| -a -g -r |------| +---------+ |-| |--->
^ | -b -h -s | | ^ +- -z name --|1 |-+ +- +z num -+ |
| | -c -l -t | | | +- , num -+ |
| | -d -L -x | | +-----------------------------------------+
| | -f -o | |
| +------------+ |
+----------------+
+---------------+ +------------------------+ +-----------------------+
>--| +-----------+ |---| +----------+ |--| +----------+ |-->
+-| -n sec 2 |-+ ^ +- +t num -| |--+ +- +D num -| |-+ |
| -p 3 | | +- -t num -+ +- -D num -+ |
| -u | +-------------------------------------------------------+
| -v 6 |
+-----------+
>------ file -----|
^ |
+----------+
-----------------
1 Do not put a space between these items.
2 Use -n only with -h, -l, -r, or -s.
3 Use -p only with -a, or -o.
6 Do not use -v with -s or -o.
DESCRIPTION
The dump command dumps selected parts of the specified file. The command
accepts object files and archive object files. It writes information in
character, hexadecimal, octal, or decimal representation, as appropriate to
format the information in a meaningful way.
FLAGS
You must use at least one of the following flags:
Processed November 8, 1990 DUMP(8,C) 1
DUMP(8,C) AIX Commands Reference DUMP(8,C)
-a Dumps the archive header of each member of each specified archive.
-b Same as -L.
-c Dumps the string table.
-d Dumps the contents of the .data section.
-f Dumps each file header.
-g Dumps the global symbols in the archive symbol table.
-h Dumps section headers.
-l Dumps line number information.
-L Dumps the contents of the .lib section. This section contains the
shared library information.
-o Dumps each optional header.
-r Dumps relocation information.
-s Dumps the contents of the sections.
-t Dumps symbol table entries.
-x Same as -L.
The following optional flags are also available:
-D num Dumps the section number num or the range of sections
starting at num and ending at the numbers specified by
+Dnum.
+D num Dumps sections in the range beginning either with the
first section or beginning with the section specified by
-Dnum.
-n sec Dumps information pertaining only to the named section
(.text, .data, .lib, .init, .debug, .bss, comment). This
flag applies only to the -h, -l, -r, and -s flags. For
example, if you want the section header information from
the .text section, enter:
dump -h -n .text file
-p Does not print the headers.
-t num Dumps only the index symbol table entry specified with
num. Use the -t flag with the +t flag to specify a range
of symbol table entries.
Processed November 8, 1990 DUMP(8,C) 2
DUMP(8,C) AIX Commands Reference DUMP(8,C)
+t num Dumps the symbol table entry in the range that ends with
num. The range starts at either the first symbol table
entry or at the entry specified by the -t flag.
-u Underlines the name of the file. May not work on some
terminals and printers.
-v Dumps the information in symbolic representation rather
the numeric. You can use this flag with any of the above
flags except -s or -o.
-z name[,num] Dumps line number entries for name or a range of line
number entries that starts at the specified number. You
can use a blank to replace the comma that separates name
and num.
+z num Dumps all line numbers up to num when used with the
-z[,num] flag.
Note: The line number information is not currently put
in the symbol table of object files generated by
the AIX compilers (C, VS FORTRAN and VS Pascal).
RELATED INFORMATION
See the following commands: "ar," "nm," "shlib2," and "size."
See the a.out and ar files in AIX Operating System Technical Reference.
Processed November 8, 1990 DUMP(8,C) 3