unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

dump(1)                          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 argu-
       ments.

       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 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  entry
       -T index1,index2        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 number or
       -d number1,number2      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 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
                               relocation section, use dump -s -n name for raw
                               data output, or dump -sv  -n  name  for  inter-
                               preted output.




       -n name                 Dumps  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
                               symbol table entry associated with  the  symbol
                               whose  name  is  .text, where dump -h -n  .text
                               will dump the section  header  information  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 file-
                               name..., but dump  -s  -n  .symtab  filename...
                               will  print  raw  data  in hexadecimal. Without
                               additional modifiers, dump -sv filename... 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 utility attempts to format the information it dumps in a mean-
       ingful way, printing certain  information  in  character,  hexadecimal,
       octal, or decimal representation as appropriate.

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


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWbtool


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



SunOS 5.10                        6 Sep 2002                           dump(1)