objdump

NAME

       objdump - display information from object files.

SYNOPSIS

       objdump
              [-a|--archive-headers] [-b bfdname |
              --target=bfdname] [--debugging] [-d|--disassemble]
              [-D|--disassemble-all] [-f|--file-headers]
              [-h|--section-headers | --headers] [-i|--info]
              [-j section | --section=section[-k|--raw] ]
              [-l|--line-numbers] [-m machine |
              --architecture=machine] [-o offset |
              --offset=offset] [-q|--quiet] [-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
              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.


       -f

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


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


       -k

       --raw  Dump  all the loadable section contents as raw data
              on stdout.  Useful for making boot images or  turn-
              ing  an  executable  into raw data.  Some architec-
              tures (such as elf) require that stdout be seekable
              for this to work.


       -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 or -D.


       -m machine

       --architecture=machine
              Specify the object files objfile are for  architec-
              ture machine.  You can list available architectures
              using the `-i' option.


       -o offset

       --offset=offset
               The offset to make byte 0 of a raw dump.


       -q

       --quiet
              Supress most informational  messages,  useful  with
              -k.


       -r


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


       -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.   Not  all
              targets handle this correctly yet.


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