Initial revision
This commit is contained in:
parent
503b93500b
commit
19450a0c52
|
@ -0,0 +1,218 @@
|
|||
.\" Copyright (c) 1991 Free Software Foundation
|
||||
.\" See section COPYING for conditions for redistribution
|
||||
.\" $Id$
|
||||
.TH objdump 1 "5 November 1991" "cygnus support" "GNU Development Tools"
|
||||
.de BP
|
||||
.sp
|
||||
.ti \-.2i
|
||||
\(**
|
||||
..
|
||||
|
||||
.SH NAME
|
||||
objdump\(em\&display information from object files.
|
||||
|
||||
.SH SYNOPSIS
|
||||
.hy 0
|
||||
.na
|
||||
.TP
|
||||
.B objdump
|
||||
.RB "[\|" \-a "\|]"
|
||||
.RB "[\|" "\-b\ "\c
|
||||
.I bfdname\c
|
||||
\&\|]
|
||||
.RB "[\|" \-d "\|]"
|
||||
.RB "[\|" \-f "\|]"
|
||||
.RB "[\|" \-h | +header "\|]"
|
||||
.RB "[\|" \-i "\|]"
|
||||
.RB "[\|" "\-j\ "\c
|
||||
.I section\c
|
||||
\&\|]
|
||||
.RB "[\|" \-l "\|]"
|
||||
.RB "[\|" "\-m\ "\c
|
||||
.I machine\c
|
||||
\&\|]
|
||||
.RB "[\|" \-r | +reloc "\|]"
|
||||
.RB "[\|" \-s "\|]"
|
||||
.RB "[\|" \-t | +syms "\|]"
|
||||
.RB "[\|" \-x "\|]"
|
||||
.I objfiles\c
|
||||
\&.\|.\|.
|
||||
.ad b
|
||||
.hy 1
|
||||
.SH DESCRIPTION
|
||||
\c
|
||||
.B objdump\c
|
||||
\& displays information about one or more object files.
|
||||
The options control what particular information to display. This
|
||||
information is mostly useful to programmers who are working on the
|
||||
compilation tools, as opposed to programmers who just want their
|
||||
program to compile and work.
|
||||
.SH OPTIONS
|
||||
Where long and short forms of an option are shown together, they are
|
||||
equivalent.
|
||||
|
||||
.TP
|
||||
.IR "objfiles" .\|.\|.
|
||||
The object files to be examined. When you specify archives,
|
||||
\c
|
||||
.B objdump\c
|
||||
\& shows information on each of the member object files.
|
||||
|
||||
.TP
|
||||
.B \-a
|
||||
If any files from \c
|
||||
.I objfiles\c
|
||||
\& are archives, display the archive
|
||||
header information (in a format similar to `\|\c
|
||||
.B ls \-l\c
|
||||
\|'). Besides the
|
||||
information you could list with `\|\c
|
||||
.B ar tv\c
|
||||
\|', `\|\c
|
||||
.B objdump \-a\c
|
||||
\|' shows
|
||||
the object file format of each archive member.
|
||||
|
||||
.TP
|
||||
.BI "-b " "bfdname"\c
|
||||
\&
|
||||
You can specify a particular object-code format for your object files as
|
||||
\c
|
||||
.I bfdname\c
|
||||
\&. This may not be necessary; \c
|
||||
.I objdump\c
|
||||
\& can
|
||||
automatically recognize many formats. For example,
|
||||
.sp
|
||||
.br
|
||||
objdump\ \-b\ oasys\ \-m\ vax\ \-h\ fu.o
|
||||
.br
|
||||
.sp
|
||||
|
||||
Displays summary information from the section headers (`\|\c
|
||||
.B \-h\c
|
||||
\|') of
|
||||
`\|\c
|
||||
.B fu.o\c
|
||||
\|', which is explicitly identified (`\|\c
|
||||
.B \-m\c
|
||||
\|') as a Vax object
|
||||
file in the format produced by Oasys compilers. You can list the
|
||||
formats available with the `\|\c
|
||||
.B \-i\c
|
||||
\|' option.
|
||||
|
||||
.TP
|
||||
.B \-d
|
||||
Disassemble. Display the assembler mnemonics for the machine
|
||||
instructions from \c
|
||||
.I objfiles\c
|
||||
\&.
|
||||
|
||||
.TP
|
||||
.B \-f
|
||||
File header. Display summary information from the overall header of
|
||||
each file in \c
|
||||
.I objfiles\c
|
||||
\&.
|
||||
|
||||
.TP
|
||||
.B \-h
|
||||
.TP
|
||||
.B +header
|
||||
Header. Display summary information from the section headers of the
|
||||
object file.
|
||||
|
||||
.TP
|
||||
.B \-i
|
||||
Display a list showing all architectures and object formats available
|
||||
for specification with \c
|
||||
.B \-b\c
|
||||
\& or \c
|
||||
.B \-m\c
|
||||
\&.
|
||||
|
||||
.TP
|
||||
.BI "-j " "name"\c
|
||||
\&
|
||||
Display information only for section \c
|
||||
.I name\c
|
||||
\&
|
||||
|
||||
.TP
|
||||
.B \-l
|
||||
Label the display (using debugging information) with the source filename
|
||||
and line numbers corresponding to the object code shown.
|
||||
|
||||
.TP
|
||||
.BI "-m " "machine"\c
|
||||
\&
|
||||
Specify the object files \c
|
||||
.I objfiles\c
|
||||
\& are for architecture
|
||||
\c
|
||||
.I machine\c
|
||||
\&. You can list available architectures using the `\|\c
|
||||
.B \-i\c
|
||||
\|'
|
||||
option.
|
||||
|
||||
.TP
|
||||
.B \-r
|
||||
.TP
|
||||
.B +reloc
|
||||
Relocation. Print the relocation entries of the file.
|
||||
|
||||
.TP
|
||||
.B \-s
|
||||
Display the full contents of any sections requested.
|
||||
|
||||
.TP
|
||||
.B \-t
|
||||
.TP
|
||||
.B +syms
|
||||
Symbol Table. Print the symbol table entries of the file.
|
||||
This is similar to the information provided by the `\|\c
|
||||
.B nm\c
|
||||
\|' program.
|
||||
|
||||
.TP
|
||||
.B \-x
|
||||
Display all available header information, including the symbol table and
|
||||
relocation entries. Using `\|\c
|
||||
.B \-x\c
|
||||
\|' is equivalent to specifying all of
|
||||
`\|\c
|
||||
.B \-a \-f \-h \-r \-t\c
|
||||
\|'.
|
||||
|
||||
.PP
|
||||
|
||||
.SH "SEE ALSO"
|
||||
.RB "`\|" binutils "\|'"
|
||||
entry in
|
||||
.B
|
||||
info\c
|
||||
\&;
|
||||
.I
|
||||
The GNU Binary Utilities\c
|
||||
\&, Roland H. Pesch (October 1991);
|
||||
.BR nm "(" 1 ")."
|
||||
|
||||
.SH COPYING
|
||||
Copyright (c) 1991 Free Software Foundation, Inc.
|
||||
.PP
|
||||
Permission is granted to make and distribute verbatim copies of
|
||||
this manual provided the copyright notice and this permission notice
|
||||
are preserved on all copies.
|
||||
.PP
|
||||
Permission is granted to copy and distribute modified versions of this
|
||||
manual under the conditions for verbatim copying, provided that the
|
||||
entire resulting derived work is distributed under the terms of a
|
||||
permission notice identical to this one.
|
||||
.PP
|
||||
Permission is granted to copy and distribute translations of this
|
||||
manual into another language, under the above conditions for modified
|
||||
versions, except that this permission notice may be included in
|
||||
translations approved by the Free Software Foundation instead of in
|
||||
the original English.
|
Loading…
Reference in New Issue