Commit | Line | Data |
---|---|---|
19450a0c RP |
1 | .\" Copyright (c) 1991 Free Software Foundation |
2 | .\" See section COPYING for conditions for redistribution | |
19450a0c RP |
3 | .TH objdump 1 "5 November 1991" "cygnus support" "GNU Development Tools" |
4 | .de BP | |
5 | .sp | |
6 | .ti \-.2i | |
7 | \(** | |
8 | .. | |
9 | ||
10 | .SH NAME | |
11 | objdump\(em\&display information from object files. | |
12 | ||
13 | .SH SYNOPSIS | |
14 | .hy 0 | |
15 | .na | |
16 | .TP | |
b26ac613 | 17 | .B objdump |
19450a0c RP |
18 | .RB "[\|" \-a "\|]" |
19 | .RB "[\|" "\-b\ "\c | |
20 | .I bfdname\c | |
21 | \&\|] | |
22 | .RB "[\|" \-d "\|]" | |
23 | .RB "[\|" \-f "\|]" | |
1f72cab1 | 24 | .RB "[\|" \-h | \-\-header "\|]" |
19450a0c RP |
25 | .RB "[\|" \-i "\|]" |
26 | .RB "[\|" "\-j\ "\c | |
27 | .I section\c | |
28 | \&\|] | |
29 | .RB "[\|" \-l "\|]" | |
30 | .RB "[\|" "\-m\ "\c | |
31 | .I machine\c | |
32 | \&\|] | |
1f72cab1 | 33 | .RB "[\|" \-r | \-\-reloc "\|]" |
19450a0c | 34 | .RB "[\|" \-s "\|]" |
1f72cab1 DM |
35 | .RB "[\|" \-\-stabs "\|]" |
36 | .RB "[\|" \-t | \-\-syms "\|]" | |
19450a0c | 37 | .RB "[\|" \-x "\|]" |
b26ac613 DM |
38 | .RB "[\|" \-\-version "\|]" |
39 | .RB "[\|" \-\-help "\|]" | |
1f72cab1 | 40 | .I objfile\c |
19450a0c RP |
41 | \&.\|.\|. |
42 | .ad b | |
43 | .hy 1 | |
44 | .SH DESCRIPTION | |
45 | \c | |
46 | .B objdump\c | |
47 | \& displays information about one or more object files. | |
48 | The options control what particular information to display. This | |
49 | information is mostly useful to programmers who are working on the | |
50 | compilation tools, as opposed to programmers who just want their | |
51 | program to compile and work. | |
b26ac613 | 52 | .PP |
1f72cab1 | 53 | .IR "objfile" .\|.\|. |
b26ac613 | 54 | are the object files to be examined. When you specify archives, |
19450a0c RP |
55 | \c |
56 | .B objdump\c | |
57 | \& shows information on each of the member object files. | |
58 | ||
b26ac613 DM |
59 | .SH OPTIONS |
60 | Where long and short forms of an option are shown together, they are | |
61 | equivalent. | |
62 | ||
19450a0c RP |
63 | .TP |
64 | .B \-a | |
65 | If any files from \c | |
1f72cab1 | 66 | .I objfile\c |
19450a0c RP |
67 | \& are archives, display the archive |
68 | header information (in a format similar to `\|\c | |
69 | .B ls \-l\c | |
70 | \|'). Besides the | |
71 | information you could list with `\|\c | |
72 | .B ar tv\c | |
73 | \|', `\|\c | |
74 | .B objdump \-a\c | |
75 | \|' shows | |
76 | the object file format of each archive member. | |
77 | ||
78 | .TP | |
79 | .BI "-b " "bfdname"\c | |
80 | \& | |
b26ac613 | 81 | Specify the object-code format for the object files to be |
19450a0c RP |
82 | \c |
83 | .I bfdname\c | |
84 | \&. This may not be necessary; \c | |
85 | .I objdump\c | |
86 | \& can | |
87 | automatically recognize many formats. For example, | |
88 | .sp | |
89 | .br | |
90 | objdump\ \-b\ oasys\ \-m\ vax\ \-h\ fu.o | |
91 | .br | |
92 | .sp | |
93 | ||
b26ac613 | 94 | display summary information from the section headers (`\|\c |
19450a0c RP |
95 | .B \-h\c |
96 | \|') of | |
97 | `\|\c | |
98 | .B fu.o\c | |
99 | \|', which is explicitly identified (`\|\c | |
100 | .B \-m\c | |
101 | \|') as a Vax object | |
102 | file in the format produced by Oasys compilers. You can list the | |
103 | formats available with the `\|\c | |
104 | .B \-i\c | |
105 | \|' option. | |
106 | ||
107 | .TP | |
108 | .B \-d | |
109 | Disassemble. Display the assembler mnemonics for the machine | |
110 | instructions from \c | |
1f72cab1 | 111 | .I objfile\c |
19450a0c RP |
112 | \&. |
113 | ||
114 | .TP | |
115 | .B \-f | |
116 | File header. Display summary information from the overall header of | |
117 | each file in \c | |
1f72cab1 | 118 | .I objfile\c |
19450a0c RP |
119 | \&. |
120 | ||
121 | .TP | |
122 | .B \-h | |
123 | .TP | |
1f72cab1 | 124 | .B \-\-header |
19450a0c RP |
125 | Header. Display summary information from the section headers of the |
126 | object file. | |
127 | ||
b26ac613 DM |
128 | .TP |
129 | .B \-\-help | |
130 | Print a summary of the options to | |
131 | .B objdump | |
132 | and exit. | |
133 | ||
19450a0c RP |
134 | .TP |
135 | .B \-i | |
136 | Display a list showing all architectures and object formats available | |
137 | for specification with \c | |
138 | .B \-b\c | |
139 | \& or \c | |
140 | .B \-m\c | |
141 | \&. | |
142 | ||
143 | .TP | |
144 | .BI "-j " "name"\c | |
145 | \& | |
146 | Display information only for section \c | |
147 | .I name\c | |
148 | \& | |
149 | ||
150 | .TP | |
151 | .B \-l | |
152 | Label the display (using debugging information) with the source filename | |
153 | and line numbers corresponding to the object code shown. | |
154 | ||
155 | .TP | |
156 | .BI "-m " "machine"\c | |
157 | \& | |
158 | Specify the object files \c | |
1f72cab1 | 159 | .I objfile\c |
19450a0c RP |
160 | \& are for architecture |
161 | \c | |
162 | .I machine\c | |
163 | \&. You can list available architectures using the `\|\c | |
164 | .B \-i\c | |
165 | \|' | |
166 | option. | |
167 | ||
168 | .TP | |
169 | .B \-r | |
170 | .TP | |
1f72cab1 | 171 | .B \-\-reloc |
19450a0c RP |
172 | Relocation. Print the relocation entries of the file. |
173 | ||
174 | .TP | |
175 | .B \-s | |
176 | Display the full contents of any sections requested. | |
177 | ||
c5f0c938 | 178 | .TP |
1f72cab1 | 179 | .B \-\-stabs |
c3c93fda JG |
180 | Display the contents of the .stab, .stab.index, and .stab.excl |
181 | sections from an ELF file. This is only useful on systems (such as | |
182 | Solaris 2.0) in which .stab debugging symbol-table entries are carried | |
183 | in an ELF section. In most other file formats, debugging symbol-table | |
184 | entries are interleaved with linkage symbols, and are visible in the | |
1f72cab1 | 185 | \-\-syms output. |
c5f0c938 | 186 | |
19450a0c RP |
187 | .TP |
188 | .B \-t | |
189 | .TP | |
1f72cab1 | 190 | .B \-\-syms |
19450a0c RP |
191 | Symbol Table. Print the symbol table entries of the file. |
192 | This is similar to the information provided by the `\|\c | |
193 | .B nm\c | |
194 | \|' program. | |
195 | ||
b26ac613 DM |
196 | .TP |
197 | .B \-\-version | |
198 | Print the version number of | |
199 | .B objdump | |
200 | and exit. | |
201 | ||
19450a0c RP |
202 | .TP |
203 | .B \-x | |
204 | Display all available header information, including the symbol table and | |
205 | relocation entries. Using `\|\c | |
206 | .B \-x\c | |
207 | \|' is equivalent to specifying all of | |
208 | `\|\c | |
209 | .B \-a \-f \-h \-r \-t\c | |
210 | \|'. | |
211 | ||
19450a0c RP |
212 | .SH "SEE ALSO" |
213 | .RB "`\|" binutils "\|'" | |
214 | entry in | |
215 | .B | |
216 | info\c | |
217 | \&; | |
218 | .I | |
219 | The GNU Binary Utilities\c | |
220 | \&, Roland H. Pesch (October 1991); | |
221 | .BR nm "(" 1 ")." | |
222 | ||
223 | .SH COPYING | |
224 | Copyright (c) 1991 Free Software Foundation, Inc. | |
225 | .PP | |
226 | Permission is granted to make and distribute verbatim copies of | |
227 | this manual provided the copyright notice and this permission notice | |
228 | are preserved on all copies. | |
229 | .PP | |
230 | Permission is granted to copy and distribute modified versions of this | |
231 | manual under the conditions for verbatim copying, provided that the | |
232 | entire resulting derived work is distributed under the terms of a | |
233 | permission notice identical to this one. | |
234 | .PP | |
235 | Permission is granted to copy and distribute translations of this | |
236 | manual into another language, under the above conditions for modified | |
237 | versions, except that this permission notice may be included in | |
238 | translations approved by the Free Software Foundation instead of in | |
239 | the original English. |