dump(CP)                       6 January 1993                       dump(CP)


 Name

    dump - dump selected parts of a common object file

 Syntax

    dump [ options ] files

 Description

    The dump command outputs selected parts of each of its object files.  The
    output can be directed via the standard redirection tools.  dump operates
    only on COFF executables.

    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 each archive file
              argument.

    -c        Dump the string table.

    -f        Dump each file header.

    -g        Dump the global symbols in the symbol table of an archive.

    -h        Dump section headers.

    -L        Interpret and print the contents of the .lib sections.

    -l        Dump line number information.

    -o        Dump each optional header.

    -r        Dump relocation information.

    -s        Dump section contents.

    -t        Dump symbol table entries.

    -V        Print the dump version number.

    -z name   Dump line number entries for the named function.

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

    -d number  Dump the section number, number, or the range of sections
               starting at number and ending at the number specified by +d.

    +d number  Dump sections in the range either beginning with first section
               or beginning with section specified by -d.

    -n name    Dump information pertaining only to the named entity.  This
               modifier applies to -h, -l, -r, -s, and -t.

    -p         Suppress printing the headers.

    -t index   Dump only the indexed symbol table entry.  The -t used in con-
               junction with +t, specifies a range of symbol table entries.

    +t  index  Dump the symbol table entries in the range ending with the
               indexed entry.  The range begins at the first symbol table
               entry or at the entry specified by the -t option.

    -u         Underline the name of the file for emphasis.

    -v         Dump information in symbolic representation rather than
               numeric (for example, CSTATIC instead of 0X02).  This modif-
               ier can be used with all the above options except -o and -s.

    -z name,number
               Dump line number entry or range of line numbers starting at
               number for the named function.

    +z number  Dump line numbers starting at either function name or number
               specified by -z, up to number specified by +z.

    Blanks separating an option and its modifier are optional.  The comma
    separating the name from the number modifying the -z option may be
    replaced by a blank.

    dump attempts to format the information in a meaningful way, printing
    certain information in character, hexadecimal, octal, or decimal
    representation as appropriate.

 See also

    a.out(FP), ar(FP), hdr(XNX)