Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ar(0)



  dump(1)                             CLIX                             dump(1)



  NAME

    dump - Dumps selected parts of an object file

  SYNOPSIS

    dump [flags] files

  FLAGS

    -a        Dumps the archive header of each member of each archive file
              argument.

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

    -f        Dumps each file header.

    -o        Dumps each optional header.

    -h        Dumps section headers.

    -s        Dumps section contents.

    -r        Dumps relocation information.

    -l        Dumps line number information.

    -t        Dumps symbol table entries.

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

    -c        Dumps the string table.

    -L        Interprets and displays the contents of the .lib sections.

    The following modifiers may be used with the command-line flags to modify
    their actions:

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

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

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

    -p     Suppresses displaying of the headers.



  2/94 - Intergraph Corporation                                              1






  dump(1)                             CLIX                             dump(1)



    -t index
           Dumps only the indexed-symbol table entry.  The -t used in
           conjunction with +t specifies a range of symbol table entries.

    +t index
           Dumps 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 modifier.

    -u     Underlines the name of the file and the section names for emphasis.

    -v     Dumps information in symbolic representation rather than numeric;
           for example, C_STATIC instead of 0X02).  This modifier is used with
           any flag above except the -s flag of dump.

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

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

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

  DESCRIPTION

    The dump command dumps selected parts of each of its object file
    arguments.

    This command accepts both object files and archives of object files.  It
    processes each file argument according to one or more of the flags and
    modifiers.

    The dump command formats the information it dumps in a meaningful way,
    displaying certain information in character, hex, octal, or decimal
    representation as appropriate.

  EXAMPLES

    1.  Key in the following to dump the symbol table entries of file.1 in
        symbolic representation:

        dump -tv file.1


    2.  Key in the following to dump the line numbers of the function main()
        within the file file.2:




  2                                              Intergraph Corporation - 2/94






  dump(1)                             CLIX                             dump(1)



        dump -l -n main file.2


    3.  Key in the following to dump the file and section headers of file.3:

        dump -hfv file.3


  EXIT VALUES

    Always exits with a value of 0.

  RELATED INFORMATION

    Files:  ar(0)







































  2/94 - Intergraph Corporation                                              3




Typewritten Software • bear@typewritten.org • Edmonds, WA 98026