dump(1)                                                             dump(1)

NAME
     dump - dump parts of an object file

SYNOPSIS
     dump [option...] file...

DESCRIPTION
     The dump command dumps selected parts of each of the specified object
     files. This command will accept both object files and archives of
     object files.

OPTIONS
     -a   Dump the archive header of all the elements of an archive.

     -C   Dump the names in a C++ symbol table.

     -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 infor-
          mation, 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[,index2]
          Dump only the indexed symbol table entry defined by index or a
          range of entries lying between index and 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.
          -u controls how much translation occurs from COFF values to ELF.
          When this option is not used, 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 trans-
          lation, 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.



Page 1                       Reliant UNIX 5.44                Printed 11/98

dump(1)                                                             dump(1)

     -V   Print version details for dump.

     The following modifiers are used in conjunction with the options
     listed above to modify their capabilities.

     -d number[,number2]
          Dump the section number indicated by number or the range of sec-
          tions starting at number 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 argu-
          ment 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 about the object called Name. 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, flags),
          -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.





Page 2                       Reliant UNIX 5.44                Printed 11/98

dump(1)                                                             dump(1)

          For example,

              dump -sv -n .symtab files

          will produce the same formatted output as

              dump -tv files,

          but

              dump -s -n .symtab files

          will print raw data in hexadecimal. Without additional modifiers,
          dump -sv files will dump all sections in the specified files,
          interpreting all those that it can. The rest, such as .text or
          .data are dumped as raw data.

     The dump command attempts to format the information it dumps in a
     meaningful way, printing certain information in character, hexade-
     cimal, octal or decimal representation as appropriate.

SEE ALSO
     a.out(4), ar(4).































Page 3                       Reliant UNIX 5.44                Printed 11/98