dump(1)                UNIX System V(C Development Set)                 dump(1)


NAME
      dump - dump selected parts of an object file

SYNOPSIS
      dump [ options ] files

DESCRIPTION
      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 decoded C++ symbol table names.

      -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


10/89                                                                    Page 1

dump(1)                UNIX System V(C Development Set)                 dump(1)


                 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.  (See cof2elf(1) for
                 more information.)

      -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
                 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 files interpreting all those
                 that it can and dumping the rest (such as .text or .data) as
                 raw data.



Page 2                                                                    10/89

dump(1)                UNIX System V(C Development Set)                 dump(1)


      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.

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
















































10/89                                                                    Page 3