Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought



dump(1)                  MAXION/OS 1.2v9                  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.

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

     -V         Print version information.

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




                                                                1





dump(1)                  MAXION/OS 1.2v9                  dump(1)



     -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 sec-
                tion 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 sec-
                tion.  When -n is used with -t or -r,  the  argu-
                ment  will  be  treated  as the name of a symbol.
                For example, dump -t -n .text will dump the  sym-
                bol  table entry associated with the symbol whose
                name is .text, where dump -h -n .text  will  dump
                the section header information for the 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  addi-
                tional  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.

     The dump command attempts to format the information it dumps
     in a meaningful way, printing certain information in charac-
     ter,  hexadecimal,  octal  or  decimal   representation   as



                                                                2





dump(1)                  MAXION/OS 1.2v9                  dump(1)



     appropriate.

REFERENCES
     a.out(4), ar(4)

NOTICES
     Modified, August 1996
















































                                                                3



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