objdump
Hurricane Electric Internet Services
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.
Hurricane Electric Internet Services
Copyright (C) 1998
Hurricane Electric.
All Rights Reserved.