objdump(1)
NAME
objdump - display information from object files.
SYNOPSIS
objdump
[-a|--archive-headers] [-b bfdname |
--target=bfdname] [-C|--demangle] [--debugging]
[-d|--disassemble] [-D|--disassemble-all]
[--disassemble-zeroes]
[-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]
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.
--adjust-vma=offset
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
--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.
-C
--demangle
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.
--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.
--prefix-addresses
When disassembling, print the complete address on
each line. This is the older disassembly format.
--disassemble-zeroes
Normally the disassembly output will skip blocks of
zeroes. This option directs the disassembler to
disassemble those blocks, just like any other data.
-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.
-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 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.
-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. This is
the default except when --prefix-addresses is used.
--no-show-raw-insn
When disassembling instructions, do not print the
instruction bytes. This is the default when --pre-
fix-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
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.