Commands Reference, Volume 2

dump Command

The dump command includes information for dump on a POWER-based platform and an dump on an Itanium-based platform.

dump Command on POWER-based Platform

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}] 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

-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 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
```

Related Information

The ar command, size command.

The a.out file, ar file.

dump Command on Itanium-based Platform

Purpose

Dump selected parts of an object file.

Syntax

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.
-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.

-V: Print version information.
-w: Size of words to print for raw dumps: can be 1, 2, 4 or 8.
-Y index or -Y index1,index2: Dump only the indexed dynamic symbol table entry defined by index or a ranges of entries defined by index1, index2. This option dumps symbols from sections of type SHT_DYNSYM, instead of SHT_SYMTAB, as used by the -T option.
-y: Dump dynamic symbol table. This option dumps sections of type SHT_DYNSYM, instead of SHT_SYMTAB, as used by the -t option.

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 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.

Related Information

The a.out file format, ar file format.