objdump - display information from object files.
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] [-p|--private-headers]
[--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...
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.
Where long and short forms of an option are shown together,
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 section
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 example,
objdump -b oasys -m vax -h fu.o
display summary information from the section headers
(`-h') of `fu.o', which is explicitly identified
(`-m') as a Vax object file in the format produced
by Oasys compilers. You can list the formats
available with the `-i' option.
-C
--demangle
Decode (demangle) low-level symbol names into userlevel
names. Besides removing any initial underscore
prepended by the system, this makes C++ function
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 implemented.
-d
--disassemble
Display the assembler mnemonics for the machine instructions
from objfile. This option only disassembles
those sections which are expected to contain
instructions.
-D
--disassemble-all
Like -d, but disassemble the contents of all sections,
not just those expected to contain instructions.
--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 headers
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 corresponding
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 disassembling
object files which do not describe architecture
information, such as S-records. You can list
the available architectures with the -i option.
-p
--private-headers
Print information that is specific to the object
file format. The exact information printed depends
upon the object file format. For some object file
formats, no additional information is printed.
-r
--reloc
Print the relocation entries of the file. If used
with -d or -D, the relocations are printed interspersed
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 requested.
-S
--source
Display source code intermixed with disassembly, if
possible. Implies -d.
--show-raw-insn
When disassembling instructions, print the instruction
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, debugging
symbol-table entries are interleaved with
linkage symbols, and are visible in the --syms output.
--start-address=address
Start displaying data at the specified address.
This affects the output of the -d, -r and -s options.
--stop-address=address
Stop displaying data at the specified address.
This affects the output of the -d, -r and -s options.
-t
--syms Symbol Table. Print the symbol table entries of
the file. This is similar to the information provided
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 information
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'.
`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.
This document is distributed under the terms of the GNU
Free Documentation License, version 1.1. That license is
described in the sources for this manual page, but it is
not displayed here in order to make this manual more consise.
Copies of this license can also be obtained from:
http://www.gnu.org/copyleft/.
Free Software Foundation 5 November 1991 7
Free Software Foundation 5 November 1991 7 [ Back ] |