objdump(1)            GNU Development Tools            objdump(1)


NAME
       objdump - display information from object files.




SYNOPSIS
       objdump
              [-a|--archive-headers] [-b bfdname |
              --target=bfdname] [--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]
              [--show-raw-insn] [--stabs] [-t|--syms]
              [-T|--dynamic-syms] [-x|--all-headers]
              [--start-address=address] [--stop-address=address]
              [--version] [--help] objfile...

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

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


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


       -a

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


       -b bfdname

       --target=bfdname
              Specify the object-code format for the object files



cygnus support           5 November 1991                        1





objdump(1)            GNU Development Tools            objdump(1)


              to be bfdname.  This may not be necessary;  objdump
              can  automatically recognize many formats.  For ex-
              ample,

              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.


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


       -d

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


       -D

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


       -EB

       -EL

       --endian={big|little}
              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.


       -f

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



cygnus support           5 November 1991                        2





objdump(1)            GNU Development Tools            objdump(1)


       -h

       --section-headers

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


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


       -i

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


       -j name

       --section=name
              Display information only for section name.


       -l

       --line-numbers
              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

       --architecture=machine
              Specify the architecture to use when  disassembling
              object files.  This can be useful when disasembling
              object files which do not describe architecture in-
              formation,  such  as  S-records.   You can list the
              available architectures with the -i option.


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


       -r

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



cygnus support           5 November 1991                        3





objdump(1)            GNU Development Tools            objdump(1)


       -R

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


       -s

       --full-contents
              Display  the full contents of any sections request-
              ed.


       -S

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


       --show-raw-insn
              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.


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


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


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


       -t

       --syms Symbol  Table.   Print  the symbol table entries of



cygnus support           5 November 1991                        4





objdump(1)            GNU Development Tools            objdump(1)


              the file.  This is similar to the information  pro-
              vided by the `nm' program.


       -T

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


       --version
              Print the version number of objdump and exit.


       -x

       --all-headers
              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'.


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


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




cygnus support           5 November 1991                        5