objdump(1)            GNU Development Tools            objdump(1)

       objdump - display information from object files.

              [-a|--archive-headers] [-b bfdname |
              --target=bfdname] [-C|--demangle] [--debugging]
              [-d|--disassemble] [-D|--disassemble-all]
              [-EB|-EL|--endian={big|little}] [-f|--file-headers]
              [-h|--section-headers | --headers] [-i|--info]
              [-j section | --section=section]
              [-l|--line-numbers] [-m machine |
              --architecture=machine] [--prefix-addresses]
              [-r|--reloc] [-R|--dynamic-reloc]
              [-s|--full-contents] [-S|--source]
              [--[no-]show-raw-insn] [--stabs] [-t|--syms]
              [-T|--dynamic-syms] [-x|--all-headers]
              [--start-address=address] [--stop-address=address]
              [--adjust-vma=offset] [--version] [--help]

       objdump displays information  about  one  or  more  object
       files.  The options control what particular information to
       display.  This information is mostly useful to programmers
       who  are  working  on the compilation tools, as opposed to
       programmers who just want their  program  to  compile  and

       objfile...  are the object files to be examined.  When you
       specify archives, objdump shows information on each of the
       member object files.

       Where  long and short forms of an option are shown togeth-
       er, they are equivalent.  At least one option  besides  -l
       (--line-numbers) must be given.


              If any files from objfile are archives, display the
              archive header information (in a format similar  to
              `ls  -l').   Besides the information you could list
              with `ar tv', `objdump -a' shows  the  object  file
              format of each archive member.

              When  dumping  information, first add offset to all
              the section addresses.  This is useful if the  sec-
              tion  addresses  do  not  correspond  to the symbol
              table, which can happen when  putting  sections  at
              particular  addresses when using a format which can
              not represent section addresses, such as a.out.

       -b bfdname

              Specify the object-code format for the object files
              to  be bfdname.  This may not be necessary; objdump
              can automatically recognize many formats.  For  ex-

              objdump -b oasys -m vax -h fu.o

              display  summary information from the section head-
              ers (`-h') of `fu.o', which is  explicitly  identi-
              fied (`-m') as a Vax object file in the format pro-
              duced by Oasys compilers.  You can list the formats
              available with the `-i' option.


              Decode (demangle) low-level symbol names into user-
              level names.  Besides removing any  initial  under-
              score prepended by the system, this makes C++ func-
              tion names readable.

              Display debugging information.   This  attempts  to
              parse  debugging information stored in the file and
              print it out using a C like syntax.   Only  certain
              types of debugging information have been implement-


              Display the assembler mnemonics for the machine in-
              structions  from  objfile.  This option only disas-
              sembles those sections which are expected  to  con-
              tain instructions.


              Like  -d,  but disassemble the contents of all sec-
              tions, not just those expected to contain  instruc-

              When  disassembling,  print the complete address on
              each line.  This is the older disassembly format.

              Normally the disassembly output will skip blocks of
              zeroes.   This  option  directs the disassembler to
              disassemble those blocks, just like any other data.



              Specify  the  endianness of the object files.  This
              only affects disassembly.  This can be useful  when
              disassembling a file format which does not describe
              endianness information, such as S-records.


              Display summary information from the overall header
              of each file in objfile.



              Display  summary information from the section head-
              ers of the object file.

       --help Print a summary of the options to objdump and exit.


       --info Display a list showing all architectures and object
              formats available for specification with -b or  -m.

       -j name

              Display information only for section name.


              Label  the  display  (using  debugging information)
              with the filename and source  line  numbers  corre-
              sponding  to  the  object  code shown.  Only useful
              with -d, -D, or -r.

       -m machine

              Specify the architecture to use when  disassembling
              object  files.   This  can be useful when disassem-
              bling object files which do not describe  architec-
              ture  information, such as S-records.  You can list
              the available architectures with the -i option.


              Print the relocation entries of the file.  If  used
              with  -d  or -d, the relocations are printed inter-
              spersed with the disassembly.


              Print the dynamic relocation entries of  the  file.
              This  is  only meaningful for dynamic objects, such
              as certain types of shared libraries.


              Display the full contents of any sections  request-


              Display source code intermixed with disassembly, if
              possible.  Implies -d.

              When disassembling instructions, print the instruc-
              tion  in  hex as well as in symbolic form.  This is
              the default except when --prefix-addresses is used.

              When  disassembling  instructions, do not print the
              instruction bytes.  This is the default when --pre-
              fix-addresses is used.

              Display the contents of the .stab, .stab.index, and
              .stab.excl sections from an ELF file.  This is only
              useful  on  systems  (such as Solaris 2.0) in which
              .stab debugging symbol-table entries are carried in
              an ELF section.  In most other file formats, debug-
              ging  symbol-table  entries  are  interleaved  with
              linkage symbols, and are visible in the --syms out-

              Start displaying data  at  the  specified  address.
              This  affects  the  output of the -d, -r and -s op-

              Stop displaying  data  at  the  specified  address.
              This  affects  the  output of the -d, -r and -s op-


       --syms Symbol Table.  Print the symbol  table  entries  of
              the  file.  This is similar to the information pro-
              vided by the `nm' program.


              Dynamic Symbol Table.   Print  the  dynamic  symbol
              table entries of the file.  This is only meaningful
              for dynamic  objects,  such  as  certain  types  of
              shared  libraries.  This is similar to the informa-
              tion provided by the `nm' program when given the -D
              (--dynamic) option.

              Print the version number of objdump and exit.


              Display all available header information, including
              the symbol table  and  relocation  entries.   Using
              `-x'  is  equivalent to specifying all of `-a -f -h
              -r -t'.

       `binutils' entry in info; The GNU Binary Utilities, Roland
       H. Pesch (October 1991); nm(1).

       Copyright  (c)  1991,  92,  93, 94, 95, 1996 Free Software
       Foundation, Inc.

       Permission is granted  to  make  and  distribute  verbatim
       copies  of  this  manual provided the copyright notice and
       this permission notice are preserved on all copies.

       Permission is granted to copy and distribute modified ver-
       sions  of  this  manual  under the conditions for verbatim
       copying, provided that the entire resulting  derived  work
       is  distributed  under  the  terms  of a permission notice
       identical to this one.

       Permission is granted to copy and distribute  translations
       of this manual into another language, under the above con-
       ditions for modified versions, except that this permission
       notice  may  be  included  in translations approved by the
       Free Software Foundation instead of in  the  original  En-

cygnus support           5 November 1991                        1