1 .\" Copyright (c) 1991 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 "[\|" \-f | \-\-file\-headers "\|]"
28 .RB "[\|" \-h | \-\-section\-headers
29 .RB "| " \-\-headers "\|]"
30 .RB "[\|" \-i | \-\-info "\|]"
33 .RB " | " "\-\-section="\c
36 .RB "[\|" \-l | \-\-line\-numbers "\|]"
39 .RB " | " "\-\-architecture="\c
42 .RB "[\|" \-r | \-\-reloc "\|]"
43 .RB "[\|" \-R | \-\-dynamic\-reloc "\|]"
44 .RB "[\|" \-s | \-\-full\-contents "\|]"
45 .RB "[\|" \-S | \-\-source "\|]"
46 .RB "[\|" \-\-stabs "\|]"
47 .RB "[\|" \-t | \-\-syms "\|]"
48 .RB "[\|" \-T | \-\-dynamic\-syms "\|]"
49 .RB "[\|" \-x | \-\-all\-headers "\|]"
50 .RB "[\|" "\-\-start\-address="\c
53 .RB "[\|" "\-\-stop\-address="\c
56 .RB "[\|" \-\-version "\|]"
57 .RB "[\|" \-\-help "\|]"
65 \& displays information about one or more object files.
66 The options control what particular information to display. This
67 information is mostly useful to programmers who are working on the
68 compilation tools, as opposed to programmers who just want their
69 program to compile and work.
72 are the object files to be examined. When you specify archives,
75 \& shows information on each of the member object files.
78 Where long and short forms of an option are shown together, they are
79 equivalent. At least one option besides
81 (\fB\-\-line\-numbers\fP) must be given.
86 .B \-\-archive\-headers
89 \& are archives, display the archive
90 header information (in a format similar to `\|\c
93 information you could list with `\|\c
98 the object file format of each archive member.
101 .BI "\-b " "bfdname"\c
103 .BI "\-\-target=" "bfdname"
104 Specify the object-code format for the object files to be
107 \&. This may not be necessary; \c
110 automatically recognize many formats. For example,
113 objdump\ \-b\ oasys\ \-m\ vax\ \-h\ fu.o
116 display summary information from the section headers (`\|\c
121 \|', which is explicitly identified (`\|\c
124 file in the format produced by Oasys compilers. You can list the
125 formats available with the `\|\c
131 Display debugging information. This attempts to parse debugging
132 information stored in the file and print it out using a C like syntax.
133 Only certain types of debugging information have been implemented.
139 Display the assembler mnemonics for the machine
143 This option only disassembles those sections which are
144 expected to contain instructions.
149 .B \-\-disassemble-all
150 Like \fB\-d\fP, but disassemble the contents of all sections, not just
151 those expected to contain instructions.
157 Display summary information from the overall header of
165 .B \-\-section\-headers
168 Display summary information from the section headers of the
173 Print a summary of the options to
181 Display a list showing all architectures and object formats available
182 for specification with \c
191 .BI "\-\-section=" "name"
192 Display information only for section \c
200 Label the display (using debugging information) with the filename
201 and source line numbers corresponding to the object code shown.
202 Only useful with \fB\-d\fP or \fB\-D\fP.
205 .BI "\-m " "machine"\c
207 .BI "\-\-architecture=" "machine"
208 Specify the object files \c
210 \& are for architecture
213 \&. You can list available architectures using the `\|\c
222 Print the relocation entries of the file. If used with \fB\-d\fP or
223 \fB\-d\fP, the relocations are printed interspersed with the
229 .B \-\-dynamic\-reloc
230 Print the dynamic relocation entries of the file. This is only
231 meaningful for dynamic objects, such as certain types of shared
237 .B \-\-full\-contents
238 Display the full contents of any sections requested.
244 Display source code intermixed with disassembly, if possible. Implies
249 Display the contents of the .stab, .stab.index, and .stab.excl
250 sections from an ELF file. This is only useful on systems (such as
251 Solaris 2.0) in which .stab debugging symbol-table entries are carried
252 in an ELF section. In most other file formats, debugging symbol-table
253 entries are interleaved with linkage symbols, and are visible in the
257 .BI "\-\-start\-address=" "address"
258 Start displaying data at the specified address. This affects the output
268 .BI "\-\-stop\-address=" "address"
269 Stop displaying data at the specified address. This affects the output
282 Symbol Table. Print the symbol table entries of the file.
283 This is similar to the information provided by the `\|\c
291 Dynamic Symbol Table. Print the dynamic symbol table entries of the
292 file. This is only meaningful for dynamic objects, such as certain
293 types of shared libraries. This is similar to the information
294 provided by the `\|\c
296 \|' program when given the
302 Print the version number of
310 Display all available header information, including the symbol table and
311 relocation entries. Using `\|\c
313 \|' is equivalent to specifying all of
315 .B \-a \-f \-h \-r \-t\c
319 .RB "`\|" binutils "\|'"
325 The GNU Binary Utilities\c
326 \&, Roland H. Pesch (October 1991);
330 Copyright (c) 1991, 92, 93, 94, 95, 1996 Free Software Foundation, Inc.
332 Permission is granted to make and distribute verbatim copies of
333 this manual provided the copyright notice and this permission notice
334 are preserved on all copies.
336 Permission is granted to copy and distribute modified versions of this
337 manual under the conditions for verbatim copying, provided that the
338 entire resulting derived work is distributed under the terms of a
339 permission notice identical to this one.
341 Permission is granted to copy and distribute translations of this
342 manual into another language, under the above conditions for modified
343 versions, except that this permission notice may be included in
344 translations approved by the Free Software Foundation instead of in
345 the original English.