Initial revision

diff --git a/binutils/objdump.1 b/binutils/objdump.1
new file mode 100644 (file)
index 0000000..63d1678
--- /dev/null
+++ b/binutils/objdump.1
@@ -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.