Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ att_dump(1) — DG/UX 5.4.2A

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

a.out(4)

ar(4)



att_dump(1)                      DG/UX 5.4.2                     att_dump(1)


NAME
       attdump - dump parts of an object or object archive file

SYNOPSIS
       attdump [ options ] files

DESCRIPTION
       The attdump command dumps selected parts of each of its file
       arguments.

       This command will accept object and archives of object files.  It
       processes each file argument according to one or more options.  These
       options are supported in both ELF and COFF environments:

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

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

       -f        Dump each file header.

       -o        Dump program header from ELF files; dump optional header
                 from COFF files.

       -h        Dump section headers.

       -s        Dump section contents.

       -r        Dump relocation information.

       -l        Dump line number information.

       -t        Dump symbol table entries.

       -c        Dump the string table.

       -L        Dump dynamic linking information and static shared library
                 information, if available.

       These options are supported only in an ELF environment:

       -C         Dump decoded C++ symbol table names.

       -D         Dump DWARF debugging information.

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

       -V         Print version information.

       -u         When reading a COFF object file, attdump translates the
                  file to ELF internally (this translation does not affect
                  the file contents).  This option controls how much



Licensed material--property of copyright holder(s)                         1




att_dump(1)                      DG/UX 5.4.2                     att_dump(1)


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

       This option is supported only in a COFF environment:

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

       -n name    Dump information pertaining only to the named entity.
                  This modifier applies to -h, -s, -r, -l, 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, whereas
                  dump -h -n .text will dump the section header information
                  for the .text section.

       -p         Suppress printing of the headers.

       -v         Dump information in symbolic representation rather than
                  numeric (e.g., C_STATIC instead of 0X02).

       -d index   Dump only the indexed section.  In an ELF environment, you
                  may specify a range of sections as

                    -d start-index,end-index

                  In a COFF environment, use the +d modifier to specify a
                  range of sections:

                    -d start-index +d end-index


       These modifiers are accepted only in a COFF environment:

       +d index   Dump the sections in the range ending with the indexed
                  section.  The range begins at the first section or at the
                  section specified by the -d option.

       -t index   Dump only the indexed symbol table entry.

       +t index   Dump the symbol table entries in the range ending with the
                  indexed entry.  The range begins at the first symbol table



Licensed material--property of copyright holder(s)                         2




att_dump(1)                      DG/UX 5.4.2                     att_dump(1)


                  entry or at the entry specified by the -t option.

       -u         Underline the name of the file for emphasis.

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

       +z number  Dump the line number entries starting at either function
                  name or line 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.

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

       Although the command produces no output when invoked without options,
       it does serve to verify that a file is an object, executable, or
       archive of an object or executable.

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































Licensed material--property of copyright holder(s)                         3


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