1 .\" Copyright (c) 1991, 1996 Free Software Foundation
2 .\" See section COPYING for conditions for redistribution
3 .TH objdump 1 "5 November 1991" "cygnus support" "GNU Development Tools"
11 objdump \- display information from object files.
18 .RB "[\|" \-a | \-\-archive\-headers "\|]"
21 .RB " | " "\-\-target="\c
24 .RB "[\|" \-\-debugging "\|]"
25 .RB "[\|" \-d | \-\-disassemble "\|]"
26 .RB "[\|" \-D | \-\-disassemble-all "\|]"
27 .RB "[\|" \-EB | \-EL | \-\-endian=\c
30 .RB "[\|" \-f | \-\-file\-headers "\|]"
31 .RB "[\|" \-h | \-\-section\-headers
32 .RB "| " \-\-headers "\|]"
33 .RB "[\|" \-i | \-\-info "\|]"
36 .RB " | " "\-\-section="\c
39 .RB "[\|" \-l | \-\-line\-numbers "\|]"
42 .RB " | " "\-\-architecture="\c
45 .RB "[\|" \-r | \-\-reloc "\|]"
46 .RB "[\|" \-R | \-\-dynamic\-reloc "\|]"
47 .RB "[\|" \-s | \-\-full\-contents "\|]"
48 .RB "[\|" \-S | \-\-source "\|]"
49 .RB "[\|" \-\-show\-raw\-insn "\|]"
50 .RB "[\|" \-\-stabs "\|]"
51 .RB "[\|" \-t | \-\-syms "\|]"
52 .RB "[\|" \-T | \-\-dynamic\-syms "\|]"
53 .RB "[\|" \-x | \-\-all\-headers "\|]"
54 .RB "[\|" "\-\-start\-address="\c
57 .RB "[\|" "\-\-stop\-address="\c
60 .RB "[\|" \-\-version "\|]"
61 .RB "[\|" \-\-help "\|]"
69 \& displays information about one or more object files.
70 The options control what particular information to display. This
71 information is mostly useful to programmers who are working on the
72 compilation tools, as opposed to programmers who just want their
73 program to compile and work.
76 are the object files to be examined. When you specify archives,
79 \& shows information on each of the member object files.
82 Where long and short forms of an option are shown together, they are
83 equivalent. At least one option besides
85 (\fB\-\-line\-numbers\fP) must be given.
90 .B \-\-archive\-headers
93 \& are archives, display the archive
94 header information (in a format similar to `\|\c
97 information you could list with `\|\c
102 the object file format of each archive member.
105 .BI "\-b " "bfdname"\c
107 .BI "\-\-target=" "bfdname"
108 Specify the object-code format for the object files to be
111 \&. This may not be necessary; \c
114 automatically recognize many formats. For example,
117 objdump\ \-b\ oasys\ \-m\ vax\ \-h\ fu.o
120 display summary information from the section headers (`\|\c
125 \|', which is explicitly identified (`\|\c
128 file in the format produced by Oasys compilers. You can list the
129 formats available with the `\|\c
135 Display debugging information. This attempts to parse debugging
136 information stored in the file and print it out using a C like syntax.
137 Only certain types of debugging information have been implemented.
143 Display the assembler mnemonics for the machine
147 This option only disassembles those sections which are
148 expected to contain instructions.
153 .B \-\-disassemble-all
154 Like \fB\-d\fP, but disassemble the contents of all sections, not just
155 those expected to contain instructions.
162 .BI "\-\-endian=" "{big|little}"
163 Specify the endianness of the object files. This only affects
164 disassembly. This can be useful when disassembling a file format which
165 does not describe endianness information, such as S-records.
171 Display summary information from the overall header of
179 .B \-\-section\-headers
182 Display summary information from the section headers of the
187 Print a summary of the options to
195 Display a list showing all architectures and object formats available
196 for specification with \c
205 .BI "\-\-section=" "name"
206 Display information only for section \c
214 Label the display (using debugging information) with the filename
215 and source line numbers corresponding to the object code shown.
216 Only useful with \fB\-d\fP, \fB\-D\fP, or \fB\-r\fP.
219 .BI "\-m " "machine"\c
221 .BI "\-\-architecture=" "machine"
222 Specify the architecture to use when disassembling object files. This
223 can be useful when disasembling object files which do not describe
224 architecture information, such as S-records. You can list the available
225 architectures with the \fB\-i\fP option.
231 Print the relocation entries of the file. If used with \fB\-d\fP or
232 \fB\-d\fP, the relocations are printed interspersed with the
238 .B \-\-dynamic\-reloc
239 Print the dynamic relocation entries of the file. This is only
240 meaningful for dynamic objects, such as certain types of shared
246 .B \-\-full\-contents
247 Display the full contents of any sections requested.
253 Display source code intermixed with disassembly, if possible. Implies
258 When disassembling instructions, print the instruction in hex as well as
259 in symbolic form. Not all targets handle this correctly yet.
263 Display the contents of the .stab, .stab.index, and .stab.excl
264 sections from an ELF file. This is only useful on systems (such as
265 Solaris 2.0) in which .stab debugging symbol-table entries are carried
266 in an ELF section. In most other file formats, debugging symbol-table
267 entries are interleaved with linkage symbols, and are visible in the
271 .BI "\-\-start\-address=" "address"
272 Start displaying data at the specified address. This affects the output
282 .BI "\-\-stop\-address=" "address"
283 Stop displaying data at the specified address. This affects the output
296 Symbol Table. Print the symbol table entries of the file.
297 This is similar to the information provided by the `\|\c
305 Dynamic Symbol Table. Print the dynamic symbol table entries of the
306 file. This is only meaningful for dynamic objects, such as certain
307 types of shared libraries. This is similar to the information
308 provided by the `\|\c
310 \|' program when given the
316 Print the version number of
324 Display all available header information, including the symbol table and
325 relocation entries. Using `\|\c
327 \|' is equivalent to specifying all of
329 .B \-a \-f \-h \-r \-t\c
333 .RB "`\|" binutils "\|'"
339 The GNU Binary Utilities\c
340 \&, Roland H. Pesch (October 1991);
344 Copyright (c) 1991, 92, 93, 94, 95, 1996 Free Software Foundation, Inc.
346 Permission is granted to make and distribute verbatim copies of
347 this manual provided the copyright notice and this permission notice
348 are preserved on all copies.
350 Permission is granted to copy and distribute modified versions of this
351 manual under the conditions for verbatim copying, provided that the
352 entire resulting derived work is distributed under the terms of a
353 permission notice identical to this one.
355 Permission is granted to copy and distribute translations of this
356 manual into another language, under the above conditions for modified
357 versions, except that this permission notice may be included in
358 translations approved by the Free Software Foundation instead of in
359 the original English.