1 .\" Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 1998, 2000 Free Software Foundation
2 .\" See section COPYING for conditions for redistribution
3 .TH objdump 1 "5 November 1991" "Free Software Foundation" "GNU Development Tools"
11 objdump \- display information from object files.
18 .RB "[\|" \-a | \-\-archive\-headers "\|]"
21 .RB " | " "\-\-target="\c
24 .RB "[\|" \-C | \-\-demangle "\|]"
25 .RB "[\|" \-\-debugging "\|]"
26 .RB "[\|" \-d | \-\-disassemble "\|]"
27 .RB "[\|" \-D | \-\-disassemble-all "\|]"
28 .RB "[\|" \-\-disassemble\-zeroes "\|]"
29 .RB "[\|" \-EB | \-EL | \-\-endian=\c
32 .RB "[\|" \-f | \-\-file\-headers "\|]"
33 .RB "[\|" \-h | \-\-section\-headers
34 .RB "| " \-\-headers "\|]"
35 .RB "[\|" \-i | \-\-info "\|]"
38 .RB " | " "\-\-section="\c
41 .RB "[\|" \-l | \-\-line\-numbers "\|]"
44 .RB " | " "\-\-architecture="\c
47 .RB "[\|" \-p | \-\-private\-headers "\|]"
48 .RB "[\|" \-\-prefix\-addresses "\|]"
49 .RB "[\|" \-r | \-\-reloc "\|]"
50 .RB "[\|" \-R | \-\-dynamic\-reloc "\|]"
51 .RB "[\|" \-s | \-\-full\-contents "\|]"
52 .RB "[\|" \-S | \-\-source "\|]"
53 .RB "[\|" \-\-[no\-]show\-raw\-insn "\|]"
54 .RB "[\|" \-\-stabs "\|]"
55 .RB "[\|" \-t | \-\-syms "\|]"
56 .RB "[\|" \-T | \-\-dynamic\-syms "\|]"
57 .RB "[\|" \-x | \-\-all\-headers "\|]"
58 .RB "[\|" "\-\-start\-address="\c
61 .RB "[\|" "\-\-stop\-address="\c
64 .RB "[\|" "\-\-adjust\-vma="\c
67 .RB "[\|" \-\-version "\|]"
68 .RB "[\|" \-\-help "\|]"
76 \& displays information about one or more object files.
77 The options control what particular information to display. This
78 information is mostly useful to programmers who are working on the
79 compilation tools, as opposed to programmers who just want their
80 program to compile and work.
83 are the object files to be examined. When you specify archives,
86 \& shows information on each of the member object files.
89 Where long and short forms of an option are shown together, they are
90 equivalent. At least one option besides
92 (\fB\-\-line\-numbers\fP) must be given.
97 .B \-\-archive\-headers
100 \& are archives, display the archive
101 header information (in a format similar to `\|\c
104 information you could list with `\|\c
109 the object file format of each archive member.
112 .BI "\-\-adjust\-vma=" "offset"
113 When dumping information, first add
115 to all the section addresses. This is useful if the section addresses
116 do not correspond to the symbol table, which can happen when putting
117 sections at particular addresses when using a format which can not
118 represent section addresses, such as a.out.
121 .BI "\-b " "bfdname"\c
123 .BI "\-\-target=" "bfdname"
124 Specify the object-code format for the object files to be
127 \&. This may not be necessary; \c
130 automatically recognize many formats. For example,
133 objdump\ \-b\ oasys\ \-m\ vax\ \-h\ fu.o
136 display summary information from the section headers (`\|\c
141 \|', which is explicitly identified (`\|\c
144 file in the format produced by Oasys compilers. You can list the
145 formats available with the `\|\c
153 Decode (\fIdemangle\fP) low-level symbol names into user-level names.
154 Besides removing any initial underscore prepended by the system, this
155 makes C++ function names readable.
159 Display debugging information. This attempts to parse debugging
160 information stored in the file and print it out using a C like syntax.
161 Only certain types of debugging information have been implemented.
167 Display the assembler mnemonics for the machine
171 This option only disassembles those sections which are
172 expected to contain instructions.
177 .B \-\-disassemble-all
178 Like \fB\-d\fP, but disassemble the contents of all sections, not just
179 those expected to contain instructions.
182 .B \-\-prefix\-addresses
183 When disassembling, print the complete address on each line. This is
184 the older disassembly format.
187 .B \-\-disassemble\-zeroes
188 Normally the disassembly output will skip blocks of zeroes. This
189 option directs the disassembler to disassemble those blocks, just like
197 .BI "\-\-endian=" "{big|little}"
198 Specify the endianness of the object files. This only affects
199 disassembly. This can be useful when disassembling a file format which
200 does not describe endianness information, such as S-records.
206 Display summary information from the overall header of
214 .B \-\-section\-headers
217 Display summary information from the section headers of the
222 Print a summary of the options to
230 Display a list showing all architectures and object formats available
231 for specification with \c
240 .BI "\-\-section=" "name"
241 Display information only for section \c
249 Label the display (using debugging information) with the filename
250 and source line numbers corresponding to the object code shown.
251 Only useful with \fB\-d\fP, \fB\-D\fP, or \fB\-r\fP.
254 .BI "\-m " "machine"\c
256 .BI "\-\-architecture=" "machine"
257 Specify the architecture to use when disassembling object files. This
258 can be useful when disassembling object files which do not describe
259 architecture information, such as S-records. You can list the available
260 architectures with the \fB\-i\fP option.
265 .B \-\-private\-headers
266 Print information that is specific to the object file format. The
267 exact information printed depends upon the object file format. For
268 some object file formats, no additional information is printed.
274 Print the relocation entries of the file. If used with \fB\-d\fP or
275 \fB\-D\fP, the relocations are printed interspersed with the
281 .B \-\-dynamic\-reloc
282 Print the dynamic relocation entries of the file. This is only
283 meaningful for dynamic objects, such as certain types of shared
289 .B \-\-full\-contents
290 Display the full contents of any sections requested.
296 Display source code intermixed with disassembly, if possible. Implies
300 .B \-\-show\-raw\-insn
301 When disassembling instructions, print the instruction in hex as well as
302 in symbolic form. This is the default except when
303 .B \-\-prefix\-addresses
307 .B \-\-no\-show\-raw\-insn
308 When disassembling instructions, do not print the instruction bytes.
309 This is the default when
310 .B \-\-prefix\-addresses
315 Display the contents of the .stab, .stab.index, and .stab.excl
316 sections from an ELF file. This is only useful on systems (such as
317 Solaris 2.0) in which .stab debugging symbol-table entries are carried
318 in an ELF section. In most other file formats, debugging symbol-table
319 entries are interleaved with linkage symbols, and are visible in the
324 .BI "\-\-start\-address=" "address"
325 Start displaying data at the specified address. This affects the output
335 .BI "\-\-stop\-address=" "address"
336 Stop displaying data at the specified address. This affects the output
349 Symbol Table. Print the symbol table entries of the file.
350 This is similar to the information provided by the `\|\c
358 Dynamic Symbol Table. Print the dynamic symbol table entries of the
359 file. This is only meaningful for dynamic objects, such as certain
360 types of shared libraries. This is similar to the information
361 provided by the `\|\c
363 \|' program when given the
369 Print the version number of
377 Display all available header information, including the symbol table and
378 relocation entries. Using `\|\c
380 \|' is equivalent to specifying all of
382 .B \-a \-f \-h \-r \-t\c
386 .RB "`\|" binutils "\|'"
392 The GNU Binary Utilities\c
393 \&, Roland H. Pesch (October 1991);
397 Copyright (c) 1991, 92, 93, 94, 95, 1996 Free Software Foundation, Inc.
400 This document is distributed under the terms of the GNU Free
401 Documenation License. That license is described in the GNU Free
402 Documentation License section.
404 .SH GNU Free Documentation License
405 Version 1.1, March 2000
407 Copyright (C) 2000 Free Software Foundation, Inc.
408 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
410 Everyone is permitted to copy and distribute verbatim
411 copies of this license document, but changing it is
416 The purpose of this License is to make a manual, textbook, or other
417 written document "free" in the sense of freedom: to assure everyone
418 the effective freedom to copy and redistribute it, with or without
419 modifying it, either commercially or noncommercially. Secondarily,
420 this License preserves for the author and publisher a way to get
421 credit for their work, while not being considered responsible for
422 modifications made by others.
424 This License is a kind of "copyleft", which means that derivative
425 works of the document must themselves be free in the same sense. It
426 complements the GNU General Public License, which is a copyleft
427 license designed for free software.
429 We have designed this License in order to use it for manuals for free
430 software, because free software needs free documentation: a free
431 program should come with manuals providing the same freedoms that the
432 software does. But this License is not limited to software manuals;
433 it can be used for any textual work, regardless of subject matter or
434 whether it is published as a printed book. We recommend this License
435 principally for works whose purpose is instruction or reference.
437 1. APPLICABILITY AND DEFINITIONS
439 This License applies to any manual or other work that contains a
440 notice placed by the copyright holder saying it can be distributed
441 under the terms of this License. The "Document", below, refers to any
442 such manual or work. Any member of the public is a licensee, and is
445 A "Modified Version" of the Document means any work containing the
446 Document or a portion of it, either copied verbatim, or with
447 modifications and/or translated into another language.
449 A "Secondary Section" is a named appendix or a front-matter section of
450 the Document that deals exclusively with the relationship of the
451 publishers or authors of the Document to the Document's overall subject
452 (or to related matters) and contains nothing that could fall directly
453 within that overall subject. (For example, if the Document is in part a
454 textbook of mathematics, a Secondary Section may not explain any
455 mathematics.) The relationship could be a matter of historical
456 connection with the subject or with related matters, or of legal,
457 commercial, philosophical, ethical or political position regarding
460 The "Invariant Sections" are certain Secondary Sections whose titles
461 are designated, as being those of Invariant Sections, in the notice
462 that says that the Document is released under this License.
464 The "Cover Texts" are certain short passages of text that are listed,
465 as Front-Cover Texts or Back-Cover Texts, in the notice that says that
466 the Document is released under this License.
468 A "Transparent" copy of the Document means a machine-readable copy,
469 represented in a format whose specification is available to the
470 general public, whose contents can be viewed and edited directly and
471 straightforwardly with generic text editors or (for images composed of
472 pixels) generic paint programs or (for drawings) some widely available
473 drawing editor, and that is suitable for input to text formatters or
474 for automatic translation to a variety of formats suitable for input
475 to text formatters. A copy made in an otherwise Transparent file
476 format whose markup has been designed to thwart or discourage
477 subsequent modification by readers is not Transparent. A copy that is
478 not "Transparent" is called "Opaque".
480 Examples of suitable formats for Transparent copies include plain
481 ASCII without markup, Texinfo input format, LaTeX input format, SGML
482 or XML using a publicly available DTD, and standard-conforming simple
483 HTML designed for human modification. Opaque formats include
484 PostScript, PDF, proprietary formats that can be read and edited only
485 by proprietary word processors, SGML or XML for which the DTD and/or
486 processing tools are not generally available, and the
487 machine-generated HTML produced by some word processors for output
490 The "Title Page" means, for a printed book, the title page itself,
491 plus such following pages as are needed to hold, legibly, the material
492 this License requires to appear in the title page. For works in
493 formats which do not have any title page as such, "Title Page" means
494 the text near the most prominent appearance of the work's title,
495 preceding the beginning of the body of the text.
499 You may copy and distribute the Document in any medium, either
500 commercially or noncommercially, provided that this License, the
501 copyright notices, and the license notice saying this License applies
502 to the Document are reproduced in all copies, and that you add no other
503 conditions whatsoever to those of this License. You may not use
504 technical measures to obstruct or control the reading or further
505 copying of the copies you make or distribute. However, you may accept
506 compensation in exchange for copies. If you distribute a large enough
507 number of copies you must also follow the conditions in section 3.
509 You may also lend copies, under the same conditions stated above, and
510 you may publicly display copies.
512 3. COPYING IN QUANTITY
514 If you publish printed copies of the Document numbering more than 100,
515 and the Document's license notice requires Cover Texts, you must enclose
516 the copies in covers that carry, clearly and legibly, all these Cover
517 Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
518 the back cover. Both covers must also clearly and legibly identify
519 you as the publisher of these copies. The front cover must present
520 the full title with all words of the title equally prominent and
521 visible. You may add other material on the covers in addition.
522 Copying with changes limited to the covers, as long as they preserve
523 the title of the Document and satisfy these conditions, can be treated
524 as verbatim copying in other respects.
526 If the required texts for either cover are too voluminous to fit
527 legibly, you should put the first ones listed (as many as fit
528 reasonably) on the actual cover, and continue the rest onto adjacent
531 If you publish or distribute Opaque copies of the Document numbering
532 more than 100, you must either include a machine-readable Transparent
533 copy along with each Opaque copy, or state in or with each Opaque copy
534 a publicly-accessible computer-network location containing a complete
535 Transparent copy of the Document, free of added material, which the
536 general network-using public has access to download anonymously at no
537 charge using public-standard network protocols. If you use the latter
538 option, you must take reasonably prudent steps, when you begin
539 distribution of Opaque copies in quantity, to ensure that this
540 Transparent copy will remain thus accessible at the stated location
541 until at least one year after the last time you distribute an Opaque
542 copy (directly or through your agents or retailers) of that edition to
545 It is requested, but not required, that you contact the authors of the
546 Document well before redistributing any large number of copies, to give
547 them a chance to provide you with an updated version of the Document.
551 You may copy and distribute a Modified Version of the Document under
552 the conditions of sections 2 and 3 above, provided that you release
553 the Modified Version under precisely this License, with the Modified
554 Version filling the role of the Document, thus licensing distribution
555 and modification of the Modified Version to whoever possesses a copy
556 of it. In addition, you must do these things in the Modified Version:
558 A. Use in the Title Page (and on the covers, if any) a title distinct
559 from that of the Document, and from those of previous versions
560 (which should, if there were any, be listed in the History section
561 of the Document). You may use the same title as a previous version
562 if the original publisher of that version gives permission.
564 B. List on the Title Page, as authors, one or more persons or entities
565 responsible for authorship of the modifications in the Modified
566 Version, together with at least five of the principal authors of the
567 Document (all of its principal authors, if it has less than five).
569 C. State on the Title page the name of the publisher of the
570 Modified Version, as the publisher.
572 D. Preserve all the copyright notices of the Document.
574 E. Add an appropriate copyright notice for your modifications
575 adjacent to the other copyright notices.
577 F. Include, immediately after the copyright notices, a license notice
578 giving the public permission to use the Modified Version under the
579 terms of this License, in the form shown in the Addendum below.
580 Preserve in that license notice the full lists of Invariant Sections
581 and required Cover Texts given in the Document's license notice.
583 H. Include an unaltered copy of this License.
585 I. Preserve the section entitled "History", and its title, and add to
586 it an item stating at least the title, year, new authors, and
587 publisher of the Modified Version as given on the Title Page. If
588 there is no section entitled "History" in the Document, create one
589 stating the title, year, authors, and publisher of the Document as
590 given on its Title Page, then add an item describing the Modified
591 Version as stated in the previous sentence.
593 J. Preserve the network location, if any, given in the Document for
594 public access to a Transparent copy of the Document, and likewise
595 the network locations given in the Document for previous versions
596 it was based on. These may be placed in the "History" section.
597 You may omit a network location for a work that was published at
598 least four years before the Document itself, or if the original
599 publisher of the version it refers to gives permission.
601 K. In any section entitled "Acknowledgements" or "Dedications",
602 preserve the section's title, and preserve in the section all the
603 substance and tone of each of the contributor acknowledgements
604 and/or dedications given therein.
606 L. Preserve all the Invariant Sections of the Document,
607 unaltered in their text and in their titles. Section numbers
608 or the equivalent are not considered part of the section titles.
610 M. Delete any section entitled "Endorsements". Such a section
611 may not be included in the Modified Version.
613 N. Do not retitle any existing section as "Endorsements"
614 or to conflict in title with any Invariant Section.
616 If the Modified Version includes new front-matter sections or
617 appendices that qualify as Secondary Sections and contain no material
618 copied from the Document, you may at your option designate some or all
619 of these sections as invariant. To do this, add their titles to the
620 list of Invariant Sections in the Modified Version's license notice.
621 These titles must be distinct from any other section titles.
623 You may add a section entitled "Endorsements", provided it contains
624 nothing but endorsements of your Modified Version by various
625 parties--for example, statements of peer review or that the text has
626 been approved by an organization as the authoritative definition of a
629 You may add a passage of up to five words as a Front-Cover Text, and a
630 passage of up to 25 words as a Back-Cover Text, to the end of the list
631 of Cover Texts in the Modified Version. Only one passage of
632 Front-Cover Text and one of Back-Cover Text may be added by (or
633 through arrangements made by) any one entity. If the Document already
634 includes a cover text for the same cover, previously added by you or
635 by arrangement made by the same entity you are acting on behalf of,
636 you may not add another; but you may replace the old one, on explicit
637 permission from the previous publisher that added the old one.
639 The author(s) and publisher(s) of the Document do not by this License
640 give permission to use their names for publicity for or to assert or
641 imply endorsement of any Modified Version.
644 5. COMBINING DOCUMENTS
646 You may combine the Document with other documents released under this
647 License, under the terms defined in section 4 above for modified
648 versions, provided that you include in the combination all of the
649 Invariant Sections of all of the original documents, unmodified, and
650 list them all as Invariant Sections of your combined work in its
653 The combined work need only contain one copy of this License, and
654 multiple identical Invariant Sections may be replaced with a single
655 copy. If there are multiple Invariant Sections with the same name but
656 different contents, make the title of each such section unique by
657 adding at the end of it, in parentheses, the name of the original
658 author or publisher of that section if known, or else a unique number.
659 Make the same adjustment to the section titles in the list of
660 Invariant Sections in the license notice of the combined work.
662 In the combination, you must combine any sections entitled "History"
663 in the various original documents, forming one section entitled
664 "History"; likewise combine any sections entitled "Acknowledgements",
665 and any sections entitled "Dedications". You must delete all sections
666 entitled "Endorsements."
669 6. COLLECTIONS OF DOCUMENTS
671 You may make a collection consisting of the Document and other documents
672 released under this License, and replace the individual copies of this
673 License in the various documents with a single copy that is included in
674 the collection, provided that you follow the rules of this License for
675 verbatim copying of each of the documents in all other respects.
677 You may extract a single document from such a collection, and distribute
678 it individually under this License, provided you insert a copy of this
679 License into the extracted document, and follow this License in all
680 other respects regarding verbatim copying of that document.
683 7. AGGREGATION WITH INDEPENDENT WORKS
685 A compilation of the Document or its derivatives with other separate
686 and independent documents or works, in or on a volume of a storage or
687 distribution medium, does not as a whole count as a Modified Version
688 of the Document, provided no compilation copyright is claimed for the
689 compilation. Such a compilation is called an "aggregate", and this
690 License does not apply to the other self-contained works thus compiled
691 with the Document, on account of their being thus compiled, if they
692 are not themselves derivative works of the Document.
694 If the Cover Text requirement of section 3 is applicable to these
695 copies of the Document, then if the Document is less than one quarter
696 of the entire aggregate, the Document's Cover Texts may be placed on
697 covers that surround only the Document within the aggregate.
698 Otherwise they must appear on covers around the whole aggregate.
703 Translation is considered a kind of modification, so you may
704 distribute translations of the Document under the terms of section 4.
705 Replacing Invariant Sections with translations requires special
706 permission from their copyright holders, but you may include
707 translations of some or all Invariant Sections in addition to the
708 original versions of these Invariant Sections. You may include a
709 translation of this License provided that you also include the
710 original English version of this License. In case of a disagreement
711 between the translation and the original English version of this
712 License, the original English version will prevail.
717 You may not copy, modify, sublicense, or distribute the Document except
718 as expressly provided for under this License. Any other attempt to
719 copy, modify, sublicense or distribute the Document is void, and will
720 automatically terminate your rights under this License. However,
721 parties who have received copies, or rights, from you under this
722 License will not have their licenses terminated so long as such
723 parties remain in full compliance.
726 10. FUTURE REVISIONS OF THIS LICENSE
728 The Free Software Foundation may publish new, revised versions
729 of the GNU Free Documentation License from time to time. Such new
730 versions will be similar in spirit to the present version, but may
731 differ in detail to address new problems or concerns. See
732 http://www.gnu.org/copyleft/.
734 Each version of the License is given a distinguishing version number.
735 If the Document specifies that a particular numbered version of this
736 License "or any later version" applies to it, you have the option of
737 following the terms and conditions either of that specified version or
738 of any later version that has been published (not as a draft) by the
739 Free Software Foundation. If the Document does not specify a version
740 number of this License, you may choose any version ever published (not
741 as a draft) by the Free Software Foundation.
744 ADDENDUM: How to use this License for your documents
746 To use this License in a document you have written, include a copy of
747 the License in the document and put the following copyright and
748 license notices just after the title page:
750 Copyright (c) YEAR YOUR NAME.
751 Permission is granted to copy, distribute and/or
752 modify this document under the terms of the GNU
753 Free Documentation License, Version 1.1 or any later
754 version published by the Free Software Foundation;
755 with the Invariant Sections being LIST THEIR TITLES,
756 with the Front-Cover Texts being LIST, and with the
757 Back-Cover Texts being LIST. A copy of the license
758 is included in the section entitled "GNU Free
759 Documentation License".
761 If you have no Invariant Sections, write "with no Invariant Sections"
762 instead of saying which ones are invariant. If you have no
763 Front-Cover Texts, write "no Front-Cover Texts" instead of
764 "Front-Cover Texts being LIST"; likewise for Back-Cover Texts.
766 If your document contains nontrivial examples of program code, we
767 recommend releasing these examples in parallel under your choice of
768 free software license, such as the GNU General Public License,
769 to permit their use in free software.
projects / deliverable / binutils-gdb.git / blob