Manual Pages for UNIX Operating System command usage for man dump

User Commands                                             dump(1)



NAME
     dump - dump selected parts of an object file

SYNOPSIS
     dump [-aCcfghLorstV [-p]] [-T index [, indexn]] filename...


     dump [-afhorstL [-p] [v]] filename...


     dump [-hsr [-p] [-d number [, numbern]]] filename...


     dump [-hsrt [-p] [-n name]] filename...


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


     The dump utility is best suited for use  in  shell  scripts,
     whereas  the  elfdump(1)  command  is  recommended  for more
     human-readable output.

OPTIONS
     This utility 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                  Dumps the archive header of each  member
                         of an archive.


     -c                  Dumps the string table(s).


     -C                  Dumps decoded C++ symbol table names.


     -f                  Dumps each file header.


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


     -h                  Dumps the section headers.


     -L                  Dumps dynamic  linking  information  and
                         static  shared  library  information, if



SunOS 5.11           Last change: 6 Sep 2002                    1






User Commands                                             dump(1)



                         available.


     -o                  Dumps each program execution header.


     -r                  Dumps relocation information.


     -s                  Dumps section contents in hexadecimal.


     -t                  Dumps symbol table entries.


     -T index            Dumps  only  the  indexed  symbol  table
     -T index1,index2    entry  defined  by  index  or a range of
                         entries defined by index1,index2.


     -V                  Prints version information.



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

     -d number             Dumps the section number indicated  by
     -d number1,number2    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 sec-
                           tion,  specify  the number of the sec-
                           tion 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 relo-
                           cation section, use dump  -s  -n  name
                           for  raw  data  output, or dump -sv -n
                           name for interpreted output.


     -n name               Dumps information pertaining  only  to
                           the named entity. This modifier can be



SunOS 5.11           Last change: 6 Sep 2002                    2






User Commands                                             dump(1)



                           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 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 informa-
                           tion for the .text section.


     -p                    Suppresses printing of the headings.


     -v                    Dumps    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)


                           -L    (value)


                           -o    (type, flags)


                           -r    (name, type)


                           -s    (interpret   section    contents
                                 wherever possible)


                           -t    (type, bind)

                           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 filename... will  produce  the
                           same  formatted  output  as  dump  -tv
                           filename..., but dump  -s  -n  .symtab



SunOS 5.11           Last change: 6 Sep 2002                    3






User Commands                                             dump(1)



                           filename...  will  print  raw  data in
                           hexadecimal. Without additional modif-
                           iers,  dump  -sv filename... will dump
                           all sections in the files,  interpret-
                           ing  all those that it can and dumping
                           the rest (such as .text or  .data)  as
                           raw data.



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

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | developer/object-file       |
    |_____________________________|_____________________________|


SEE ALSO
     elfdump(1), nm(1), ar.h(3HEAD), a.out(4), attributes(5)

























SunOS 5.11           Last change: 6 Sep 2002                    4