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

     -o    Dumps each program execution header.

     -r    Dumps relocation information.

     -s    Dumps section contents in hexadecimal.

     -t    Dumps symbol table entries.

     -T index

     -T index1,index2
           Dumps only the indexed symbol table 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

     -d number1,number2
           Dumps 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  sec-
           tions.  When  -d  is  used  with  -r,  the argument is
           treated as the number of the section or range of  sec-
           tions 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  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 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 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, 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  inter-
     preted,  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 filename...  will  print
     raw  data in hexadecimal. Without additional modifiers, dump
     -sv filename... will dump all sections in the files,  inter-
     preting  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                | SUNWbtool                   |
    |_____________________________|_____________________________|

SEE ALSO

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