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