Commit | Line | Data |
---|---|---|
16b2b71c NC |
1 | .\" Automatically generated by Pod::Man version 1.02 |
2 | .\" Wed May 30 12:24:28 2001 | |
3 | .\" | |
4 | .\" Standard preamble: | |
5 | .\" ====================================================================== | |
6 | .de Sh \" Subsection heading | |
0285c67d NC |
7 | .br |
8 | .if t .Sp | |
9 | .ne 5 | |
10 | .PP | |
11 | \fB\\$1\fR | |
12 | .PP | |
13 | .. | |
16b2b71c | 14 | .de Sp \" Vertical space (when we can't use .PP) |
0285c67d NC |
15 | .if t .sp .5v |
16 | .if n .sp | |
17 | .. | |
16b2b71c | 18 | .de Ip \" List item |
0285c67d NC |
19 | .br |
20 | .ie \\n(.$>=3 .ne \\$3 | |
21 | .el .ne 3 | |
22 | .IP "\\$1" \\$2 | |
23 | .. | |
16b2b71c | 24 | .de Vb \" Begin verbatim text |
0285c67d NC |
25 | .ft CW |
26 | .nf | |
27 | .ne \\$1 | |
252b5132 | 28 | .. |
16b2b71c | 29 | .de Ve \" End verbatim text |
0285c67d | 30 | .ft R |
252b5132 | 31 | |
0285c67d NC |
32 | .fi |
33 | .. | |
16b2b71c NC |
34 | .\" Set up some character translations and predefined strings. \*(-- will |
35 | .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left | |
36 | .\" double quote, and \*(R" will give a right double quote. | will give a | |
37 | .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used | |
38 | .\" to do unbreakable dashes and therefore won't be available. \*(C` and | |
39 | .\" \*(C' expand to `' in nroff, nothing in troff, for use with C<> | |
0285c67d | 40 | .tr \(*W-|\(bv\*(Tr |
16b2b71c | 41 | .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' |
0285c67d | 42 | .ie n \{\ |
16b2b71c NC |
43 | . ds -- \(*W- |
44 | . ds PI pi | |
45 | . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch | |
46 | . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch | |
47 | . ds L" "" | |
48 | . ds R" "" | |
49 | . ds C` ` | |
50 | . ds C' ' | |
0285c67d NC |
51 | 'br\} |
52 | .el\{\ | |
16b2b71c NC |
53 | . ds -- \|\(em\| |
54 | . ds PI \(*p | |
55 | . ds L" `` | |
56 | . ds R" '' | |
0285c67d | 57 | 'br\} |
16b2b71c NC |
58 | .\" |
59 | .\" If the F register is turned on, we'll generate index entries on stderr | |
60 | .\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and | |
61 | .\" index entries marked with X<> in POD. Of course, you'll have to process | |
62 | .\" the output yourself in some meaningful fashion. | |
63 | .if \nF \{\ | |
64 | . de IX | |
65 | . tm Index:\\$1\t\\n%\t"\\$2" | |
66 | . . | |
67 | . nr % 0 | |
68 | . rr F | |
0285c67d | 69 | .\} |
16b2b71c NC |
70 | .\" |
71 | .\" For nroff, turn off justification. Always turn off hyphenation; it | |
72 | .\" makes way too many mistakes in technical documents. | |
73 | .hy 0 | |
74 | .\" | |
75 | .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). | |
76 | .\" Fear. Run. Save yourself. No user-serviceable parts. | |
0285c67d | 77 | .bd B 3 |
16b2b71c | 78 | . \" fudge factors for nroff and troff |
0285c67d | 79 | .if n \{\ |
16b2b71c NC |
80 | . ds #H 0 |
81 | . ds #V .8m | |
82 | . ds #F .3m | |
83 | . ds #[ \f1 | |
84 | . ds #] \fP | |
0285c67d NC |
85 | .\} |
86 | .if t \{\ | |
16b2b71c NC |
87 | . ds #H ((1u-(\\\\n(.fu%2u))*.13m) |
88 | . ds #V .6m | |
89 | . ds #F 0 | |
90 | . ds #[ \& | |
91 | . ds #] \& | |
0285c67d | 92 | .\} |
16b2b71c | 93 | . \" simple accents for nroff and troff |
0285c67d | 94 | .if n \{\ |
16b2b71c NC |
95 | . ds ' \& |
96 | . ds ` \& | |
97 | . ds ^ \& | |
98 | . ds , \& | |
99 | . ds ~ ~ | |
100 | . ds / | |
0285c67d NC |
101 | .\} |
102 | .if t \{\ | |
16b2b71c NC |
103 | . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" |
104 | . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' | |
105 | . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' | |
106 | . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' | |
107 | . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' | |
108 | . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' | |
0285c67d | 109 | .\} |
16b2b71c | 110 | . \" troff and (daisy-wheel) nroff accents |
0285c67d NC |
111 | .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' |
112 | .ds 8 \h'\*(#H'\(*b\h'-\*(#H' | |
0285c67d NC |
113 | .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] |
114 | .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' | |
115 | .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' | |
116 | .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] | |
117 | .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] | |
118 | .ds ae a\h'-(\w'a'u*4/10)'e | |
119 | .ds Ae A\h'-(\w'A'u*4/10)'E | |
16b2b71c | 120 | . \" corrections for vroff |
0285c67d NC |
121 | .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' |
122 | .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' | |
16b2b71c | 123 | . \" for low resolution devices (crt and lpr) |
0285c67d NC |
124 | .if \n(.H>23 .if \n(.V>19 \ |
125 | \{\ | |
16b2b71c NC |
126 | . ds : e |
127 | . ds 8 ss | |
128 | . ds o a | |
129 | . ds d- d\h'-1'\(ga | |
130 | . ds D- D\h'-1'\(hy | |
131 | . ds th \o'bp' | |
132 | . ds Th \o'LP' | |
133 | . ds ae ae | |
134 | . ds Ae AE | |
0285c67d NC |
135 | .\} |
136 | .rm #[ #] #H #V #F C | |
16b2b71c NC |
137 | .\" ====================================================================== |
138 | .\" | |
139 | .IX Title "OBJDUMP.1 1" | |
140 | .TH OBJDUMP.1 1 "binutils-2.11.90" "2001-05-30" "GNU" | |
141 | .UC | |
0285c67d | 142 | .SH "NAME" |
252b5132 | 143 | objdump \- display information from object files. |
0285c67d | 144 | .SH "SYNOPSIS" |
16b2b71c NC |
145 | .IX Header "SYNOPSIS" |
146 | objdump [ \-a | \-\-archive-headers ] | |
147 | [ \-b \fIbfdname\fR | \-\-target=\fIbfdname\fR ] | |
148 | [ \-C | \-\-demangle[=\fIstyle\fR] ] | |
149 | [ \-d | \-\-disassemble ] | |
150 | [ \-D | \-\-disassemble-all ] | |
151 | [ \-z | \-\-disassemble-zeroes ] | |
152 | [ \-EB | \-EL | \-\-endian={big | little } ] | |
153 | [ \-f | \-\-file-headers ] | |
154 | [ \-\-file-start-context ] | |
155 | [ \-g | \-\-debugging ] | |
156 | [ \-h | \-\-section-headers | \-\-headers ] | |
157 | [ \-i | \-\-info ] | |
158 | [ \-j \fIsection\fR | \-\-section=\fIsection\fR ] | |
159 | [ \-l | \-\-line-numbers ] | |
160 | [ \-S | \-\-source ] | |
161 | [ \-m \fImachine\fR | \-\-architecture=\fImachine\fR ] | |
162 | [ \-M \fIoptions\fR | \-\-disassembler-options=\fIoptions\fR] | |
163 | [ \-p | \-\-private-headers ] | |
164 | [ \-r | \-\-reloc ] | |
165 | [ \-R | \-\-dynamic-reloc ] | |
166 | [ \-s | \-\-full-contents ] | |
167 | [ \-G | \-\-stabs ] | |
168 | [ \-t | \-\-syms ] | |
169 | [ \-T | \-\-dynamic-syms ] | |
170 | [ \-x | \-\-all-headers ] | |
171 | [ \-w | \-\-wide ] | |
172 | [ \-\-start-address=\fIaddress\fR ] | |
173 | [ \-\-stop-address=\fIaddress\fR ] | |
174 | [ \-\-prefix-addresses] | |
175 | [ \-\-[no-]show-raw-insn ] | |
176 | [ \-\-adjust-vma=\fIoffset\fR ] | |
177 | [ \-V | \-\-version ] | |
178 | [ \-H | \-\-help ] | |
0285c67d NC |
179 | \fIobjfile\fR... |
180 | .SH "DESCRIPTION" | |
16b2b71c NC |
181 | .IX Header "DESCRIPTION" |
182 | \&\f(CW\*(C`objdump\*(C'\fR displays information about one or more object files. | |
252b5132 RH |
183 | The options control what particular information to display. This |
184 | information is mostly useful to programmers who are working on the | |
185 | compilation tools, as opposed to programmers who just want their | |
186 | program to compile and work. | |
187 | .PP | |
16b2b71c NC |
188 | \&\fIobjfile\fR... are the object files to be examined. When you |
189 | specify archives, \f(CW\*(C`objdump\*(C'\fR shows information on each of the member | |
0285c67d NC |
190 | object files. |
191 | .SH "OPTIONS" | |
16b2b71c | 192 | .IX Header "OPTIONS" |
0285c67d NC |
193 | The long and short forms of options, shown here as alternatives, are |
194 | equivalent. At least one option from the list | |
16b2b71c NC |
195 | \&\fB\-a,\-d,\-D,\-f,\-g,\-G,\-h,\-H,\-p,\-r,\-R,\-S,\-t,\-T,\-V,\-x\fR must be given. |
196 | .Ip "\f(CW\*(C`\-a\*(C'\fR" 4 | |
197 | .IX Item "-a" | |
198 | .Ip "\f(CW\*(C`\-\-archive\-header\*(C'\fR" 4 | |
199 | .IX Item "--archive-header" | |
0285c67d NC |
200 | If any of the \fIobjfile\fR files are archives, display the archive |
201 | header information (in a format similar to \fBls \-l\fR). Besides the | |
202 | information you could list with \fBar tv\fR, \fBobjdump \-a\fR shows | |
252b5132 | 203 | the object file format of each archive member. |
16b2b71c NC |
204 | .Ip "\f(CW\*(C`\-\-adjust\-vma=\f(CIoffset\f(CW\*(C'\fR" 4 |
205 | .IX Item "--adjust-vma=offset" | |
0285c67d NC |
206 | When dumping information, first add \fIoffset\fR to all the section |
207 | addresses. This is useful if the section addresses do not correspond to | |
208 | the symbol table, which can happen when putting sections at particular | |
209 | addresses when using a format which can not represent section addresses, | |
210 | such as a.out. | |
16b2b71c NC |
211 | .Ip "\f(CW\*(C`\-b \f(CIbfdname\f(CW\*(C'\fR" 4 |
212 | .IX Item "-b bfdname" | |
213 | .Ip "\f(CW\*(C`\-\-target=\f(CIbfdname\f(CW\*(C'\fR" 4 | |
214 | .IX Item "--target=bfdname" | |
0285c67d | 215 | Specify that the object-code format for the object files is |
16b2b71c | 216 | \&\fIbfdname\fR. This option may not be necessary; \fIobjdump\fR can |
0285c67d NC |
217 | automatically recognize many formats. |
218 | .Sp | |
219 | For example, | |
0285c67d | 220 | .Sp |
16b2b71c NC |
221 | .Vb 1 |
222 | \& objdump -b oasys -m vax -h fu.o | |
223 | .Ve | |
0285c67d | 224 | displays summary information from the section headers (\fB\-h\fR) of |
16b2b71c | 225 | \&\fIfu.o\fR, which is explicitly identified (\fB\-m\fR) as a \s-1VAX\s0 object |
252b5132 | 226 | file in the format produced by Oasys compilers. You can list the |
0285c67d | 227 | formats available with the \fB\-i\fR option. |
16b2b71c NC |
228 | .Ip "\f(CW\*(C`\-C\*(C'\fR" 4 |
229 | .IX Item "-C" | |
230 | .Ip "\f(CW\*(C`\-\-demangle[=\f(CIstyle\f(CW]\*(C'\fR" 4 | |
231 | .IX Item "--demangle[=style]" | |
0285c67d | 232 | Decode (\fIdemangle\fR) low-level symbol names into user-level names. |
252b5132 | 233 | Besides removing any initial underscore prepended by the system, this |
0285c67d NC |
234 | makes \*(C+ function names readable. Different compilers have different |
235 | mangling styles. The optional demangling style argument can be used to | |
236 | choose an appropriate demangling style for your compiler. | |
16b2b71c NC |
237 | .Ip "\f(CW\*(C`\-G\*(C'\fR" 4 |
238 | .IX Item "-G" | |
239 | .Ip "\f(CW\*(C`\-\-debugging\*(C'\fR" 4 | |
240 | .IX Item "--debugging" | |
252b5132 RH |
241 | Display debugging information. This attempts to parse debugging |
242 | information stored in the file and print it out using a C like syntax. | |
243 | Only certain types of debugging information have been implemented. | |
16b2b71c NC |
244 | .Ip "\f(CW\*(C`\-d\*(C'\fR" 4 |
245 | .IX Item "-d" | |
246 | .Ip "\f(CW\*(C`\-\-disassemble\*(C'\fR" 4 | |
247 | .IX Item "--disassemble" | |
0285c67d | 248 | Display the assembler mnemonics for the machine instructions from |
16b2b71c | 249 | \&\fIobjfile\fR. This option only disassembles those sections which are |
252b5132 | 250 | expected to contain instructions. |
16b2b71c NC |
251 | .Ip "\f(CW\*(C`\-D\*(C'\fR" 4 |
252 | .IX Item "-D" | |
253 | .Ip "\f(CW\*(C`\-\-disassemble\-all\*(C'\fR" 4 | |
254 | .IX Item "--disassemble-all" | |
0285c67d | 255 | Like \fB\-d\fR, but disassemble the contents of all sections, not just |
252b5132 | 256 | those expected to contain instructions. |
16b2b71c NC |
257 | .Ip "\f(CW\*(C`\-\-prefix\-addresses\*(C'\fR" 4 |
258 | .IX Item "--prefix-addresses" | |
252b5132 RH |
259 | When disassembling, print the complete address on each line. This is |
260 | the older disassembly format. | |
16b2b71c NC |
261 | .Ip "\f(CW\*(C`\-\-disassemble\-zeroes\*(C'\fR" 4 |
262 | .IX Item "--disassemble-zeroes" | |
252b5132 RH |
263 | Normally the disassembly output will skip blocks of zeroes. This |
264 | option directs the disassembler to disassemble those blocks, just like | |
265 | any other data. | |
16b2b71c NC |
266 | .Ip "\f(CW\*(C`\-EB\*(C'\fR" 4 |
267 | .IX Item "-EB" | |
268 | .Ip "\f(CW\*(C`\-EL\*(C'\fR" 4 | |
269 | .IX Item "-EL" | |
270 | .Ip "\f(CW\*(C`\-\-endian={big|little}\*(C'\fR" 4 | |
271 | .IX Item "--endian={big|little}" | |
252b5132 RH |
272 | Specify the endianness of the object files. This only affects |
273 | disassembly. This can be useful when disassembling a file format which | |
16b2b71c NC |
274 | does not describe endianness information, such as S-records. |
275 | .Ip "\f(CW\*(C`\-f\*(C'\fR" 4 | |
276 | .IX Item "-f" | |
277 | .Ip "\f(CW\*(C`\-\-file\-header\*(C'\fR" 4 | |
278 | .IX Item "--file-header" | |
252b5132 | 279 | Display summary information from the overall header of |
0285c67d | 280 | each of the \fIobjfile\fR files. |
16b2b71c NC |
281 | .Ip "\f(CW\*(C`\-\-file\-start\-context\*(C'\fR" 4 |
282 | .IX Item "--file-start-context" | |
0285c67d | 283 | Specify that when displaying interlisted source code/disassembly |
16b2b71c | 284 | (assumes '\-S') from a file that has not yet been displayed, extend the |
0285c67d | 285 | context to the start of the file. |
16b2b71c NC |
286 | .Ip "\f(CW\*(C`\-h\*(C'\fR" 4 |
287 | .IX Item "-h" | |
288 | .Ip "\f(CW\*(C`\-\-section\-header\*(C'\fR" 4 | |
289 | .IX Item "--section-header" | |
290 | .Ip "\f(CW\*(C`\-\-header\*(C'\fR" 4 | |
291 | .IX Item "--header" | |
252b5132 RH |
292 | Display summary information from the section headers of the |
293 | object file. | |
0285c67d NC |
294 | .Sp |
295 | File segments may be relocated to nonstandard addresses, for example by | |
296 | using the \fB\-Ttext\fR, \fB\-Tdata\fR, or \fB\-Tbss\fR options to | |
16b2b71c | 297 | \&\f(CW\*(C`ld\*(C'\fR. However, some object file formats, such as a.out, do not |
0285c67d | 298 | store the starting address of the file segments. In those situations, |
16b2b71c NC |
299 | although \f(CW\*(C`ld\*(C'\fR relocates the sections correctly, using \fBobjdump |
300 | \&\-h\fR to list the file section headers cannot show the correct addresses. | |
0285c67d NC |
301 | Instead, it shows the usual addresses, which are implicit for the |
302 | target. | |
16b2b71c NC |
303 | .Ip "\f(CW\*(C`\-\-help\*(C'\fR" 4 |
304 | .IX Item "--help" | |
305 | Print a summary of the options to \f(CW\*(C`objdump\*(C'\fR and exit. | |
306 | .Ip "\f(CW\*(C`\-i\*(C'\fR" 4 | |
307 | .IX Item "-i" | |
308 | .Ip "\f(CW\*(C`\-\-info\*(C'\fR" 4 | |
309 | .IX Item "--info" | |
252b5132 | 310 | Display a list showing all architectures and object formats available |
0285c67d | 311 | for specification with \fB\-b\fR or \fB\-m\fR. |
16b2b71c NC |
312 | .Ip "\f(CW\*(C`\-j \f(CIname\f(CW\*(C'\fR" 4 |
313 | .IX Item "-j name" | |
314 | .Ip "\f(CW\*(C`\-\-section=\f(CIname\f(CW\*(C'\fR" 4 | |
315 | .IX Item "--section=name" | |
0285c67d | 316 | Display information only for section \fIname\fR. |
16b2b71c NC |
317 | .Ip "\f(CW\*(C`\-l\*(C'\fR" 4 |
318 | .IX Item "-l" | |
319 | .Ip "\f(CW\*(C`\-\-line\-numbers\*(C'\fR" 4 | |
320 | .IX Item "--line-numbers" | |
0285c67d NC |
321 | Label the display (using debugging information) with the filename and |
322 | source line numbers corresponding to the object code or relocs shown. | |
323 | Only useful with \fB\-d\fR, \fB\-D\fR, or \fB\-r\fR. | |
16b2b71c NC |
324 | .Ip "\f(CW\*(C`\-m \f(CImachine\f(CW\*(C'\fR" 4 |
325 | .IX Item "-m machine" | |
326 | .Ip "\f(CW\*(C`\-\-architecture=\f(CImachine\f(CW\*(C'\fR" 4 | |
327 | .IX Item "--architecture=machine" | |
252b5132 RH |
328 | Specify the architecture to use when disassembling object files. This |
329 | can be useful when disassembling object files which do not describe | |
16b2b71c | 330 | architecture information, such as S-records. You can list the available |
0285c67d | 331 | architectures with the \fB\-i\fR option. |
16b2b71c NC |
332 | .Ip "\f(CW\*(C`\-M \f(CIoptions\f(CW\*(C'\fR" 4 |
333 | .IX Item "-M options" | |
334 | .Ip "\f(CW\*(C`\-\-disassembler\-options=\f(CIoptions\f(CW\*(C'\fR" 4 | |
335 | .IX Item "--disassembler-options=options" | |
0285c67d NC |
336 | Pass target specific information to the disassembler. Only supported on |
337 | some targets. | |
338 | .Sp | |
339 | If the target is an \s-1ARM\s0 architecture then this switch can be used to | |
340 | select which register name set is used during disassembler. Specifying | |
16b2b71c | 341 | \&\fB\-M reg-name-std\fR (the default) will select the register names as |
0285c67d | 342 | used in \s-1ARM\s0's instruction set documentation, but with register 13 called |
16b2b71c NC |
343 | \&'sp', register 14 called 'lr' and register 15 called 'pc'. Specifying |
344 | \&\fB\-M reg-names-apcs\fR will select the name set used by the \s-1ARM\s0 | |
0285c67d NC |
345 | Procedure Call Standard, whilst specifying \fB\-M reg-names-raw\fR will |
346 | just use \fBr\fR followed by the register number. | |
347 | .Sp | |
348 | There are also two variants on the \s-1APCS\s0 register naming scheme enabled | |
349 | by \fB\-M reg-names-atpcs\fR and \fB\-M reg-names-special-atpcs\fR which | |
16b2b71c | 350 | use the ARM/Thumb Procedure Call Standard naming conventions. (Eiuther |
0285c67d NC |
351 | with the normal register name sor the special register names). |
352 | .Sp | |
353 | This option can also be used for \s-1ARM\s0 architectures to force the | |
354 | disassembler to interpret all instructions as \s-1THUMB\s0 instructions by | |
16b2b71c | 355 | using the switch \fB\*(--disassembler-options=force-thumb\fR. This can be |
0285c67d NC |
356 | useful when attempting to disassemble thumb code produced by other |
357 | compilers. | |
16b2b71c NC |
358 | .Ip "\f(CW\*(C`\-p\*(C'\fR" 4 |
359 | .IX Item "-p" | |
360 | .Ip "\f(CW\*(C`\-\-private\-headers\*(C'\fR" 4 | |
361 | .IX Item "--private-headers" | |
0285c67d NC |
362 | Print information that is specific to the object file format. The exact |
363 | information printed depends upon the object file format. For some | |
364 | object file formats, no additional information is printed. | |
16b2b71c NC |
365 | .Ip "\f(CW\*(C`\-r\*(C'\fR" 4 |
366 | .IX Item "-r" | |
367 | .Ip "\f(CW\*(C`\-\-reloc\*(C'\fR" 4 | |
368 | .IX Item "--reloc" | |
0285c67d | 369 | Print the relocation entries of the file. If used with \fB\-d\fR or |
16b2b71c | 370 | \&\fB\-D\fR, the relocations are printed interspersed with the |
252b5132 | 371 | disassembly. |
16b2b71c NC |
372 | .Ip "\f(CW\*(C`\-R\*(C'\fR" 4 |
373 | .IX Item "-R" | |
374 | .Ip "\f(CW\*(C`\-\-dynamic\-reloc\*(C'\fR" 4 | |
375 | .IX Item "--dynamic-reloc" | |
252b5132 RH |
376 | Print the dynamic relocation entries of the file. This is only |
377 | meaningful for dynamic objects, such as certain types of shared | |
378 | libraries. | |
16b2b71c NC |
379 | .Ip "\f(CW\*(C`\-s\*(C'\fR" 4 |
380 | .IX Item "-s" | |
381 | .Ip "\f(CW\*(C`\-\-full\-contents\*(C'\fR" 4 | |
382 | .IX Item "--full-contents" | |
252b5132 | 383 | Display the full contents of any sections requested. |
16b2b71c NC |
384 | .Ip "\f(CW\*(C`\-S\*(C'\fR" 4 |
385 | .IX Item "-S" | |
386 | .Ip "\f(CW\*(C`\-\-source\*(C'\fR" 4 | |
387 | .IX Item "--source" | |
252b5132 | 388 | Display source code intermixed with disassembly, if possible. Implies |
16b2b71c NC |
389 | \&\fB\-d\fR. |
390 | .Ip "\f(CW\*(C`\-\-show\-raw\-insn\*(C'\fR" 4 | |
391 | .IX Item "--show-raw-insn" | |
252b5132 RH |
392 | When disassembling instructions, print the instruction in hex as well as |
393 | in symbolic form. This is the default except when | |
16b2b71c NC |
394 | \&\f(CW\*(C`\-\-prefix\-addresses\*(C'\fR is used. |
395 | .Ip "\f(CW\*(C`\-\-no\-show\-raw\-insn\*(C'\fR" 4 | |
396 | .IX Item "--no-show-raw-insn" | |
252b5132 | 397 | When disassembling instructions, do not print the instruction bytes. |
16b2b71c NC |
398 | This is the default when \f(CW\*(C`\-\-prefix\-addresses\*(C'\fR is used. |
399 | .Ip "\f(CW\*(C`\-G\*(C'\fR" 4 | |
400 | .IX Item "-G" | |
401 | .Ip "\f(CW\*(C`\-\-stabs\*(C'\fR" 4 | |
402 | .IX Item "--stabs" | |
0285c67d NC |
403 | Display the full contents of any sections requested. Display the |
404 | contents of the .stab and .stab.index and .stab.excl sections from an | |
16b2b71c NC |
405 | \&\s-1ELF\s0 file. This is only useful on systems (such as Solaris 2.0) in which |
406 | \&\f(CW\*(C`.stab\*(C'\fR debugging symbol-table entries are carried in an \s-1ELF\s0 | |
0285c67d | 407 | section. In most other file formats, debugging symbol-table entries are |
16b2b71c | 408 | interleaved with linkage symbols, and are visible in the \fB\*(--syms\fR |
252b5132 | 409 | output. |
16b2b71c NC |
410 | .Ip "\f(CW\*(C`\-\-start\-address=\f(CIaddress\f(CW\*(C'\fR" 4 |
411 | .IX Item "--start-address=address" | |
252b5132 | 412 | Start displaying data at the specified address. This affects the output |
16b2b71c NC |
413 | of the \f(CW\*(C`\-d\*(C'\fR, \f(CW\*(C`\-r\*(C'\fR and \f(CW\*(C`\-s\*(C'\fR options. |
414 | .Ip "\f(CW\*(C`\-\-stop\-address=\f(CIaddress\f(CW\*(C'\fR" 4 | |
415 | .IX Item "--stop-address=address" | |
252b5132 | 416 | Stop displaying data at the specified address. This affects the output |
16b2b71c NC |
417 | of the \f(CW\*(C`\-d\*(C'\fR, \f(CW\*(C`\-r\*(C'\fR and \f(CW\*(C`\-s\*(C'\fR options. |
418 | .Ip "\f(CW\*(C`\-t\*(C'\fR" 4 | |
419 | .IX Item "-t" | |
420 | .Ip "\f(CW\*(C`\-\-syms\*(C'\fR" 4 | |
421 | .IX Item "--syms" | |
0285c67d NC |
422 | Print the symbol table entries of the file. |
423 | This is similar to the information provided by the \fBnm\fR program. | |
16b2b71c NC |
424 | .Ip "\f(CW\*(C`\-T\*(C'\fR" 4 |
425 | .IX Item "-T" | |
426 | .Ip "\f(CW\*(C`\-\-dynamic\-syms\*(C'\fR" 4 | |
427 | .IX Item "--dynamic-syms" | |
0285c67d NC |
428 | Print the dynamic symbol table entries of the file. This is only |
429 | meaningful for dynamic objects, such as certain types of shared | |
430 | libraries. This is similar to the information provided by the \fBnm\fR | |
16b2b71c NC |
431 | program when given the \fB\-D\fR (\fB\*(--dynamic\fR) option. |
432 | .Ip "\f(CW\*(C`\-\-version\*(C'\fR" 4 | |
433 | .IX Item "--version" | |
434 | Print the version number of \f(CW\*(C`objdump\*(C'\fR and exit. | |
435 | .Ip "\f(CW\*(C`\-x\*(C'\fR" 4 | |
436 | .IX Item "-x" | |
437 | .Ip "\f(CW\*(C`\-\-all\-header\*(C'\fR" 4 | |
438 | .IX Item "--all-header" | |
252b5132 | 439 | Display all available header information, including the symbol table and |
0285c67d | 440 | relocation entries. Using \fB\-x\fR is equivalent to specifying all of |
16b2b71c NC |
441 | \&\fB\-a \-f \-h \-r \-t\fR. |
442 | .Ip "\f(CW\*(C`\-w\*(C'\fR" 4 | |
443 | .IX Item "-w" | |
444 | .Ip "\f(CW\*(C`\-\-wide\*(C'\fR" 4 | |
445 | .IX Item "--wide" | |
0285c67d | 446 | Format some lines for output devices that have more than 80 columns. |
252b5132 | 447 | .SH "SEE ALSO" |
16b2b71c NC |
448 | .IX Header "SEE ALSO" |
449 | \&\fInm\fR\|(1), \fIreadelf\fR\|(1), and the Info entries for \fIbinutils\fR. | |
0285c67d | 450 | .SH "COPYRIGHT" |
16b2b71c | 451 | .IX Header "COPYRIGHT" |
0285c67d | 452 | Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc. |
252b5132 | 453 | .PP |
0285c67d | 454 | Permission is granted to copy, distribute and/or modify this document |
16b2b71c | 455 | under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1 |
0285c67d NC |
456 | or any later version published by the Free Software Foundation; |
457 | with no Invariant Sections, with no Front-Cover Texts, and with no | |
458 | Back-Cover Texts. A copy of the license is included in the | |
16b2b71c | 459 | section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R". |