MAN page from Trustix binutils-


Section: GNU Development Tools (1)
Updated: 5 November 1991



objdump - display information from object files.



[-a|--archive-headers][-b bfdname | --target=bfdname] [-C|--demangle][--debugging][-d|--disassemble][-D|--disassemble-all][--disassemble-zeroes][-EB|-EL|--endian={big|little}][-f|--file-headers][-h|--section-headers| --headers][-i|--info][-j section | --section=section] [-l|--line-numbers][-m machine | --architecture=machine] [-p|--private-headers][--prefix-addresses][-r|--reloc][-R|--dynamic-reloc][-s|--full-contents][-S|--source][--[no-]show-raw-insn][--stabs][-t|--syms][-T|--dynamic-syms][-x|--all-headers][--start-address=address][--stop-address=address][--adjust-vma=offset][--version][--help]objfile...


objdump displays information about one or more object files.The options control what particular information to display. Thisinformation is mostly useful to programmers who are working on thecompilation tools, as opposed to programmers who just want theirprogram to compile and work.

objfile...are the object files to be examined. When you specify archives,objdump shows information on each of the member object files.



Where long and short forms of an option are shown together, they areequivalent. At least one option besides-l(--line-numbers) must be given.

If any files from objfile are archives, display the archiveheader information (in a format similar to `ls -l'). Besides theinformation you could list with `ar tv', `objdump -a' showsthe object file format of each archive member.

When dumping information, first addoffsetto all the section addresses. This is useful if the section addressesdo not correspond to the symbol table, which can happen when puttingsections at particular addresses when using a format which can notrepresent section addresses, such as a.out.

-b bfdname
Specify the object-code format for the object files to bebfdname. This may not be necessary; objdump canautomatically recognize many formats. For example,

objdump -b oasys -m vax -h fu.o

display summary information from the section headers (`-h') of`fu.o', which is explicitly identified (`-m') as a Vax objectfile in the format produced by Oasys compilers. You can list theformats available with the `-i' option.

Decode (demangle) low-level symbol names into user-level names.Besides removing any initial underscore prepended by the system, thismakes C++ function names readable.

Display debugging information. This attempts to parse debugginginformation stored in the file and print it out using a C like syntax.Only certain types of debugging information have been implemented.

Display the assembler mnemonics for the machineinstructions from objfile.This option only disassembles those sections which areexpected to contain instructions.

Like -d, but disassemble the contents of all sections, not justthose expected to contain instructions.

When disassembling, print the complete address on each line. This isthe older disassembly format.

Normally the disassembly output will skip blocks of zeroes. Thisoption directs the disassembler to disassemble those blocks, just likeany other data.

Specify the endianness of the object files. This only affectsdisassembly. This can be useful when disassembling a file format whichdoes not describe endianness information, such as S-records.

Display summary information from the overall header ofeach file in objfile.

Display summary information from the section headers of theobject file.

Print a summary of the options toobjdumpand exit.

Display a list showing all architectures and object formats availablefor specification with -b or -m.

-j name
Display information only for section name.

Label the display (using debugging information) with the filenameand source line numbers corresponding to the object code shown.Only useful with -d, -D, or -r.

-m machine
Specify the architecture to use when disassembling object files. Thiscan be useful when disassembling object files which do not describearchitecture information, such as S-records. You can list the availablearchitectures with the -i option.

Print information that is specific to the object file format. Theexact information printed depends upon the object file format. Forsome object file formats, no additional information is printed.

Print the relocation entries of the file. If used with -d or-D, the relocations are printed interspersed with thedisassembly.

Print the dynamic relocation entries of the file. This is onlymeaningful for dynamic objects, such as certain types of sharedlibraries.

Display the full contents of any sections requested.

Display source code intermixed with disassembly, if possible. Implies-d.

When disassembling instructions, print the instruction in hex as well asin symbolic form. This is the default except when--prefix-addressesis used.

When disassembling instructions, do not print the instruction bytes.This is the default when--prefix-addressesis used.

Display the contents of the .stab, .stab.index, and .stab.exclsections from an ELF file. This is only useful on systems (such asSolaris 2.0) in which .stab debugging symbol-table entries are carriedin an ELF section. In most other file formats, debugging symbol-tableentries are interleaved with linkage symbols, and are visible in the--symsoutput.

Start displaying data at the specified address. This affects the outputof the-d,-rand-soptions.

Stop displaying data at the specified address. This affects the outputof the-d,-rand-soptions.

Symbol Table. Print the symbol table entries of the file.This is similar to the information provided by the `nm' program.

Dynamic Symbol Table. Print the dynamic symbol table entries of thefile. This is only meaningful for dynamic objects, such as certaintypes of shared libraries. This is similar to the informationprovided by the `nm' program when given the-D (--dynamic)option.

Print the version number ofobjdumpand exit.

Display all available header information, including the symbol table andrelocation entries. Using `-x' is equivalent to specifying all of`-a -f -h -r -t'.



`binutils'entry in info; The GNU Binary Utilities, Roland H. Pesch (October 1991); nm(1).



Copyright (c) 1991, 92, 93, 94, 95, 1996 Free Software Foundation, Inc.

Permission is granted to make and distribute verbatim copies ofthis manual provided the copyright notice and this permission noticeare preserved on all copies.

Permission is granted to copy and distribute modified versions of thismanual under the conditions for verbatim copying, provided that theentire resulting derived work is distributed under the terms of apermission notice identical to this one.

Permission is granted to copy and distribute translations of thismanual into another language, under the above conditions for modifiedversions, except that this permission notice may be included intranslations approved by the Free Software Foundation instead of inthe original English.




This document was created byman2html,using the manual pages.