dump Command

Purpose

Dumps selected parts of an object file.

Syntax

dump { -a -c -d -g -h -l -n -o -p -r -s -t -u -v -H -R -T} [ -zName [ ,Number ] [ +zNumber ] ] [-tIndex [ +tIndex ] ] [ -X {32|64|32_64|d64|any}] File ...

Note: Do not put a space between the -z Name flag and the ,Number parameter.

Description

The dump command dumps selected parts of the specified File parameter. The dump command accepts object files, archive object files, and executable files.

Flags

Item	Description
-a	Dumps the archive header of each member of each specified archive.
-c	Dumps the string table.
-d	Dumps the raw data for each section.
-g	Dumps the global symbols in the archive symbol table.
-h	Dumps section headers.
-l	Dumps line number information.
-n	Dumps all loader section information.
-o	Dumps each optional header.
-p	Suppresses header printing.
-r	Dumps relocation information.
-s	Dumps the raw data for each selection.
-t	Dumps symbol table entries.
-tIndex	Dumps only the index symbol table entry specified with the Index parameter. Use the -t flag with the +t flag to specify a range of symbol table entries.
+tIndex	Dumps the symbol entry in the range that ends with the Index parameter. The range starts at the first symbol table entry or at the entry specified by the -t flag.
-u	Underlines the name of the File parameter.
-v	Dumps the information in symbolic representation rather than numeric. Any flag except the -o flag and -s flag can be used with the -v flag.
-zName[,Number]	Dumps line number entries for the Name parameter or a range of line number entries that starts at the specified number.
+zNumber	Dumps all line numbers up to the Number parameter.
-H	Dumps the header of the loader section. The -H flag applies only to executable files.
-R	Dumps the relocation entries for the leader section. The -R flag applies only to executable files.
-T	Dumps the symbol table entries for the loader section. The -T flag applies only to executable files.
-X mode	Specifies the type of object file dump should examine. The mode must be one of the following: 32 Processes only 32-bit object files. 64 Processes only 64-bit object files. 32_64 Processes both 32-bit and 64-bit object files. d64 Examines discontinued 64-bit XCOFF files (magic number = U803XTOCMAGIC). any Processes all of the supported object files. The default is to process 32-bit object files (ignore 64-bit objects). The mode can also be set with the OBJECT_MODE environment variable. For example, OBJECT_MODE=64 causes dump to process any 64-bit objects and ignore 32-bit objects. The -X flag overrides the OBJECT_MODE variable.

Examples

To dump the string table of the a.out file, enter:
```
dump -c a.out
```
To dump the contents of an XCOFF data section to standard output, enter:
```
dump -d a.out
```
To dump the object file headers, enter:
```
dump -o a.out
```
To dump line number information for the a.out file, enter:
```
dump -l a.out
```
To dump relocation information for the a.out file, enter:
```
dump -r a.out
```
To dump the contents of the a.out object file text section, enter:
```
dump -s a.out
```
To dump symbol table information for the a.out object file, enter:
```
dump -t a.out
```
To print symbol table entries 20 to 31 without header information, enter:
```
dump -p -t20 +t30 a.out
```
To dump the object file headers from only 64-bit objects in lib.a, enter:
```
dump -X64 -o lib.a
```