Add command line switches to objcopy to provide lists of symbols in files
This commit is contained in:
Nick Clifton
parent
5ea2a32c88
commit
16b2b71c0c
@ -1,3 +1,12 @@
|
||||
2001-05-30 Honda Hiroki <hhonda@kobe-catv.ne.jp>
|
||||
|
||||
* objcopy.c: Add new switches: --keep-global-symbol,
|
||||
--keep-symbols, --localize-symbols, --keep-global-symbols and
|
||||
--weaken-symbols.
|
||||
* binutils.texi: Document new switches.
|
||||
* objcopy.1: Regenerate.
|
||||
* NEWS: Announce new feature.
|
||||
|
||||
2001-05-28 Andreas Jaeger <aj@suse.de>
|
||||
|
||||
* readelf.c (display_debug_frames): Fix warnings: Remove unused
|
||||
|
||||
@ -1,5 +1,9 @@
|
||||
-*- text -*-
|
||||
|
||||
* New command line switches added to objcopy to allow symbols to be kept as
|
||||
global symbols, and also to specify files containing lists of such symbols.
|
||||
by Honda Hiroki.
|
||||
|
||||
* Support for OpenRISC by Johan Rydberg.
|
||||
|
||||
* New command line switch to objcopy -B (or --binary-architecture) which sets
|
||||
|
||||
@ -1,12 +1,9 @@
|
||||
.rn '' }`
|
||||
''' $RCSfile$$Revision$$Date$
|
||||
'''
|
||||
''' $Log$
|
||||
''' Revision 1.5 2001/03/25 20:32:25 nickc
|
||||
''' Automate generate on man pages
|
||||
'''
|
||||
'''
|
||||
.de Sh
|
||||
.\" Automatically generated by Pod::Man version 1.02
|
||||
.\" Wed May 30 12:24:26 2001
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ======================================================================
|
||||
.de Sh \" Subsection heading
|
||||
.br
|
||||
.if t .Sp
|
||||
.ne 5
|
||||
@ -14,149 +11,105 @@
|
||||
\fB\\$1\fR
|
||||
.PP
|
||||
..
|
||||
.de Sp
|
||||
.de Sp \" Vertical space (when we can't use .PP)
|
||||
.if t .sp .5v
|
||||
.if n .sp
|
||||
..
|
||||
.de Ip
|
||||
.de Ip \" List item
|
||||
.br
|
||||
.ie \\n(.$>=3 .ne \\$3
|
||||
.el .ne 3
|
||||
.IP "\\$1" \\$2
|
||||
..
|
||||
.de Vb
|
||||
.de Vb \" Begin verbatim text
|
||||
.ft CW
|
||||
.nf
|
||||
.ne \\$1
|
||||
..
|
||||
.de Ve
|
||||
.de Ve \" End verbatim text
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
'''
|
||||
'''
|
||||
''' Set up \*(-- to give an unbreakable dash;
|
||||
''' string Tr holds user defined translation string.
|
||||
''' Bell System Logo is used as a dummy character.
|
||||
'''
|
||||
.\" Set up some character translations and predefined strings. \*(-- will
|
||||
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
||||
.\" double quote, and \*(R" will give a right double quote. | will give a
|
||||
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
|
||||
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
|
||||
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
|
||||
.tr \(*W-|\(bv\*(Tr
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.ie n \{\
|
||||
.ds -- \(*W-
|
||||
.ds PI pi
|
||||
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
.ds L" ""
|
||||
.ds R" ""
|
||||
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
|
||||
''' \*(L" and \*(R", except that they are used on ".xx" lines,
|
||||
''' such as .IP and .SH, which do another additional levels of
|
||||
''' double-quote interpretation
|
||||
.ds M" """
|
||||
.ds S" """
|
||||
.ds N" """""
|
||||
.ds T" """""
|
||||
.ds L' '
|
||||
.ds R' '
|
||||
.ds M' '
|
||||
.ds S' '
|
||||
.ds N' '
|
||||
.ds T' '
|
||||
. ds -- \(*W-
|
||||
. ds PI pi
|
||||
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
. ds L" ""
|
||||
. ds R" ""
|
||||
. ds C` `
|
||||
. ds C' '
|
||||
'br\}
|
||||
.el\{\
|
||||
.ds -- \(em\|
|
||||
.tr \*(Tr
|
||||
.ds L" ``
|
||||
.ds R" ''
|
||||
.ds M" ``
|
||||
.ds S" ''
|
||||
.ds N" ``
|
||||
.ds T" ''
|
||||
.ds L' `
|
||||
.ds R' '
|
||||
.ds M' `
|
||||
.ds S' '
|
||||
.ds N' `
|
||||
.ds T' '
|
||||
.ds PI \(*p
|
||||
. ds -- \|\(em\|
|
||||
. ds PI \(*p
|
||||
. ds L" ``
|
||||
. ds R" ''
|
||||
'br\}
|
||||
.\" If the F register is turned on, we'll generate
|
||||
.\" index entries out stderr for the following things:
|
||||
.\" TH Title
|
||||
.\" SH Header
|
||||
.\" Sh Subsection
|
||||
.\" Ip Item
|
||||
.\" X<> Xref (embedded
|
||||
.\" Of course, you have to process the output yourself
|
||||
.\" in some meaninful fashion.
|
||||
.if \nF \{
|
||||
.de IX
|
||||
.tm Index:\\$1\t\\n%\t"\\$2"
|
||||
..
|
||||
.nr % 0
|
||||
.rr F
|
||||
.\"
|
||||
.\" If the F register is turned on, we'll generate index entries on stderr
|
||||
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
|
||||
.\" index entries marked with X<> in POD. Of course, you'll have to process
|
||||
.\" the output yourself in some meaningful fashion.
|
||||
.if \nF \{\
|
||||
. de IX
|
||||
. tm Index:\\$1\t\\n%\t"\\$2"
|
||||
. .
|
||||
. nr % 0
|
||||
. rr F
|
||||
.\}
|
||||
.TH ADDR2LINE.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
|
||||
.UC
|
||||
.if n .hy 0
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.de CQ \" put $1 in typewriter font
|
||||
.ft CW
|
||||
'if n "\c
|
||||
'if t \\&\\$1\c
|
||||
'if n \\&\\$1\c
|
||||
'if n \&"
|
||||
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
|
||||
'.ft R
|
||||
..
|
||||
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
|
||||
. \" AM - accent mark definitions
|
||||
.\"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it
|
||||
.\" makes way too many mistakes in technical documents.
|
||||
.hy 0
|
||||
.\"
|
||||
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
||||
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
||||
.bd B 3
|
||||
. \" fudge factors for nroff and troff
|
||||
. \" fudge factors for nroff and troff
|
||||
.if n \{\
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
.\}
|
||||
. \" simple accents for nroff and troff
|
||||
. \" simple accents for nroff and troff
|
||||
.if n \{\
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds ? ?
|
||||
. ds ! !
|
||||
. ds /
|
||||
. ds q
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds /
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
|
||||
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
.\}
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
||||
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
||||
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
|
||||
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
|
||||
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
|
||||
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
|
||||
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
||||
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
||||
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
||||
@ -164,138 +117,113 @@
|
||||
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
||||
.ds ae a\h'-(\w'a'u*4/10)'e
|
||||
.ds Ae A\h'-(\w'A'u*4/10)'E
|
||||
.ds oe o\h'-(\w'o'u*4/10)'e
|
||||
.ds Oe O\h'-(\w'O'u*4/10)'E
|
||||
. \" corrections for vroff
|
||||
. \" corrections for vroff
|
||||
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
||||
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
.if \n(.H>23 .if \n(.V>19 \
|
||||
\{\
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds v \h'-1'\o'\(aa\(ga'
|
||||
. ds _ \h'-1'^
|
||||
. ds . \h'-1'.
|
||||
. ds 3 3
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
. ds oe oe
|
||||
. ds Oe OE
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
.\}
|
||||
.rm #[ #] #H #V #F C
|
||||
.\" ======================================================================
|
||||
.\"
|
||||
.IX Title "ADDR2LINE.1 1"
|
||||
.TH ADDR2LINE.1 1 "binutils-2.11.90" "2001-05-30" "GNU"
|
||||
.UC
|
||||
.SH "NAME"
|
||||
addr2line \- convert addresses into file names and line numbers.
|
||||
.SH "SYNOPSIS"
|
||||
addr2line [ \-b \fIbfdname\fR | --target=\fIbfdname\fR ]
|
||||
[ \-C | --demangle[=\fIstyle\fR ]
|
||||
[ \-e \fIfilename\fR | --exe=\fIfilename\fR ]
|
||||
[ \-f | --functions ] [ \-s | --basename ]
|
||||
[ \-H | --help ] [ \-V | --version ]
|
||||
.IX Header "SYNOPSIS"
|
||||
addr2line [ \-b \fIbfdname\fR | \-\-target=\fIbfdname\fR ]
|
||||
[ \-C | \-\-demangle[=\fIstyle\fR ]
|
||||
[ \-e \fIfilename\fR | \-\-exe=\fIfilename\fR ]
|
||||
[ \-f | \-\-functions ] [ \-s | \-\-basename ]
|
||||
[ \-H | \-\-help ] [ \-V | \-\-version ]
|
||||
[ addr addr ... ]
|
||||
.SH "DESCRIPTION"
|
||||
\f(CWaddr2line\fR translates program addresses into file names and line
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\f(CW\*(C`addr2line\*(C'\fR translates program addresses into file names and line
|
||||
numbers. Given an address and an executable, it uses the debugging
|
||||
information in the executable to figure out which file name and line
|
||||
number are associated with a given address.
|
||||
.PP
|
||||
The executable to use is specified with the \f(CW-e\fR option. The
|
||||
The executable to use is specified with the \f(CW\*(C`\-e\*(C'\fR option. The
|
||||
default is the file \fIa.out\fR.
|
||||
.PP
|
||||
\f(CWaddr2line\fR has two modes of operation.
|
||||
\&\f(CW\*(C`addr2line\*(C'\fR has two modes of operation.
|
||||
.PP
|
||||
In the first, hexadecimal addresses are specified on the command line,
|
||||
and \f(CWaddr2line\fR displays the file name and line number for each
|
||||
and \f(CW\*(C`addr2line\*(C'\fR displays the file name and line number for each
|
||||
address.
|
||||
.PP
|
||||
In the second, \f(CWaddr2line\fR reads hexadecimal addresses from
|
||||
In the second, \f(CW\*(C`addr2line\*(C'\fR reads hexadecimal addresses from
|
||||
standard input, and prints the file name and line number for each
|
||||
address on standard output. In this mode, \f(CWaddr2line\fR may be used
|
||||
address on standard output. In this mode, \f(CW\*(C`addr2line\*(C'\fR may be used
|
||||
in a pipe to convert dynamically chosen addresses.
|
||||
.PP
|
||||
The format of the output is \fBFILENAME:LINENO\fR. The file name and
|
||||
The format of the output is \fB\s-1FILENAME:LINENO\s0\fR. The file name and
|
||||
line number for each address is printed on a separate line. If the
|
||||
\f(CW-f\fR option is used, then each \fBFILENAME:LINENO\fR line is
|
||||
preceded by a \fBFUNCTIONNAME\fR line which is the name of the function
|
||||
\&\f(CW\*(C`\-f\*(C'\fR option is used, then each \fB\s-1FILENAME:LINENO\s0\fR line is
|
||||
preceded by a \fB\s-1FUNCTIONNAME\s0\fR line which is the name of the function
|
||||
containing the address.
|
||||
.PP
|
||||
If the file name or function name can not be determined,
|
||||
\f(CWaddr2line\fR will print two question marks in their place. If the
|
||||
line number can not be determined, \f(CWaddr2line\fR will print 0.
|
||||
\&\f(CW\*(C`addr2line\*(C'\fR will print two question marks in their place. If the
|
||||
line number can not be determined, \f(CW\*(C`addr2line\*(C'\fR will print 0.
|
||||
.SH "OPTIONS"
|
||||
.IX Header "OPTIONS"
|
||||
The long and short forms of options, shown here as alternatives, are
|
||||
equivalent.
|
||||
.Ip "\f(CW-b \fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW--target=\fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-b \f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-b bfdname"
|
||||
.Ip "\f(CW\*(C`\-\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--target=bfdname"
|
||||
Specify that the object-code format for the object files is
|
||||
\fIbfdname\fR.
|
||||
.Ip "\f(CW-C\fR" 4
|
||||
.Ip "\f(CW--demangle[=\fIstyle\fR]\fR" 4
|
||||
\&\fIbfdname\fR.
|
||||
.Ip "\f(CW\*(C`\-C\*(C'\fR" 4
|
||||
.IX Item "-C"
|
||||
.Ip "\f(CW\*(C`\-\-demangle[=\f(CIstyle\f(CW]\*(C'\fR" 4
|
||||
.IX Item "--demangle[=style]"
|
||||
Decode (\fIdemangle\fR) low-level symbol names into user-level names.
|
||||
Besides removing any initial underscore prepended by the system, this
|
||||
makes \*(C+ function names readable. Different compilers have different
|
||||
mangling styles. The optional demangling style argument can be used to
|
||||
choose an appropriate demangling style for your compiler.
|
||||
.Ip "\f(CW-e \fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW--exe=\fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-e \f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "-e filename"
|
||||
.Ip "\f(CW\*(C`\-\-exe=\f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "--exe=filename"
|
||||
Specify the name of the executable for which addresses should be
|
||||
translated. The default file is \fIa.out\fR.
|
||||
.Ip "\f(CW-f\fR" 4
|
||||
.Ip "\f(CW--functions\fR" 4
|
||||
.Ip "\f(CW\*(C`\-f\*(C'\fR" 4
|
||||
.IX Item "-f"
|
||||
.Ip "\f(CW\*(C`\-\-functions\*(C'\fR" 4
|
||||
.IX Item "--functions"
|
||||
Display function names as well as file and line number information.
|
||||
.Ip "\f(CW-s\fR" 4
|
||||
.Ip "\f(CW--basenames\fR" 4
|
||||
.Ip "\f(CW\*(C`\-s\*(C'\fR" 4
|
||||
.IX Item "-s"
|
||||
.Ip "\f(CW\*(C`\-\-basenames\*(C'\fR" 4
|
||||
.IX Item "--basenames"
|
||||
Display only the base of each file name.
|
||||
.SH "SEE ALSO"
|
||||
.IX Header "SEE ALSO"
|
||||
Info entries for \fIbinutils\fR.
|
||||
.SH "COPYRIGHT"
|
||||
.IX Header "COPYRIGHT"
|
||||
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
|
||||
.PP
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||||
Back-Cover Texts. A copy of the license is included in the
|
||||
section entitled \*(L"GNU Free Documentation License\*(R".
|
||||
|
||||
.rn }` ''
|
||||
.IX Title "ADDR2LINE.1 1"
|
||||
.IX Name "addr2line - convert addresses into file names and line numbers."
|
||||
|
||||
.IX Header "NAME"
|
||||
|
||||
.IX Header "SYNOPSIS"
|
||||
|
||||
.IX Header "DESCRIPTION"
|
||||
|
||||
.IX Header "OPTIONS"
|
||||
|
||||
.IX Item "\f(CW-b \fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--target=\fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-C\fR"
|
||||
|
||||
.IX Item "\f(CW--demangle[=\fIstyle\fR]\fR"
|
||||
|
||||
.IX Item "\f(CW-e \fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--exe=\fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-f\fR"
|
||||
|
||||
.IX Item "\f(CW--functions\fR"
|
||||
|
||||
.IX Item "\f(CW-s\fR"
|
||||
|
||||
.IX Item "\f(CW--basenames\fR"
|
||||
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
.IX Header "COPYRIGHT"
|
||||
|
||||
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
|
||||
|
||||
451
binutils/ar.1
451
binutils/ar.1
@ -1,12 +1,9 @@
|
||||
.rn '' }`
|
||||
''' $RCSfile$$Revision$$Date$
|
||||
'''
|
||||
''' $Log$
|
||||
''' Revision 1.7 2001/03/25 20:32:25 nickc
|
||||
''' Automate generate on man pages
|
||||
'''
|
||||
'''
|
||||
.de Sh
|
||||
.\" Automatically generated by Pod::Man version 1.02
|
||||
.\" Wed May 30 12:24:26 2001
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ======================================================================
|
||||
.de Sh \" Subsection heading
|
||||
.br
|
||||
.if t .Sp
|
||||
.ne 5
|
||||
@ -14,149 +11,105 @@
|
||||
\fB\\$1\fR
|
||||
.PP
|
||||
..
|
||||
.de Sp
|
||||
.de Sp \" Vertical space (when we can't use .PP)
|
||||
.if t .sp .5v
|
||||
.if n .sp
|
||||
..
|
||||
.de Ip
|
||||
.de Ip \" List item
|
||||
.br
|
||||
.ie \\n(.$>=3 .ne \\$3
|
||||
.el .ne 3
|
||||
.IP "\\$1" \\$2
|
||||
..
|
||||
.de Vb
|
||||
.de Vb \" Begin verbatim text
|
||||
.ft CW
|
||||
.nf
|
||||
.ne \\$1
|
||||
..
|
||||
.de Ve
|
||||
.de Ve \" End verbatim text
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
'''
|
||||
'''
|
||||
''' Set up \*(-- to give an unbreakable dash;
|
||||
''' string Tr holds user defined translation string.
|
||||
''' Bell System Logo is used as a dummy character.
|
||||
'''
|
||||
.\" Set up some character translations and predefined strings. \*(-- will
|
||||
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
||||
.\" double quote, and \*(R" will give a right double quote. | will give a
|
||||
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
|
||||
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
|
||||
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
|
||||
.tr \(*W-|\(bv\*(Tr
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.ie n \{\
|
||||
.ds -- \(*W-
|
||||
.ds PI pi
|
||||
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
.ds L" ""
|
||||
.ds R" ""
|
||||
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
|
||||
''' \*(L" and \*(R", except that they are used on ".xx" lines,
|
||||
''' such as .IP and .SH, which do another additional levels of
|
||||
''' double-quote interpretation
|
||||
.ds M" """
|
||||
.ds S" """
|
||||
.ds N" """""
|
||||
.ds T" """""
|
||||
.ds L' '
|
||||
.ds R' '
|
||||
.ds M' '
|
||||
.ds S' '
|
||||
.ds N' '
|
||||
.ds T' '
|
||||
. ds -- \(*W-
|
||||
. ds PI pi
|
||||
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
. ds L" ""
|
||||
. ds R" ""
|
||||
. ds C` `
|
||||
. ds C' '
|
||||
'br\}
|
||||
.el\{\
|
||||
.ds -- \(em\|
|
||||
.tr \*(Tr
|
||||
.ds L" ``
|
||||
.ds R" ''
|
||||
.ds M" ``
|
||||
.ds S" ''
|
||||
.ds N" ``
|
||||
.ds T" ''
|
||||
.ds L' `
|
||||
.ds R' '
|
||||
.ds M' `
|
||||
.ds S' '
|
||||
.ds N' `
|
||||
.ds T' '
|
||||
.ds PI \(*p
|
||||
. ds -- \|\(em\|
|
||||
. ds PI \(*p
|
||||
. ds L" ``
|
||||
. ds R" ''
|
||||
'br\}
|
||||
.\" If the F register is turned on, we'll generate
|
||||
.\" index entries out stderr for the following things:
|
||||
.\" TH Title
|
||||
.\" SH Header
|
||||
.\" Sh Subsection
|
||||
.\" Ip Item
|
||||
.\" X<> Xref (embedded
|
||||
.\" Of course, you have to process the output yourself
|
||||
.\" in some meaninful fashion.
|
||||
.if \nF \{
|
||||
.de IX
|
||||
.tm Index:\\$1\t\\n%\t"\\$2"
|
||||
..
|
||||
.nr % 0
|
||||
.rr F
|
||||
.\"
|
||||
.\" If the F register is turned on, we'll generate index entries on stderr
|
||||
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
|
||||
.\" index entries marked with X<> in POD. Of course, you'll have to process
|
||||
.\" the output yourself in some meaningful fashion.
|
||||
.if \nF \{\
|
||||
. de IX
|
||||
. tm Index:\\$1\t\\n%\t"\\$2"
|
||||
. .
|
||||
. nr % 0
|
||||
. rr F
|
||||
.\}
|
||||
.TH AR.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
|
||||
.UC
|
||||
.if n .hy 0
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.de CQ \" put $1 in typewriter font
|
||||
.ft CW
|
||||
'if n "\c
|
||||
'if t \\&\\$1\c
|
||||
'if n \\&\\$1\c
|
||||
'if n \&"
|
||||
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
|
||||
'.ft R
|
||||
..
|
||||
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
|
||||
. \" AM - accent mark definitions
|
||||
.\"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it
|
||||
.\" makes way too many mistakes in technical documents.
|
||||
.hy 0
|
||||
.\"
|
||||
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
||||
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
||||
.bd B 3
|
||||
. \" fudge factors for nroff and troff
|
||||
. \" fudge factors for nroff and troff
|
||||
.if n \{\
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
.\}
|
||||
. \" simple accents for nroff and troff
|
||||
. \" simple accents for nroff and troff
|
||||
.if n \{\
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds ? ?
|
||||
. ds ! !
|
||||
. ds /
|
||||
. ds q
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds /
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
|
||||
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
.\}
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
||||
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
||||
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
|
||||
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
|
||||
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
|
||||
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
|
||||
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
||||
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
||||
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
||||
@ -164,76 +117,76 @@
|
||||
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
||||
.ds ae a\h'-(\w'a'u*4/10)'e
|
||||
.ds Ae A\h'-(\w'A'u*4/10)'E
|
||||
.ds oe o\h'-(\w'o'u*4/10)'e
|
||||
.ds Oe O\h'-(\w'O'u*4/10)'E
|
||||
. \" corrections for vroff
|
||||
. \" corrections for vroff
|
||||
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
||||
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
.if \n(.H>23 .if \n(.V>19 \
|
||||
\{\
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds v \h'-1'\o'\(aa\(ga'
|
||||
. ds _ \h'-1'^
|
||||
. ds . \h'-1'.
|
||||
. ds 3 3
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
. ds oe oe
|
||||
. ds Oe OE
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
.\}
|
||||
.rm #[ #] #H #V #F C
|
||||
.\" ======================================================================
|
||||
.\"
|
||||
.IX Title "AR.1 1"
|
||||
.TH AR.1 1 "binutils-2.11.90" "2001-05-30" "GNU"
|
||||
.UC
|
||||
.SH "NAME"
|
||||
ar \- create, modify, and extract from archives
|
||||
.SH "SYNOPSIS"
|
||||
.IX Header "SYNOPSIS"
|
||||
ar [\-X32_64] [\-]\fIp\fR[\fImod\fR [\fIrelpos\fR] [\fIcount\fR]] \fIarchive\fR [\fImember\fR...]
|
||||
.SH "DESCRIPTION"
|
||||
The GNU \f(CWar\fR program creates, modifies, and extracts from
|
||||
.IX Header "DESCRIPTION"
|
||||
The \s-1GNU\s0 \f(CW\*(C`ar\*(C'\fR program creates, modifies, and extracts from
|
||||
archives. An \fIarchive\fR is a single file holding a collection of
|
||||
other files in a structure that makes it possible to retrieve
|
||||
the original individual files (called \fImembers\fR of the archive).
|
||||
.PP
|
||||
The original files\*(R' contents, mode (permissions), timestamp, owner, and
|
||||
The original files' contents, mode (permissions), timestamp, owner, and
|
||||
group are preserved in the archive, and can be restored on
|
||||
extraction.
|
||||
.PP
|
||||
GNU \f(CWar\fR can maintain archives whose members have names of any
|
||||
length; however, depending on how \f(CWar\fR is configured on your
|
||||
\&\s-1GNU\s0 \f(CW\*(C`ar\*(C'\fR can maintain archives whose members have names of any
|
||||
length; however, depending on how \f(CW\*(C`ar\*(C'\fR is configured on your
|
||||
system, a limit on member-name length may be imposed for compatibility
|
||||
with archive formats maintained with other tools. If it exists, the
|
||||
limit is often 15 characters (typical of formats related to a.out) or 16
|
||||
characters (typical of formats related to coff).
|
||||
.PP
|
||||
\f(CWar\fR is considered a binary utility because archives of this sort
|
||||
\&\f(CW\*(C`ar\*(C'\fR is considered a binary utility because archives of this sort
|
||||
are most often used as \fIlibraries\fR holding commonly needed
|
||||
subroutines.
|
||||
.PP
|
||||
\f(CWar\fR creates an index to the symbols defined in relocatable
|
||||
\&\f(CW\*(C`ar\*(C'\fR creates an index to the symbols defined in relocatable
|
||||
object modules in the archive when you specify the modifier \fBs\fR.
|
||||
Once created, this index is updated in the archive whenever \f(CWar\fR
|
||||
Once created, this index is updated in the archive whenever \f(CW\*(C`ar\*(C'\fR
|
||||
makes a change to its contents (save for the \fBq\fR update operation).
|
||||
An archive with such an index speeds up linking to the library, and
|
||||
allows routines in the library to call each other without regard to
|
||||
their placement in the archive.
|
||||
.PP
|
||||
You may use \fBnm \-s\fR or \fBnm --print-armap\fR to list this index
|
||||
table. If an archive lacks the table, another form of \f(CWar\fR called
|
||||
\f(CWranlib\fR can be used to add just the table.
|
||||
You may use \fBnm \-s\fR or \fBnm \-\-print-armap\fR to list this index
|
||||
table. If an archive lacks the table, another form of \f(CW\*(C`ar\*(C'\fR called
|
||||
\&\f(CW\*(C`ranlib\*(C'\fR can be used to add just the table.
|
||||
.PP
|
||||
GNU \f(CWar\fR is designed to be compatible with two different
|
||||
\&\s-1GNU\s0 \f(CW\*(C`ar\*(C'\fR is designed to be compatible with two different
|
||||
facilities. You can control its activity using command-line options,
|
||||
like the different varieties of \f(CWar\fR on Unix systems; or, if you
|
||||
like the different varieties of \f(CW\*(C`ar\*(C'\fR on Unix systems; or, if you
|
||||
specify the single command-line option \fB\-M\fR, you can control it
|
||||
with a script supplied via standard input, like the MRI ``librarian'\*(R'
|
||||
with a script supplied via standard input, like the \s-1MRI\s0 ``librarian''
|
||||
program.
|
||||
.SH "OPTIONS"
|
||||
GNU \f(CWar\fR allows you to mix the operation code \fIp\fR and modifier
|
||||
.IX Header "OPTIONS"
|
||||
\&\s-1GNU\s0 \f(CW\*(C`ar\*(C'\fR allows you to mix the operation code \fIp\fR and modifier
|
||||
flags \fImod\fR in any order, within the first command-line argument.
|
||||
.PP
|
||||
If you wish, you may begin the first command-line argument with a
|
||||
@ -241,53 +194,58 @@ dash.
|
||||
.PP
|
||||
The \fIp\fR keyletter specifies what operation to execute; it may be
|
||||
any of the following, but you must specify only one of them:
|
||||
.Ip "\f(CWd\fR" 4
|
||||
\fIDelete\fR modules from the archive. Specify the names of modules to
|
||||
.Ip "\f(CW\*(C`d\*(C'\fR" 4
|
||||
.IX Item "d"
|
||||
\&\fIDelete\fR modules from the archive. Specify the names of modules to
|
||||
be deleted as \fImember\fR...; the archive is untouched if you
|
||||
specify no files to delete.
|
||||
.Sp
|
||||
If you specify the \fBv\fR modifier, \f(CWar\fR lists each module
|
||||
If you specify the \fBv\fR modifier, \f(CW\*(C`ar\*(C'\fR lists each module
|
||||
as it is deleted.
|
||||
.Ip "\f(CWm\fR" 4
|
||||
.Ip "\f(CW\*(C`m\*(C'\fR" 4
|
||||
.IX Item "m"
|
||||
Use this operation to \fImove\fR members in an archive.
|
||||
.Sp
|
||||
The ordering of members in an archive can make a difference in how
|
||||
programs are linked using the library, if a symbol is defined in more
|
||||
than one member.
|
||||
.Sp
|
||||
If no modifiers are used with \f(CWm\fR, any members you name in the
|
||||
\fImember\fR arguments are moved to the \fIend\fR of the archive;
|
||||
If no modifiers are used with \f(CW\*(C`m\*(C'\fR, any members you name in the
|
||||
\&\fImember\fR arguments are moved to the \fIend\fR of the archive;
|
||||
you can use the \fBa\fR, \fBb\fR, or \fBi\fR modifiers to move them to a
|
||||
specified place instead.
|
||||
.Ip "\f(CWp\fR" 4
|
||||
\fIPrint\fR the specified members of the archive, to the standard
|
||||
.Ip "\f(CW\*(C`p\*(C'\fR" 4
|
||||
.IX Item "p"
|
||||
\&\fIPrint\fR the specified members of the archive, to the standard
|
||||
output file. If the \fBv\fR modifier is specified, show the member
|
||||
name before copying its contents to standard output.
|
||||
.Sp
|
||||
If you specify no \fImember\fR arguments, all the files in the archive are
|
||||
printed.
|
||||
.Ip "\f(CWq\fR" 4
|
||||
\fIQuick append\fR; Historically, add the files \fImember\fR... to the end of
|
||||
\fIarchive\fR, without checking for replacement.
|
||||
.Ip "\f(CW\*(C`q\*(C'\fR" 4
|
||||
.IX Item "q"
|
||||
\&\fIQuick append\fR; Historically, add the files \fImember\fR... to the end of
|
||||
\&\fIarchive\fR, without checking for replacement.
|
||||
.Sp
|
||||
The modifiers \fBa\fR, \fBb\fR, and \fBi\fR do \fInot\fR affect this
|
||||
operation; new members are always placed at the end of the archive.
|
||||
.Sp
|
||||
The modifier \fBv\fR makes \f(CWar\fR list each file as it is appended.
|
||||
The modifier \fBv\fR makes \f(CW\*(C`ar\*(C'\fR list each file as it is appended.
|
||||
.Sp
|
||||
Since the point of this operation is speed, the archive's symbol table
|
||||
index is not updated, even if it already existed; you can use \fBar s\fR or
|
||||
\f(CWranlib\fR explicitly to update the symbol table index.
|
||||
\&\f(CW\*(C`ranlib\*(C'\fR explicitly to update the symbol table index.
|
||||
.Sp
|
||||
However, too many different systems assume quick append rebuilds the
|
||||
index, so \s-1GNU\s0 ar implements \f(CWq\fR as a synonym for \f(CWr\fR.
|
||||
.Ip "\f(CWr\fR" 4
|
||||
index, so \s-1GNU\s0 ar implements \f(CW\*(C`q\*(C'\fR as a synonym for \f(CW\*(C`r\*(C'\fR.
|
||||
.Ip "\f(CW\*(C`r\*(C'\fR" 4
|
||||
.IX Item "r"
|
||||
Insert the files \fImember\fR... into \fIarchive\fR (with
|
||||
\fIreplacement\fR). This operation differs from \fBq\fR in that any
|
||||
\&\fIreplacement\fR). This operation differs from \fBq\fR in that any
|
||||
previously existing members are deleted if their names match those being
|
||||
added.
|
||||
.Sp
|
||||
If one of the files named in \fImember\fR... does not exist, \f(CWar\fR
|
||||
If one of the files named in \fImember\fR... does not exist, \f(CW\*(C`ar\*(C'\fR
|
||||
displays an error message, and leaves undisturbed any existing members
|
||||
of the archive matching that name.
|
||||
.Sp
|
||||
@ -297,9 +255,10 @@ placement relative to some existing member.
|
||||
.Sp
|
||||
The modifier \fBv\fR used with this operation elicits a line of
|
||||
output for each file inserted, along with one of the letters \fBa\fR or
|
||||
\fBr\fR to indicate whether the file was appended (no old member
|
||||
\&\fBr\fR to indicate whether the file was appended (no old member
|
||||
deleted) or replaced.
|
||||
.Ip "\f(CWt\fR" 4
|
||||
.Ip "\f(CW\*(C`t\*(C'\fR" 4
|
||||
.IX Item "t"
|
||||
Display a \fItable\fR listing the contents of \fIarchive\fR, or those
|
||||
of the files listed in \fImember\fR... that are present in the
|
||||
archive. Normally only the member name is shown; if you also want to
|
||||
@ -312,72 +271,85 @@ are listed.
|
||||
If there is more than one file with the same name (say, \fBfie\fR) in
|
||||
an archive (say \fBb.a\fR), \fBar t b.a fie\fR lists only the
|
||||
first instance; to see them all, you must ask for a complete
|
||||
listing---in our example, \fBar t b.a\fR.
|
||||
.Ip "\f(CWx\fR" 4
|
||||
\fIExtract\fR members (named \fImember\fR) from the archive. You can
|
||||
listing\-\-\-in our example, \fBar t b.a\fR.
|
||||
.Ip "\f(CW\*(C`x\*(C'\fR" 4
|
||||
.IX Item "x"
|
||||
\&\fIExtract\fR members (named \fImember\fR) from the archive. You can
|
||||
use the \fBv\fR modifier with this operation, to request that
|
||||
\f(CWar\fR list each name as it extracts it.
|
||||
\&\f(CW\*(C`ar\*(C'\fR list each name as it extracts it.
|
||||
.Sp
|
||||
If you do not specify a \fImember\fR, all files in the archive
|
||||
are extracted.
|
||||
.PP
|
||||
A number of modifiers (\fImod\fR) may immediately follow the \fIp\fR
|
||||
keyletter, to specify variations on an operation's behavior:
|
||||
.Ip "\f(CWa\fR" 4
|
||||
.Ip "\f(CW\*(C`a\*(C'\fR" 4
|
||||
.IX Item "a"
|
||||
Add new files \fIafter\fR an existing member of the
|
||||
archive. If you use the modifier \fBa\fR, the name of an existing archive
|
||||
member must be present as the \fIrelpos\fR argument, before the
|
||||
\fIarchive\fR specification.
|
||||
.Ip "\f(CWb\fR" 4
|
||||
\&\fIarchive\fR specification.
|
||||
.Ip "\f(CW\*(C`b\*(C'\fR" 4
|
||||
.IX Item "b"
|
||||
Add new files \fIbefore\fR an existing member of the
|
||||
archive. If you use the modifier \fBb\fR, the name of an existing archive
|
||||
member must be present as the \fIrelpos\fR argument, before the
|
||||
\fIarchive\fR specification. (same as \fBi\fR).
|
||||
.Ip "\f(CWc\fR" 4
|
||||
\fICreate\fR the archive. The specified \fIarchive\fR is always
|
||||
\&\fIarchive\fR specification. (same as \fBi\fR).
|
||||
.Ip "\f(CW\*(C`c\*(C'\fR" 4
|
||||
.IX Item "c"
|
||||
\&\fICreate\fR the archive. The specified \fIarchive\fR is always
|
||||
created if it did not exist, when you request an update. But a warning is
|
||||
issued unless you specify in advance that you expect to create it, by
|
||||
using this modifier.
|
||||
.Ip "\f(CWf\fR" 4
|
||||
Truncate names in the archive. \s-1GNU\s0 \f(CWar\fR will normally permit file
|
||||
.Ip "\f(CW\*(C`f\*(C'\fR" 4
|
||||
.IX Item "f"
|
||||
Truncate names in the archive. \s-1GNU\s0 \f(CW\*(C`ar\*(C'\fR will normally permit file
|
||||
names of any length. This will cause it to create archives which are
|
||||
not compatible with the native \f(CWar\fR program on some systems. If
|
||||
not compatible with the native \f(CW\*(C`ar\*(C'\fR program on some systems. If
|
||||
this is a concern, the \fBf\fR modifier may be used to truncate file
|
||||
names when putting them in the archive.
|
||||
.Ip "\f(CWi\fR" 4
|
||||
.Ip "\f(CW\*(C`i\*(C'\fR" 4
|
||||
.IX Item "i"
|
||||
Insert new files \fIbefore\fR an existing member of the
|
||||
archive. If you use the modifier \fBi\fR, the name of an existing archive
|
||||
member must be present as the \fIrelpos\fR argument, before the
|
||||
\fIarchive\fR specification. (same as \fBb\fR).
|
||||
.Ip "\f(CWl\fR" 4
|
||||
\&\fIarchive\fR specification. (same as \fBb\fR).
|
||||
.Ip "\f(CW\*(C`l\*(C'\fR" 4
|
||||
.IX Item "l"
|
||||
This modifier is accepted but not used.
|
||||
.Ip "\f(CWN\fR" 4
|
||||
.Ip "\f(CW\*(C`N\*(C'\fR" 4
|
||||
.IX Item "N"
|
||||
Uses the \fIcount\fR parameter. This is used if there are multiple
|
||||
entries in the archive with the same name. Extract or delete instance
|
||||
\fIcount\fR of the given name from the archive.
|
||||
.Ip "\f(CWo\fR" 4
|
||||
\&\fIcount\fR of the given name from the archive.
|
||||
.Ip "\f(CW\*(C`o\*(C'\fR" 4
|
||||
.IX Item "o"
|
||||
Preserve the \fIoriginal\fR dates of members when extracting them. If
|
||||
you do not specify this modifier, files extracted from the archive
|
||||
are stamped with the time of extraction.
|
||||
.Ip "\f(CWP\fR" 4
|
||||
.Ip "\f(CW\*(C`P\*(C'\fR" 4
|
||||
.IX Item "P"
|
||||
Use the full path name when matching names in the archive. \s-1GNU\s0
|
||||
\f(CWar\fR can not create an archive with a full path name (such archives
|
||||
\&\f(CW\*(C`ar\*(C'\fR can not create an archive with a full path name (such archives
|
||||
are not \s-1POSIX\s0 complaint), but other archive creators can. This option
|
||||
will cause \s-1GNU\s0 \f(CWar\fR to match file names using a complete path
|
||||
will cause \s-1GNU\s0 \f(CW\*(C`ar\*(C'\fR to match file names using a complete path
|
||||
name, which can be convenient when extracting a single file from an
|
||||
archive created by another tool.
|
||||
.Ip "\f(CWs\fR" 4
|
||||
.Ip "\f(CW\*(C`s\*(C'\fR" 4
|
||||
.IX Item "s"
|
||||
Write an object-file index into the archive, or update an existing one,
|
||||
even if no other change is made to the archive. You may use this modifier
|
||||
flag either with any operation, or alone. Running \fBar s\fR on an
|
||||
archive is equivalent to running \fBranlib\fR on it.
|
||||
.Ip "\f(CWS\fR" 4
|
||||
.Ip "\f(CW\*(C`S\*(C'\fR" 4
|
||||
.IX Item "S"
|
||||
Do not generate an archive symbol table. This can speed up building a
|
||||
large library in several steps. The resulting archive can not be used
|
||||
with the linker. In order to build a symbol table, you must omit the
|
||||
\fBS\fR modifier on the last execution of \fBar\fR, or you must run
|
||||
\fBranlib\fR on the archive.
|
||||
.Ip "\f(CWu\fR" 4
|
||||
\&\fBS\fR modifier on the last execution of \fBar\fR, or you must run
|
||||
\&\fBranlib\fR on the archive.
|
||||
.Ip "\f(CW\*(C`u\*(C'\fR" 4
|
||||
.IX Item "u"
|
||||
Normally, \fBar r\fR... inserts all files
|
||||
listed into the archive. If you would like to insert \fIonly\fR those
|
||||
of the files you list that are newer than existing members of the same
|
||||
@ -385,85 +357,30 @@ names, use this modifier. The \fBu\fR modifier is allowed only for the
|
||||
operation \fBr\fR (replace). In particular, the combination \fBqu\fR is
|
||||
not allowed, since checking the timestamps would lose any speed
|
||||
advantage from the operation \fBq\fR.
|
||||
.Ip "\f(CWv\fR" 4
|
||||
.Ip "\f(CW\*(C`v\*(C'\fR" 4
|
||||
.IX Item "v"
|
||||
This modifier requests the \fIverbose\fR version of an operation. Many
|
||||
operations display additional information, such as filenames processed,
|
||||
when the modifier \fBv\fR is appended.
|
||||
.Ip "\f(CWV\fR" 4
|
||||
This modifier shows the version number of \f(CWar\fR.
|
||||
.Ip "\f(CW\*(C`V\*(C'\fR" 4
|
||||
.IX Item "V"
|
||||
This modifier shows the version number of \f(CW\*(C`ar\*(C'\fR.
|
||||
.PP
|
||||
\f(CWar\fR ignores an initial option spelt \f(CW-X32_64\fR, for
|
||||
\&\f(CW\*(C`ar\*(C'\fR ignores an initial option spelt \f(CW\*(C`\-X32_64\*(C'\fR, for
|
||||
compatibility with \s-1AIX\s0. The behaviour produced by this option is the
|
||||
default for \s-1GNU\s0 \f(CWar\fR. \f(CWar\fR does not support any of the other
|
||||
\f(CW-X\fR options; in particular, it does not support \f(CW-X32\fR
|
||||
which is the default for \s-1AIX\s0 \f(CWar\fR.
|
||||
default for \s-1GNU\s0 \f(CW\*(C`ar\*(C'\fR. \f(CW\*(C`ar\*(C'\fR does not support any of the other
|
||||
\&\f(CW\*(C`\-X\*(C'\fR options; in particular, it does not support \f(CW\*(C`\-X32\*(C'\fR
|
||||
which is the default for \s-1AIX\s0 \f(CW\*(C`ar\*(C'\fR.
|
||||
.SH "SEE ALSO"
|
||||
\fInm\fR\|(1), \fIranlib\fR\|(1), and the Info entries for \fIbinutils\fR.
|
||||
.IX Header "SEE ALSO"
|
||||
\&\fInm\fR\|(1), \fIranlib\fR\|(1), and the Info entries for \fIbinutils\fR.
|
||||
.SH "COPYRIGHT"
|
||||
.IX Header "COPYRIGHT"
|
||||
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
|
||||
.PP
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||||
Back-Cover Texts. A copy of the license is included in the
|
||||
section entitled \*(L"GNU Free Documentation License\*(R".
|
||||
|
||||
.rn }` ''
|
||||
.IX Title "AR.1 1"
|
||||
.IX Name "ar - create, modify, and extract from archives"
|
||||
|
||||
.IX Header "NAME"
|
||||
|
||||
.IX Header "SYNOPSIS"
|
||||
|
||||
.IX Header "DESCRIPTION"
|
||||
|
||||
.IX Header "OPTIONS"
|
||||
|
||||
.IX Item "\f(CWd\fR"
|
||||
|
||||
.IX Item "\f(CWm\fR"
|
||||
|
||||
.IX Item "\f(CWp\fR"
|
||||
|
||||
.IX Item "\f(CWq\fR"
|
||||
|
||||
.IX Item "\f(CWr\fR"
|
||||
|
||||
.IX Item "\f(CWt\fR"
|
||||
|
||||
.IX Item "\f(CWx\fR"
|
||||
|
||||
.IX Item "\f(CWa\fR"
|
||||
|
||||
.IX Item "\f(CWb\fR"
|
||||
|
||||
.IX Item "\f(CWc\fR"
|
||||
|
||||
.IX Item "\f(CWf\fR"
|
||||
|
||||
.IX Item "\f(CWi\fR"
|
||||
|
||||
.IX Item "\f(CWl\fR"
|
||||
|
||||
.IX Item "\f(CWN\fR"
|
||||
|
||||
.IX Item "\f(CWo\fR"
|
||||
|
||||
.IX Item "\f(CWP\fR"
|
||||
|
||||
.IX Item "\f(CWs\fR"
|
||||
|
||||
.IX Item "\f(CWS\fR"
|
||||
|
||||
.IX Item "\f(CWu\fR"
|
||||
|
||||
.IX Item "\f(CWv\fR"
|
||||
|
||||
.IX Item "\f(CWV\fR"
|
||||
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
.IX Header "COPYRIGHT"
|
||||
|
||||
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
|
||||
|
||||
@ -923,6 +923,7 @@ objcopy [ -F @var{bfdname} | --target=@var{bfdname} ]
|
||||
[ -S | --strip-all ] [ -g | --strip-debug ]
|
||||
[ -K @var{symbolname} | --keep-symbol=@var{symbolname} ]
|
||||
[ -N @var{symbolname} | --strip-symbol=@var{symbolname} ]
|
||||
[ -G @var{symbolname} | --keep-global-symbol=@var{symbolname}]
|
||||
[ -L @var{symbolname} | --localize-symbol=@var{symbolname} ]
|
||||
[ -W @var{symbolname} | --weaken-symbol=@var{symbolname} ]
|
||||
[ -x | --discard-all ] [ -X | --discard-locals ]
|
||||
@ -943,6 +944,11 @@ objcopy [ -F @var{bfdname} | --target=@var{bfdname} ]
|
||||
[ --change-leading-char ] [ --remove-leading-char ]
|
||||
[ --srec-len=@var{ival} ] [ --srec-forceS3 ]
|
||||
[ --redefine-sym @var{old}=@var{new} ] [ --weaken ]
|
||||
[ --keep-symbols=@var{filename} ]
|
||||
[ --strip-symbols=@var{filename} ]
|
||||
[ --keep-global-symbols=@var{filename} ]
|
||||
[ --localize-symbols=@var{filename} ]
|
||||
[ --weaken-symbols=@var{filename} ]
|
||||
[ -v | --verbose ] [ -V | --version ] [ --help ]
|
||||
@var{infile} [@var{outfile}]
|
||||
@c man end
|
||||
@ -1056,6 +1062,12 @@ be given more than once.
|
||||
Do not copy symbol @var{symbolname} from the source file. This option
|
||||
may be given more than once.
|
||||
|
||||
@item -G @var{symbolname}
|
||||
@itemx --keep-global-symbol=@var{symbolname}
|
||||
Keep only symbol @var{symbolname} global. Make all other symbols local
|
||||
to the file, so that they are not visible externally. This option may
|
||||
be given more than once.
|
||||
|
||||
@item -L @var{symbolname}
|
||||
@itemx --localize-symbol=@var{symbolname}
|
||||
Make symbol @var{symbolname} local to the file, so that it is not
|
||||
@ -1239,6 +1251,36 @@ when building an object which will be linked against other objects using
|
||||
the @code{-R} option to the linker. This option is only effective when
|
||||
using an object file format which supports weak symbols.
|
||||
|
||||
@item --keep-symbols=@var{filename}
|
||||
Apply @samp{--keep-symbol} option to each symbol listed in the file
|
||||
@var{filename}. @var{filename} is simply a flat file, with one symbol
|
||||
name per line. Line comments may be introduced by the hash character.
|
||||
This option may be given more than once.
|
||||
|
||||
@item --strip-symbols=@var{filename}
|
||||
Apply @samp{--strip-symbol} option to each symbol listed in the file
|
||||
@var{filename}. @var{filename} is simply a flat file, with one symbol
|
||||
name per line. Line comments may be introduced by the hash character.
|
||||
This option may be given more than once.
|
||||
|
||||
@item --keep-global-symbols=@var{filename}
|
||||
Apply @samp{--keep-global-symbol} option to each symbol listed in the
|
||||
file @var{filename}. @var{filename} is simply a flat file, with one
|
||||
symbol name per line. Line comments may be introduced by the hash
|
||||
character. This option may be given more than once.
|
||||
|
||||
@item --localize-symbols=@var{filename}
|
||||
Apply @samp{--localize-symbol} option to each symbol listed in the file
|
||||
@var{filename}. @var{filename} is simply a flat file, with one symbol
|
||||
name per line. Line comments may be introduced by the hash character.
|
||||
This option may be given more than once.
|
||||
|
||||
@item --weaken-symbols=@var{filename}
|
||||
Apply @samp{--weaken-symbol} option to each symbol listed in the file
|
||||
@var{filename}. @var{filename} is simply a flat file, with one symbol
|
||||
name per line. Line comments may be introduced by the hash character.
|
||||
This option may be given more than once.
|
||||
|
||||
@item -V
|
||||
@itemx --version
|
||||
Show the version number of @code{objcopy}.
|
||||
|
||||
@ -1,12 +1,9 @@
|
||||
.rn '' }`
|
||||
''' $RCSfile$$Revision$$Date$
|
||||
'''
|
||||
''' $Log$
|
||||
''' Revision 1.3 2001/03/25 20:32:25 nickc
|
||||
''' Automate generate on man pages
|
||||
'''
|
||||
'''
|
||||
.de Sh
|
||||
.\" Automatically generated by Pod::Man version 1.02
|
||||
.\" Wed May 30 12:24:30 2001
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ======================================================================
|
||||
.de Sh \" Subsection heading
|
||||
.br
|
||||
.if t .Sp
|
||||
.ne 5
|
||||
@ -14,149 +11,105 @@
|
||||
\fB\\$1\fR
|
||||
.PP
|
||||
..
|
||||
.de Sp
|
||||
.de Sp \" Vertical space (when we can't use .PP)
|
||||
.if t .sp .5v
|
||||
.if n .sp
|
||||
..
|
||||
.de Ip
|
||||
.de Ip \" List item
|
||||
.br
|
||||
.ie \\n(.$>=3 .ne \\$3
|
||||
.el .ne 3
|
||||
.IP "\\$1" \\$2
|
||||
..
|
||||
.de Vb
|
||||
.de Vb \" Begin verbatim text
|
||||
.ft CW
|
||||
.nf
|
||||
.ne \\$1
|
||||
..
|
||||
.de Ve
|
||||
.de Ve \" End verbatim text
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
'''
|
||||
'''
|
||||
''' Set up \*(-- to give an unbreakable dash;
|
||||
''' string Tr holds user defined translation string.
|
||||
''' Bell System Logo is used as a dummy character.
|
||||
'''
|
||||
.\" Set up some character translations and predefined strings. \*(-- will
|
||||
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
||||
.\" double quote, and \*(R" will give a right double quote. | will give a
|
||||
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
|
||||
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
|
||||
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
|
||||
.tr \(*W-|\(bv\*(Tr
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.ie n \{\
|
||||
.ds -- \(*W-
|
||||
.ds PI pi
|
||||
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
.ds L" ""
|
||||
.ds R" ""
|
||||
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
|
||||
''' \*(L" and \*(R", except that they are used on ".xx" lines,
|
||||
''' such as .IP and .SH, which do another additional levels of
|
||||
''' double-quote interpretation
|
||||
.ds M" """
|
||||
.ds S" """
|
||||
.ds N" """""
|
||||
.ds T" """""
|
||||
.ds L' '
|
||||
.ds R' '
|
||||
.ds M' '
|
||||
.ds S' '
|
||||
.ds N' '
|
||||
.ds T' '
|
||||
. ds -- \(*W-
|
||||
. ds PI pi
|
||||
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
. ds L" ""
|
||||
. ds R" ""
|
||||
. ds C` `
|
||||
. ds C' '
|
||||
'br\}
|
||||
.el\{\
|
||||
.ds -- \(em\|
|
||||
.tr \*(Tr
|
||||
.ds L" ``
|
||||
.ds R" ''
|
||||
.ds M" ``
|
||||
.ds S" ''
|
||||
.ds N" ``
|
||||
.ds T" ''
|
||||
.ds L' `
|
||||
.ds R' '
|
||||
.ds M' `
|
||||
.ds S' '
|
||||
.ds N' `
|
||||
.ds T' '
|
||||
.ds PI \(*p
|
||||
. ds -- \|\(em\|
|
||||
. ds PI \(*p
|
||||
. ds L" ``
|
||||
. ds R" ''
|
||||
'br\}
|
||||
.\" If the F register is turned on, we'll generate
|
||||
.\" index entries out stderr for the following things:
|
||||
.\" TH Title
|
||||
.\" SH Header
|
||||
.\" Sh Subsection
|
||||
.\" Ip Item
|
||||
.\" X<> Xref (embedded
|
||||
.\" Of course, you have to process the output yourself
|
||||
.\" in some meaninful fashion.
|
||||
.if \nF \{
|
||||
.de IX
|
||||
.tm Index:\\$1\t\\n%\t"\\$2"
|
||||
..
|
||||
.nr % 0
|
||||
.rr F
|
||||
.\"
|
||||
.\" If the F register is turned on, we'll generate index entries on stderr
|
||||
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
|
||||
.\" index entries marked with X<> in POD. Of course, you'll have to process
|
||||
.\" the output yourself in some meaningful fashion.
|
||||
.if \nF \{\
|
||||
. de IX
|
||||
. tm Index:\\$1\t\\n%\t"\\$2"
|
||||
. .
|
||||
. nr % 0
|
||||
. rr F
|
||||
.\}
|
||||
.TH CXXFILT.MAN 1 "binutils-2.11.90" "23/Mar/101" "GNU"
|
||||
.UC
|
||||
.if n .hy 0
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.de CQ \" put $1 in typewriter font
|
||||
.ft CW
|
||||
'if n "\c
|
||||
'if t \\&\\$1\c
|
||||
'if n \\&\\$1\c
|
||||
'if n \&"
|
||||
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
|
||||
'.ft R
|
||||
..
|
||||
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
|
||||
. \" AM - accent mark definitions
|
||||
.\"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it
|
||||
.\" makes way too many mistakes in technical documents.
|
||||
.hy 0
|
||||
.\"
|
||||
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
||||
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
||||
.bd B 3
|
||||
. \" fudge factors for nroff and troff
|
||||
. \" fudge factors for nroff and troff
|
||||
.if n \{\
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
.\}
|
||||
. \" simple accents for nroff and troff
|
||||
. \" simple accents for nroff and troff
|
||||
.if n \{\
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds ? ?
|
||||
. ds ! !
|
||||
. ds /
|
||||
. ds q
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds /
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
|
||||
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
.\}
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
||||
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
||||
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
|
||||
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
|
||||
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
|
||||
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
|
||||
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
||||
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
||||
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
||||
@ -164,45 +117,44 @@
|
||||
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
||||
.ds ae a\h'-(\w'a'u*4/10)'e
|
||||
.ds Ae A\h'-(\w'A'u*4/10)'E
|
||||
.ds oe o\h'-(\w'o'u*4/10)'e
|
||||
.ds Oe O\h'-(\w'O'u*4/10)'E
|
||||
. \" corrections for vroff
|
||||
. \" corrections for vroff
|
||||
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
||||
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
.if \n(.H>23 .if \n(.V>19 \
|
||||
\{\
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds v \h'-1'\o'\(aa\(ga'
|
||||
. ds _ \h'-1'^
|
||||
. ds . \h'-1'.
|
||||
. ds 3 3
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
. ds oe oe
|
||||
. ds Oe OE
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
.\}
|
||||
.rm #[ #] #H #V #F C
|
||||
.\" ======================================================================
|
||||
.\"
|
||||
.IX Title "CXXFILT.MAN 1"
|
||||
.TH CXXFILT.MAN 1 "binutils-2.11.90" "2001-05-30" "GNU"
|
||||
.UC
|
||||
.SH "NAME"
|
||||
cxxfilt \- Demangle \*(C+ and Java symbols.
|
||||
.SH "SYNOPSIS"
|
||||
c++filt [ \-_ | --strip-underscores ]
|
||||
[ \-j | --java ]
|
||||
[ \-n | --no-strip-underscores ]
|
||||
[ \-s \fIformat\fR | --format=\fIformat\fR ]
|
||||
[ --help ] [ --version ] [ \fIsymbol\fR... ]
|
||||
.IX Header "SYNOPSIS"
|
||||
c++filt [ \-_ | \-\-strip-underscores ]
|
||||
[ \-j | \-\-java ]
|
||||
[ \-n | \-\-no-strip-underscores ]
|
||||
[ \-s \fIformat\fR | \-\-format=\fIformat\fR ]
|
||||
[ \-\-help ] [ \-\-version ] [ \fIsymbol\fR... ]
|
||||
.SH "DESCRIPTION"
|
||||
.IX Header "DESCRIPTION"
|
||||
The \*(C+ and Java languages provides function overloading, which means
|
||||
that you can write many functions with the same name (providing each
|
||||
takes parameters of different types). All \*(C+ and Java function names
|
||||
are encoded into a low-level assembly label (this process is known as
|
||||
\fImangling\fR). The \f(CWc++filt\fR
|
||||
\&\fImangling\fR). The \f(CW\*(C`c++filt\*(C'\fR
|
||||
[1]
|
||||
program does the inverse mapping: it decodes (\fIdemangles\fR) low-level
|
||||
names into user-level names so that the linker can keep these overloaded
|
||||
@ -213,115 +165,85 @@ dollars, or periods) seen in the input is a potential label. If the
|
||||
label decodes into a \*(C+ name, the \*(C+ name replaces the low-level
|
||||
name in the output.
|
||||
.PP
|
||||
You can use \f(CWc++filt\fR to decipher individual symbols:
|
||||
You can use \f(CW\*(C`c++filt\*(C'\fR to decipher individual symbols:
|
||||
.PP
|
||||
.Vb 2
|
||||
\&
|
||||
.Vb 1
|
||||
\& c++filt I<symbol>
|
||||
.Ve
|
||||
If no \fIsymbol\fR arguments are given, \f(CWc++filt\fR reads symbol
|
||||
If no \fIsymbol\fR arguments are given, \f(CW\*(C`c++filt\*(C'\fR reads symbol
|
||||
names from the standard input and writes the demangled names to the
|
||||
standard output. All results are printed on the standard output.
|
||||
.SH "OPTIONS"
|
||||
.Ip "\f(CW-_\fR" 4
|
||||
.Ip "\f(CW--strip-underscores\fR" 4
|
||||
.IX Header "OPTIONS"
|
||||
.Ip "\f(CW\*(C`\-_\*(C'\fR" 4
|
||||
.IX Item "-_"
|
||||
.Ip "\f(CW\*(C`\-\-strip\-underscores\*(C'\fR" 4
|
||||
.IX Item "--strip-underscores"
|
||||
On some systems, both the C and \*(C+ compilers put an underscore in front
|
||||
of every name. For example, the C name \f(CWfoo\fR gets the low-level
|
||||
name \f(CW_foo\fR. This option removes the initial underscore. Whether
|
||||
\f(CWc++filt\fR removes the underscore by default is target dependent.
|
||||
.Ip "\f(CW-j\fR" 4
|
||||
.Ip "\f(CW--java\fR" 4
|
||||
of every name. For example, the C name \f(CW\*(C`foo\*(C'\fR gets the low-level
|
||||
name \f(CW\*(C`_foo\*(C'\fR. This option removes the initial underscore. Whether
|
||||
\&\f(CW\*(C`c++filt\*(C'\fR removes the underscore by default is target dependent.
|
||||
.Ip "\f(CW\*(C`\-j\*(C'\fR" 4
|
||||
.IX Item "-j"
|
||||
.Ip "\f(CW\*(C`\-\-java\*(C'\fR" 4
|
||||
.IX Item "--java"
|
||||
Prints demangled names using Java syntax. The default is to use \*(C+
|
||||
syntax.
|
||||
.Ip "\f(CW-n\fR" 4
|
||||
.Ip "\f(CW--no-strip-underscores\fR" 4
|
||||
.Ip "\f(CW\*(C`\-n\*(C'\fR" 4
|
||||
.IX Item "-n"
|
||||
.Ip "\f(CW\*(C`\-\-no\-strip\-underscores\*(C'\fR" 4
|
||||
.IX Item "--no-strip-underscores"
|
||||
Do not remove the initial underscore.
|
||||
.Ip "\f(CW-s \fIformat\fR\fR" 4
|
||||
.Ip "\f(CW--format=\fIformat\fR\fR" 4
|
||||
\s-1GNU\s0 \f(CWnm\fR can decode three different methods of mangling, used by
|
||||
.Ip "\f(CW\*(C`\-s \f(CIformat\f(CW\*(C'\fR" 4
|
||||
.IX Item "-s format"
|
||||
.Ip "\f(CW\*(C`\-\-format=\f(CIformat\f(CW\*(C'\fR" 4
|
||||
.IX Item "--format=format"
|
||||
\&\s-1GNU\s0 \f(CW\*(C`nm\*(C'\fR can decode three different methods of mangling, used by
|
||||
different \*(C+ compilers. The argument to this option selects which
|
||||
method it uses:
|
||||
.Ip "\f(CWgnu\fR" 8
|
||||
.RS 4
|
||||
.Ip "\f(CW\*(C`gnu\*(C'\fR" 4
|
||||
.IX Item "gnu"
|
||||
the one used by the \s-1GNU\s0 compiler (the default method)
|
||||
.Ip "\f(CWlucid\fR" 8
|
||||
.Ip "\f(CW\*(C`lucid\*(C'\fR" 4
|
||||
.IX Item "lucid"
|
||||
the one used by the Lucid compiler
|
||||
.Ip "\f(CWarm\fR" 8
|
||||
.Ip "\f(CW\*(C`arm\*(C'\fR" 4
|
||||
.IX Item "arm"
|
||||
the one specified by the \*(C+ Annotated Reference Manual
|
||||
.Ip "\f(CWhp\fR" 8
|
||||
.Ip "\f(CW\*(C`hp\*(C'\fR" 4
|
||||
.IX Item "hp"
|
||||
the one used by the \s-1HP\s0 compiler
|
||||
.Ip "\f(CWedg\fR" 8
|
||||
.Ip "\f(CW\*(C`edg\*(C'\fR" 4
|
||||
.IX Item "edg"
|
||||
the one used by the \s-1EDG\s0 compiler
|
||||
.Ip "\f(CWgnu-new-abi\fR" 8
|
||||
.Ip "\f(CW\*(C`gnu\-new\-abi\*(C'\fR" 4
|
||||
.IX Item "gnu-new-abi"
|
||||
the one used by the \s-1GNU\s0 compiler with the new \s-1ABI\s0.
|
||||
.Ip "\f(CW--help\fR" 4
|
||||
Print a summary of the options to \f(CWc++filt\fR and exit.
|
||||
.Ip "\f(CW--version\fR" 4
|
||||
Print the version number of \f(CWc++filt\fR and exit.
|
||||
.RE
|
||||
.RS 4
|
||||
.RE
|
||||
.Ip "\f(CW\*(C`\-\-help\*(C'\fR" 4
|
||||
.IX Item "--help"
|
||||
Print a summary of the options to \f(CW\*(C`c++filt\*(C'\fR and exit.
|
||||
.Ip "\f(CW\*(C`\-\-version\*(C'\fR" 4
|
||||
.IX Item "--version"
|
||||
Print the version number of \f(CW\*(C`c++filt\*(C'\fR and exit.
|
||||
.SH "FOOTNOTES"
|
||||
.IX Header "FOOTNOTES"
|
||||
.Ip "1." 4
|
||||
\s-1MS\s0\-\s-1DOS\s0 does not allow \f(CW+\fR characters in file names, so on
|
||||
\s-1MS\s0\-\s-1DOS\s0 this program is named \f(CWcxxfilt\fR.
|
||||
\&\s-1MS-DOS\s0 does not allow \f(CW\*(C`+\*(C'\fR characters in file names, so on
|
||||
\&\s-1MS-DOS\s0 this program is named \f(CW\*(C`cxxfilt\*(C'\fR.
|
||||
.SH "SEE ALSO"
|
||||
.IX Header "SEE ALSO"
|
||||
the Info entries for \fIbinutils\fR.
|
||||
.SH "COPYRIGHT"
|
||||
.IX Header "COPYRIGHT"
|
||||
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
|
||||
.PP
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||||
Back-Cover Texts. A copy of the license is included in the
|
||||
section entitled \*(L"GNU Free Documentation License\*(R".
|
||||
|
||||
.rn }` ''
|
||||
.IX Title "CXXFILT.MAN 1"
|
||||
.IX Name "cxxfilt - Demangle C++ and Java symbols."
|
||||
|
||||
.IX Header "NAME"
|
||||
|
||||
.IX Header "SYNOPSIS"
|
||||
|
||||
.IX Header "DESCRIPTION"
|
||||
|
||||
.IX Header "OPTIONS"
|
||||
|
||||
.IX Item "\f(CW-_\fR"
|
||||
|
||||
.IX Item "\f(CW--strip-underscores\fR"
|
||||
|
||||
.IX Item "\f(CW-j\fR"
|
||||
|
||||
.IX Item "\f(CW--java\fR"
|
||||
|
||||
.IX Item "\f(CW-n\fR"
|
||||
|
||||
.IX Item "\f(CW--no-strip-underscores\fR"
|
||||
|
||||
.IX Item "\f(CW-s \fIformat\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--format=\fIformat\fR\fR"
|
||||
|
||||
.IX Item "\f(CWgnu\fR"
|
||||
|
||||
.IX Item "\f(CWlucid\fR"
|
||||
|
||||
.IX Item "\f(CWarm\fR"
|
||||
|
||||
.IX Item "\f(CWhp\fR"
|
||||
|
||||
.IX Item "\f(CWedg\fR"
|
||||
|
||||
.IX Item "\f(CWgnu-new-abi\fR"
|
||||
|
||||
.IX Item "\f(CW--help\fR"
|
||||
|
||||
.IX Item "\f(CW--version\fR"
|
||||
|
||||
.IX Header "FOOTNOTES"
|
||||
|
||||
.IX Item "1."
|
||||
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
.IX Header "COPYRIGHT"
|
||||
|
||||
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
|
||||
|
||||
@ -1,12 +1,9 @@
|
||||
.rn '' }`
|
||||
''' $RCSfile$$Revision$$Date$
|
||||
'''
|
||||
''' $Log$
|
||||
''' Revision 1.1 2001/03/25 20:32:25 nickc
|
||||
''' Automate generate on man pages
|
||||
'''
|
||||
'''
|
||||
.de Sh
|
||||
.\" Automatically generated by Pod::Man version 1.02
|
||||
.\" Wed May 30 12:24:27 2001
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ======================================================================
|
||||
.de Sh \" Subsection heading
|
||||
.br
|
||||
.if t .Sp
|
||||
.ne 5
|
||||
@ -14,149 +11,105 @@
|
||||
\fB\\$1\fR
|
||||
.PP
|
||||
..
|
||||
.de Sp
|
||||
.de Sp \" Vertical space (when we can't use .PP)
|
||||
.if t .sp .5v
|
||||
.if n .sp
|
||||
..
|
||||
.de Ip
|
||||
.de Ip \" List item
|
||||
.br
|
||||
.ie \\n(.$>=3 .ne \\$3
|
||||
.el .ne 3
|
||||
.IP "\\$1" \\$2
|
||||
..
|
||||
.de Vb
|
||||
.de Vb \" Begin verbatim text
|
||||
.ft CW
|
||||
.nf
|
||||
.ne \\$1
|
||||
..
|
||||
.de Ve
|
||||
.de Ve \" End verbatim text
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
'''
|
||||
'''
|
||||
''' Set up \*(-- to give an unbreakable dash;
|
||||
''' string Tr holds user defined translation string.
|
||||
''' Bell System Logo is used as a dummy character.
|
||||
'''
|
||||
.\" Set up some character translations and predefined strings. \*(-- will
|
||||
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
||||
.\" double quote, and \*(R" will give a right double quote. | will give a
|
||||
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
|
||||
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
|
||||
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
|
||||
.tr \(*W-|\(bv\*(Tr
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.ie n \{\
|
||||
.ds -- \(*W-
|
||||
.ds PI pi
|
||||
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
.ds L" ""
|
||||
.ds R" ""
|
||||
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
|
||||
''' \*(L" and \*(R", except that they are used on ".xx" lines,
|
||||
''' such as .IP and .SH, which do another additional levels of
|
||||
''' double-quote interpretation
|
||||
.ds M" """
|
||||
.ds S" """
|
||||
.ds N" """""
|
||||
.ds T" """""
|
||||
.ds L' '
|
||||
.ds R' '
|
||||
.ds M' '
|
||||
.ds S' '
|
||||
.ds N' '
|
||||
.ds T' '
|
||||
. ds -- \(*W-
|
||||
. ds PI pi
|
||||
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
. ds L" ""
|
||||
. ds R" ""
|
||||
. ds C` `
|
||||
. ds C' '
|
||||
'br\}
|
||||
.el\{\
|
||||
.ds -- \(em\|
|
||||
.tr \*(Tr
|
||||
.ds L" ``
|
||||
.ds R" ''
|
||||
.ds M" ``
|
||||
.ds S" ''
|
||||
.ds N" ``
|
||||
.ds T" ''
|
||||
.ds L' `
|
||||
.ds R' '
|
||||
.ds M' `
|
||||
.ds S' '
|
||||
.ds N' `
|
||||
.ds T' '
|
||||
.ds PI \(*p
|
||||
. ds -- \|\(em\|
|
||||
. ds PI \(*p
|
||||
. ds L" ``
|
||||
. ds R" ''
|
||||
'br\}
|
||||
.\" If the F register is turned on, we'll generate
|
||||
.\" index entries out stderr for the following things:
|
||||
.\" TH Title
|
||||
.\" SH Header
|
||||
.\" Sh Subsection
|
||||
.\" Ip Item
|
||||
.\" X<> Xref (embedded
|
||||
.\" Of course, you have to process the output yourself
|
||||
.\" in some meaninful fashion.
|
||||
.if \nF \{
|
||||
.de IX
|
||||
.tm Index:\\$1\t\\n%\t"\\$2"
|
||||
..
|
||||
.nr % 0
|
||||
.rr F
|
||||
.\"
|
||||
.\" If the F register is turned on, we'll generate index entries on stderr
|
||||
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
|
||||
.\" index entries marked with X<> in POD. Of course, you'll have to process
|
||||
.\" the output yourself in some meaningful fashion.
|
||||
.if \nF \{\
|
||||
. de IX
|
||||
. tm Index:\\$1\t\\n%\t"\\$2"
|
||||
. .
|
||||
. nr % 0
|
||||
. rr F
|
||||
.\}
|
||||
.TH DLLTOOL.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
|
||||
.UC
|
||||
.if n .hy 0
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.de CQ \" put $1 in typewriter font
|
||||
.ft CW
|
||||
'if n "\c
|
||||
'if t \\&\\$1\c
|
||||
'if n \\&\\$1\c
|
||||
'if n \&"
|
||||
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
|
||||
'.ft R
|
||||
..
|
||||
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
|
||||
. \" AM - accent mark definitions
|
||||
.\"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it
|
||||
.\" makes way too many mistakes in technical documents.
|
||||
.hy 0
|
||||
.\"
|
||||
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
||||
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
||||
.bd B 3
|
||||
. \" fudge factors for nroff and troff
|
||||
. \" fudge factors for nroff and troff
|
||||
.if n \{\
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
.\}
|
||||
. \" simple accents for nroff and troff
|
||||
. \" simple accents for nroff and troff
|
||||
.if n \{\
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds ? ?
|
||||
. ds ! !
|
||||
. ds /
|
||||
. ds q
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds /
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
|
||||
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
.\}
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
||||
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
||||
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
|
||||
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
|
||||
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
|
||||
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
|
||||
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
||||
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
||||
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
||||
@ -164,94 +117,93 @@
|
||||
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
||||
.ds ae a\h'-(\w'a'u*4/10)'e
|
||||
.ds Ae A\h'-(\w'A'u*4/10)'E
|
||||
.ds oe o\h'-(\w'o'u*4/10)'e
|
||||
.ds Oe O\h'-(\w'O'u*4/10)'E
|
||||
. \" corrections for vroff
|
||||
. \" corrections for vroff
|
||||
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
||||
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
.if \n(.H>23 .if \n(.V>19 \
|
||||
\{\
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds v \h'-1'\o'\(aa\(ga'
|
||||
. ds _ \h'-1'^
|
||||
. ds . \h'-1'.
|
||||
. ds 3 3
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
. ds oe oe
|
||||
. ds Oe OE
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
.\}
|
||||
.rm #[ #] #H #V #F C
|
||||
.\" ======================================================================
|
||||
.\"
|
||||
.IX Title "DLLTOOL.1 1"
|
||||
.TH DLLTOOL.1 1 "binutils-2.11.90" "2001-05-30" "GNU"
|
||||
.UC
|
||||
.SH "NAME"
|
||||
dlltool \- Create files needed to build and use DLLs.
|
||||
.SH "SYNOPSIS"
|
||||
dlltool [\-d|--input-def \fIdef-file-name\fR]
|
||||
[\-b|--base-file \fIbase-file-name\fR]
|
||||
[\-e|--output-exp \fIexports-file-name\fR]
|
||||
[\-z|--output-def \fIdef-file-name\fR]
|
||||
[\-l|--output-lib \fIlibrary-file-name\fR]
|
||||
[--export-all-symbols] [--no-export-all-symbols]
|
||||
[--exclude-symbols \fIlist\fR]
|
||||
[--no-default-excludes]
|
||||
[\-S|--as \fIpath-to-assembler\fR] [\-f|--as-flags \fIoptions\fR]
|
||||
[\-D|--dllname \fIname\fR] [\-m|--machine \fImachine\fR]
|
||||
[\-a|--add-indirect] [\-U|--add-underscore] [\-k|--kill-at]
|
||||
[\-A|--add-stdcall-alias]
|
||||
[\-x|--no-idata4] [\-c|--no-idata5] [\-i|--interwork]
|
||||
[\-n|--nodelete] [\-v|--verbose] [\-h|--help] [\-V|--version]
|
||||
.IX Header "SYNOPSIS"
|
||||
dlltool [\-d|\-\-input-def \fIdef-file-name\fR]
|
||||
[\-b|\-\-base-file \fIbase-file-name\fR]
|
||||
[\-e|\-\-output-exp \fIexports-file-name\fR]
|
||||
[\-z|\-\-output-def \fIdef-file-name\fR]
|
||||
[\-l|\-\-output-lib \fIlibrary-file-name\fR]
|
||||
[\-\-export-all-symbols] [\-\-no-export-all-symbols]
|
||||
[\-\-exclude-symbols \fIlist\fR]
|
||||
[\-\-no-default-excludes]
|
||||
[\-S|\-\-as \fIpath-to-assembler\fR] [\-f|\-\-as-flags \fIoptions\fR]
|
||||
[\-D|\-\-dllname \fIname\fR] [\-m|\-\-machine \fImachine\fR]
|
||||
[\-a|\-\-add-indirect] [\-U|\-\-add-underscore] [\-k|\-\-kill-at]
|
||||
[\-A|\-\-add-stdcall-alias]
|
||||
[\-x|\-\-no-idata4] [\-c|\-\-no-idata5] [\-i|\-\-interwork]
|
||||
[\-n|\-\-nodelete] [\-v|\-\-verbose] [\-h|\-\-help] [\-V|\-\-version]
|
||||
[object-file ...]
|
||||
.SH "DESCRIPTION"
|
||||
\f(CWdlltool\fR reads its inputs, which can come from the \fB\-d\fR and
|
||||
\fB\-b\fR options as well as object files specified on the command
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\f(CW\*(C`dlltool\*(C'\fR reads its inputs, which can come from the \fB\-d\fR and
|
||||
\&\fB\-b\fR options as well as object files specified on the command
|
||||
line. It then processes these inputs and if the \fB\-e\fR option has
|
||||
been specified it creates a exports file. If the \fB\-l\fR option
|
||||
has been specified it creates a library file and if the \fB\-z\fR option
|
||||
has been specified it creates a def file. Any or all of the \-e, \-l
|
||||
and \-z options can be present in one invocation of dlltool.
|
||||
.PP
|
||||
When creating a DLL, along with the source for the DLL, it is necessary
|
||||
to have three other files. \f(CWdlltool\fR can help with the creation of
|
||||
When creating a \s-1DLL\s0, along with the source for the \s-1DLL\s0, it is necessary
|
||||
to have three other files. \f(CW\*(C`dlltool\*(C'\fR can help with the creation of
|
||||
these files.
|
||||
.PP
|
||||
The first file is a \fB.def\fR file which specifies which functions are
|
||||
exported from the DLL, which functions the DLL imports, and so on. This
|
||||
is a text file and can be created by hand, or \f(CWdlltool\fR can be used
|
||||
to create it using the \fB\-z\fR option. In this case \f(CWdlltool\fR
|
||||
exported from the \s-1DLL\s0, which functions the \s-1DLL\s0 imports, and so on. This
|
||||
is a text file and can be created by hand, or \f(CW\*(C`dlltool\*(C'\fR can be used
|
||||
to create it using the \fB\-z\fR option. In this case \f(CW\*(C`dlltool\*(C'\fR
|
||||
will scan the object files specified on its command line looking for
|
||||
those functions which have been specially marked as being exported and
|
||||
put entries for them in the .def file it creates.
|
||||
.PP
|
||||
In order to mark a function as being exported from a DLL, it needs to
|
||||
In order to mark a function as being exported from a \s-1DLL\s0, it needs to
|
||||
have an \fB\-export:<name_of_function>\fR entry in the \fB.drectve\fR
|
||||
section of the object file. This can be done in C by using the
|
||||
\fIasm()\fR operator:
|
||||
\&\fIasm()\fR operator:
|
||||
.PP
|
||||
.Vb 5
|
||||
\&
|
||||
.Vb 2
|
||||
\& asm (".section .drectve");
|
||||
\& asm (".ascii \e"-export:my_func\e"");
|
||||
\&
|
||||
.Ve
|
||||
.Vb 1
|
||||
\& int my_func (void) { ... }
|
||||
.Ve
|
||||
The second file needed for DLL creation is an exports file. This file
|
||||
is linked with the object files that make up the body of the DLL and it
|
||||
handles the interface between the DLL and the outside world. This is a
|
||||
The second file needed for \s-1DLL\s0 creation is an exports file. This file
|
||||
is linked with the object files that make up the body of the \s-1DLL\s0 and it
|
||||
handles the interface between the \s-1DLL\s0 and the outside world. This is a
|
||||
binary file and it can be created by giving the \fB\-e\fR option to
|
||||
\f(CWdlltool\fR when it is creating or reading in a .def file.
|
||||
\&\f(CW\*(C`dlltool\*(C'\fR when it is creating or reading in a .def file.
|
||||
.PP
|
||||
The third file needed for DLL creation is the library file that programs
|
||||
will link with in order to access the functions in the DLL. This file
|
||||
The third file needed for \s-1DLL\s0 creation is the library file that programs
|
||||
will link with in order to access the functions in the \s-1DLL\s0. This file
|
||||
can be created by giving the \fB\-l\fR option to dlltool when it
|
||||
is creating or reading in a .def file.
|
||||
.PP
|
||||
\f(CWdlltool\fR builds the library file by hand, but it builds the
|
||||
\&\f(CW\*(C`dlltool\*(C'\fR builds the library file by hand, but it builds the
|
||||
exports file by creating temporary files containing assembler statements
|
||||
and then assembling these. The \fB\-S\fR command line option can be
|
||||
used to specify the path to the assembler that dlltool will use,
|
||||
@ -261,65 +213,83 @@ these temporary assembler files when it is done, and if \fB\-n\fR is
|
||||
specified twice then this will prevent dlltool from deleting the
|
||||
temporary object files it used to build the library.
|
||||
.PP
|
||||
Here is an example of creating a DLL from a source file \fBdll.c\fR and
|
||||
Here is an example of creating a \s-1DLL\s0 from a source file \fBdll.c\fR and
|
||||
also creating a program (from an object file called \fBprogram.o\fR)
|
||||
that uses that DLL:
|
||||
that uses that \s-1DLL:\s0
|
||||
.PP
|
||||
.Vb 5
|
||||
\&
|
||||
.Vb 4
|
||||
\& gcc -c dll.c
|
||||
\& dlltool -e exports.o -l dll.lib dll.o
|
||||
\& gcc dll.o exports.o -o dll.dll
|
||||
\& gcc program.o dll.lib -o program
|
||||
.Ve
|
||||
.SH "OPTIONS"
|
||||
.IX Header "OPTIONS"
|
||||
The command line options have the following meanings:
|
||||
.Ip "\f(CW-d \fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW--input-def \fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-d \f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "-d filename"
|
||||
.Ip "\f(CW\*(C`\-\-input\-def \f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "--input-def filename"
|
||||
Specifies the name of a .def file to be read in and processed.
|
||||
.Ip "\f(CW-b \fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW--base-file \fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-b \f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "-b filename"
|
||||
.Ip "\f(CW\*(C`\-\-base\-file \f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "--base-file filename"
|
||||
Specifies the name of a base file to be read in and processed. The
|
||||
contents of this file will be added to the relocation section in the
|
||||
exports file generated by dlltool.
|
||||
.Ip "\f(CW-e \fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW--output-exp \fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-e \f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "-e filename"
|
||||
.Ip "\f(CW\*(C`\-\-output\-exp \f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "--output-exp filename"
|
||||
Specifies the name of the export file to be created by dlltool.
|
||||
.Ip "\f(CW-z \fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW--output-def \fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-z \f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "-z filename"
|
||||
.Ip "\f(CW\*(C`\-\-output\-def \f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "--output-def filename"
|
||||
Specifies the name of the .def file to be created by dlltool.
|
||||
.Ip "\f(CW-l \fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW--output-lib \fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-l \f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "-l filename"
|
||||
.Ip "\f(CW\*(C`\-\-output\-lib \f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "--output-lib filename"
|
||||
Specifies the name of the library file to be created by dlltool.
|
||||
.Ip "\f(CW--export-all-symbols\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-export\-all\-symbols\*(C'\fR" 4
|
||||
.IX Item "--export-all-symbols"
|
||||
Treat all global and weak defined symbols found in the input object
|
||||
files as symbols to be exported. There is a small list of symbols which
|
||||
are not exported by default; see the \f(CW--no-default-excludes\fR
|
||||
are not exported by default; see the \f(CW\*(C`\-\-no\-default\-excludes\*(C'\fR
|
||||
option. You may add to the list of symbols to not export by using the
|
||||
\f(CW--exclude-symbols\fR option.
|
||||
.Ip "\f(CW--no-export-all-symbols\fR" 4
|
||||
\&\f(CW\*(C`\-\-exclude\-symbols\*(C'\fR option.
|
||||
.Ip "\f(CW\*(C`\-\-no\-export\-all\-symbols\*(C'\fR" 4
|
||||
.IX Item "--no-export-all-symbols"
|
||||
Only export symbols explicitly listed in an input .def file or in
|
||||
\&\fB.drectve\fR sections in the input object files. This is the default
|
||||
behaviour. The \fB.drectve\fR sections are created by \fBdllexport\fR
|
||||
attributes in the source code.
|
||||
.Ip "\f(CW--exclude-symbols \fIlist\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-exclude\-symbols \f(CIlist\f(CW\*(C'\fR" 4
|
||||
.IX Item "--exclude-symbols list"
|
||||
Do not export the symbols in \fIlist\fR. This is a list of symbol names
|
||||
separated by comma or colon characters. The symbol names should not
|
||||
contain a leading underscore. This is only meaningful when
|
||||
\f(CW--export-all-symbols\fR is used.
|
||||
.Ip "\f(CW--no-default-excludes\fR" 4
|
||||
When \f(CW--export-all-symbols\fR is used, it will by default avoid
|
||||
\&\f(CW\*(C`\-\-export\-all\-symbols\*(C'\fR is used.
|
||||
.Ip "\f(CW\*(C`\-\-no\-default\-excludes\*(C'\fR" 4
|
||||
.IX Item "--no-default-excludes"
|
||||
When \f(CW\*(C`\-\-export\-all\-symbols\*(C'\fR is used, it will by default avoid
|
||||
exporting certain special symbols. The current list of symbols to avoid
|
||||
exporting is \fBDllMain@12\fR, \fBDllEntryPoint@0\fR,
|
||||
\fBimpure_ptr\fR. You may use the \f(CW--no-default-excludes\fR option
|
||||
\&\fBimpure_ptr\fR. You may use the \f(CW\*(C`\-\-no\-default\-excludes\*(C'\fR option
|
||||
to go ahead and export these special symbols. This is only meaningful
|
||||
when \f(CW--export-all-symbols\fR is used.
|
||||
.Ip "\f(CW-S \fIpath\fR\fR" 4
|
||||
.Ip "\f(CW--as \fIpath\fR\fR" 4
|
||||
when \f(CW\*(C`\-\-export\-all\-symbols\*(C'\fR is used.
|
||||
.Ip "\f(CW\*(C`\-S \f(CIpath\f(CW\*(C'\fR" 4
|
||||
.IX Item "-S path"
|
||||
.Ip "\f(CW\*(C`\-\-as \f(CIpath\f(CW\*(C'\fR" 4
|
||||
.IX Item "--as path"
|
||||
Specifies the path, including the filename, of the assembler to be used
|
||||
to create the exports file.
|
||||
.Ip "\f(CW-f \fIswitches\fR\fR" 4
|
||||
.Ip "\f(CW--as-flags \fIswitches\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-f \f(CIswitches\f(CW\*(C'\fR" 4
|
||||
.IX Item "-f switches"
|
||||
.Ip "\f(CW\*(C`\-\-as\-flags \f(CIswitches\f(CW\*(C'\fR" 4
|
||||
.IX Item "--as-flags switches"
|
||||
Specifies any specific command line switches to be passed to the
|
||||
assembler when building the exports file. This option will work even if
|
||||
the \fB\-S\fR option is not used. This option only takes one argument,
|
||||
@ -327,183 +297,106 @@ and if it occurs more than once on the command line, then later
|
||||
occurrences will override earlier occurrences. So if it is necessary to
|
||||
pass multiple switches to the assembler they should be enclosed in
|
||||
double quotes.
|
||||
.Ip "\f(CW-D \fIname\fR\fR" 4
|
||||
.Ip "\f(CW--dll-name \fIname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-D \f(CIname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-D name"
|
||||
.Ip "\f(CW\*(C`\-\-dll\-name \f(CIname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--dll-name name"
|
||||
Specifies the name to be stored in the .def file as the name of the \s-1DLL\s0
|
||||
when the \fB\-e\fR option is used. If this option is not present, then
|
||||
the filename given to the \fB\-e\fR option will be used as the name of
|
||||
the \s-1DLL\s0.
|
||||
.Ip "\f(CW-m \fImachine\fR\fR" 4
|
||||
.Ip "\f(CW-machine \fImachine\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-m \f(CImachine\f(CW\*(C'\fR" 4
|
||||
.IX Item "-m machine"
|
||||
.Ip "\f(CW\*(C`\-machine \f(CImachine\f(CW\*(C'\fR" 4
|
||||
.IX Item "-machine machine"
|
||||
Specifies the type of machine for which the library file should be
|
||||
built. \f(CWdlltool\fR has a built in default type, depending upon how
|
||||
built. \f(CW\*(C`dlltool\*(C'\fR has a built in default type, depending upon how
|
||||
it was created, but this option can be used to override that. This is
|
||||
normally only useful when creating DLLs for an \s-1ARM\s0 processor, when the
|
||||
contents of the \s-1DLL\s0 are actually encode using \s-1THUMB\s0 instructions.
|
||||
.Ip "\f(CW-a\fR" 4
|
||||
.Ip "\f(CW--add-indirect\fR" 4
|
||||
Specifies that when \f(CWdlltool\fR is creating the exports file it
|
||||
.Ip "\f(CW\*(C`\-a\*(C'\fR" 4
|
||||
.IX Item "-a"
|
||||
.Ip "\f(CW\*(C`\-\-add\-indirect\*(C'\fR" 4
|
||||
.IX Item "--add-indirect"
|
||||
Specifies that when \f(CW\*(C`dlltool\*(C'\fR is creating the exports file it
|
||||
should add a section which allows the exported functions to be
|
||||
referenced without using the import library. Whatever the hell that
|
||||
means!
|
||||
.Ip "\f(CW-U\fR" 4
|
||||
.Ip "\f(CW--add-underscore\fR" 4
|
||||
Specifies that when \f(CWdlltool\fR is creating the exports file it
|
||||
.Ip "\f(CW\*(C`\-U\*(C'\fR" 4
|
||||
.IX Item "-U"
|
||||
.Ip "\f(CW\*(C`\-\-add\-underscore\*(C'\fR" 4
|
||||
.IX Item "--add-underscore"
|
||||
Specifies that when \f(CW\*(C`dlltool\*(C'\fR is creating the exports file it
|
||||
should prepend an underscore to the names of the exported functions.
|
||||
.Ip "\f(CW-k\fR" 4
|
||||
.Ip "\f(CW--kill-at\fR" 4
|
||||
Specifies that when \f(CWdlltool\fR is creating the exports file it
|
||||
.Ip "\f(CW\*(C`\-k\*(C'\fR" 4
|
||||
.IX Item "-k"
|
||||
.Ip "\f(CW\*(C`\-\-kill\-at\*(C'\fR" 4
|
||||
.IX Item "--kill-at"
|
||||
Specifies that when \f(CW\*(C`dlltool\*(C'\fR is creating the exports file it
|
||||
should not append the string \fB@ <number>\fR. These numbers are
|
||||
called ordinal numbers and they represent another way of accessing the
|
||||
function in a \s-1DLL\s0, other than by name.
|
||||
.Ip "\f(CW-A\fR" 4
|
||||
.Ip "\f(CW--add-stdcall-alias\fR" 4
|
||||
Specifies that when \f(CWdlltool\fR is creating the exports file it
|
||||
.Ip "\f(CW\*(C`\-A\*(C'\fR" 4
|
||||
.IX Item "-A"
|
||||
.Ip "\f(CW\*(C`\-\-add\-stdcall\-alias\*(C'\fR" 4
|
||||
.IX Item "--add-stdcall-alias"
|
||||
Specifies that when \f(CW\*(C`dlltool\*(C'\fR is creating the exports file it
|
||||
should add aliases for stdcall symbols without \fB@ <number>\fR
|
||||
in addition to the symbols with \fB@ <number>\fR.
|
||||
.Ip "\f(CW-x\fR" 4
|
||||
.Ip "\f(CW--no-idata4\fR" 4
|
||||
Specifies that when \f(CWdlltool\fR is creating the exports and library
|
||||
.Ip "\f(CW\*(C`\-x\*(C'\fR" 4
|
||||
.IX Item "-x"
|
||||
.Ip "\f(CW\*(C`\-\-no\-idata4\*(C'\fR" 4
|
||||
.IX Item "--no-idata4"
|
||||
Specifies that when \f(CW\*(C`dlltool\*(C'\fR is creating the exports and library
|
||||
files it should omit the .idata4 section. This is for compatibility
|
||||
with certain operating systems.
|
||||
.Ip "\f(CW-c\fR" 4
|
||||
.Ip "\f(CW--no-idata5\fR" 4
|
||||
Specifies that when \f(CWdlltool\fR is creating the exports and library
|
||||
.Ip "\f(CW\*(C`\-c\*(C'\fR" 4
|
||||
.IX Item "-c"
|
||||
.Ip "\f(CW\*(C`\-\-no\-idata5\*(C'\fR" 4
|
||||
.IX Item "--no-idata5"
|
||||
Specifies that when \f(CW\*(C`dlltool\*(C'\fR is creating the exports and library
|
||||
files it should omit the .idata5 section. This is for compatibility
|
||||
with certain operating systems.
|
||||
.Ip "\f(CW-i\fR" 4
|
||||
.Ip "\f(CW--interwork\fR" 4
|
||||
Specifies that \f(CWdlltool\fR should mark the objects in the library
|
||||
.Ip "\f(CW\*(C`\-i\*(C'\fR" 4
|
||||
.IX Item "-i"
|
||||
.Ip "\f(CW\*(C`\-\-interwork\*(C'\fR" 4
|
||||
.IX Item "--interwork"
|
||||
Specifies that \f(CW\*(C`dlltool\*(C'\fR should mark the objects in the library
|
||||
file and exports file that it produces as supporting interworking
|
||||
between \s-1ARM\s0 and \s-1THUMB\s0 code.
|
||||
.Ip "\f(CW-n\fR" 4
|
||||
.Ip "\f(CW--nodelete\fR" 4
|
||||
Makes \f(CWdlltool\fR preserve the temporary assembler files it used to
|
||||
.Ip "\f(CW\*(C`\-n\*(C'\fR" 4
|
||||
.IX Item "-n"
|
||||
.Ip "\f(CW\*(C`\-\-nodelete\*(C'\fR" 4
|
||||
.IX Item "--nodelete"
|
||||
Makes \f(CW\*(C`dlltool\*(C'\fR preserve the temporary assembler files it used to
|
||||
create the exports file. If this option is repeated then dlltool will
|
||||
also preserve the temporary object files it uses to create the library
|
||||
file.
|
||||
.Ip "\f(CW-v\fR" 4
|
||||
.Ip "\f(CW--verbose\fR" 4
|
||||
.Ip "\f(CW\*(C`\-v\*(C'\fR" 4
|
||||
.IX Item "-v"
|
||||
.Ip "\f(CW\*(C`\-\-verbose\*(C'\fR" 4
|
||||
.IX Item "--verbose"
|
||||
Make dlltool describe what it is doing.
|
||||
.Ip "\f(CW-h\fR" 4
|
||||
.Ip "\f(CW--help\fR" 4
|
||||
.Ip "\f(CW\*(C`\-h\*(C'\fR" 4
|
||||
.IX Item "-h"
|
||||
.Ip "\f(CW\*(C`\-\-help\*(C'\fR" 4
|
||||
.IX Item "--help"
|
||||
Displays a list of command line options and then exits.
|
||||
.Ip "\f(CW-V\fR" 4
|
||||
.Ip "\f(CW--version\fR" 4
|
||||
.Ip "\f(CW\*(C`\-V\*(C'\fR" 4
|
||||
.IX Item "-V"
|
||||
.Ip "\f(CW\*(C`\-\-version\*(C'\fR" 4
|
||||
.IX Item "--version"
|
||||
Displays dlltool's version number and then exits.
|
||||
.SH "SEE ALSO"
|
||||
.IX Header "SEE ALSO"
|
||||
the Info entries for \fIbinutils\fR.
|
||||
.SH "COPYRIGHT"
|
||||
.IX Header "COPYRIGHT"
|
||||
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
|
||||
.PP
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||||
Back-Cover Texts. A copy of the license is included in the
|
||||
section entitled \*(L"GNU Free Documentation License\*(R".
|
||||
|
||||
.rn }` ''
|
||||
.IX Title "DLLTOOL.1 1"
|
||||
.IX Name "dlltool - Create files needed to build and use DLLs."
|
||||
|
||||
.IX Header "NAME"
|
||||
|
||||
.IX Header "SYNOPSIS"
|
||||
|
||||
.IX Header "DESCRIPTION"
|
||||
|
||||
.IX Header "OPTIONS"
|
||||
|
||||
.IX Item "\f(CW-d \fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--input-def \fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-b \fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--base-file \fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-e \fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--output-exp \fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-z \fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--output-def \fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-l \fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--output-lib \fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--export-all-symbols\fR"
|
||||
|
||||
.IX Item "\f(CW--no-export-all-symbols\fR"
|
||||
|
||||
.IX Item "\f(CW--exclude-symbols \fIlist\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--no-default-excludes\fR"
|
||||
|
||||
.IX Item "\f(CW-S \fIpath\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--as \fIpath\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-f \fIswitches\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--as-flags \fIswitches\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-D \fIname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--dll-name \fIname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-m \fImachine\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-machine \fImachine\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-a\fR"
|
||||
|
||||
.IX Item "\f(CW--add-indirect\fR"
|
||||
|
||||
.IX Item "\f(CW-U\fR"
|
||||
|
||||
.IX Item "\f(CW--add-underscore\fR"
|
||||
|
||||
.IX Item "\f(CW-k\fR"
|
||||
|
||||
.IX Item "\f(CW--kill-at\fR"
|
||||
|
||||
.IX Item "\f(CW-A\fR"
|
||||
|
||||
.IX Item "\f(CW--add-stdcall-alias\fR"
|
||||
|
||||
.IX Item "\f(CW-x\fR"
|
||||
|
||||
.IX Item "\f(CW--no-idata4\fR"
|
||||
|
||||
.IX Item "\f(CW-c\fR"
|
||||
|
||||
.IX Item "\f(CW--no-idata5\fR"
|
||||
|
||||
.IX Item "\f(CW-i\fR"
|
||||
|
||||
.IX Item "\f(CW--interwork\fR"
|
||||
|
||||
.IX Item "\f(CW-n\fR"
|
||||
|
||||
.IX Item "\f(CW--nodelete\fR"
|
||||
|
||||
.IX Item "\f(CW-v\fR"
|
||||
|
||||
.IX Item "\f(CW--verbose\fR"
|
||||
|
||||
.IX Item "\f(CW-h\fR"
|
||||
|
||||
.IX Item "\f(CW--help\fR"
|
||||
|
||||
.IX Item "\f(CW-V\fR"
|
||||
|
||||
.IX Item "\f(CW--version\fR"
|
||||
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
.IX Header "COPYRIGHT"
|
||||
|
||||
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
|
||||
|
||||
@ -1,12 +1,9 @@
|
||||
.rn '' }`
|
||||
''' $RCSfile$$Revision$$Date$
|
||||
'''
|
||||
''' $Log$
|
||||
''' Revision 1.5 2001/03/25 20:32:25 nickc
|
||||
''' Automate generate on man pages
|
||||
'''
|
||||
'''
|
||||
.de Sh
|
||||
.\" Automatically generated by Pod::Man version 1.02
|
||||
.\" Wed May 30 12:24:27 2001
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ======================================================================
|
||||
.de Sh \" Subsection heading
|
||||
.br
|
||||
.if t .Sp
|
||||
.ne 5
|
||||
@ -14,149 +11,105 @@
|
||||
\fB\\$1\fR
|
||||
.PP
|
||||
..
|
||||
.de Sp
|
||||
.de Sp \" Vertical space (when we can't use .PP)
|
||||
.if t .sp .5v
|
||||
.if n .sp
|
||||
..
|
||||
.de Ip
|
||||
.de Ip \" List item
|
||||
.br
|
||||
.ie \\n(.$>=3 .ne \\$3
|
||||
.el .ne 3
|
||||
.IP "\\$1" \\$2
|
||||
..
|
||||
.de Vb
|
||||
.de Vb \" Begin verbatim text
|
||||
.ft CW
|
||||
.nf
|
||||
.ne \\$1
|
||||
..
|
||||
.de Ve
|
||||
.de Ve \" End verbatim text
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
'''
|
||||
'''
|
||||
''' Set up \*(-- to give an unbreakable dash;
|
||||
''' string Tr holds user defined translation string.
|
||||
''' Bell System Logo is used as a dummy character.
|
||||
'''
|
||||
.\" Set up some character translations and predefined strings. \*(-- will
|
||||
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
||||
.\" double quote, and \*(R" will give a right double quote. | will give a
|
||||
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
|
||||
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
|
||||
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
|
||||
.tr \(*W-|\(bv\*(Tr
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.ie n \{\
|
||||
.ds -- \(*W-
|
||||
.ds PI pi
|
||||
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
.ds L" ""
|
||||
.ds R" ""
|
||||
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
|
||||
''' \*(L" and \*(R", except that they are used on ".xx" lines,
|
||||
''' such as .IP and .SH, which do another additional levels of
|
||||
''' double-quote interpretation
|
||||
.ds M" """
|
||||
.ds S" """
|
||||
.ds N" """""
|
||||
.ds T" """""
|
||||
.ds L' '
|
||||
.ds R' '
|
||||
.ds M' '
|
||||
.ds S' '
|
||||
.ds N' '
|
||||
.ds T' '
|
||||
. ds -- \(*W-
|
||||
. ds PI pi
|
||||
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
. ds L" ""
|
||||
. ds R" ""
|
||||
. ds C` `
|
||||
. ds C' '
|
||||
'br\}
|
||||
.el\{\
|
||||
.ds -- \(em\|
|
||||
.tr \*(Tr
|
||||
.ds L" ``
|
||||
.ds R" ''
|
||||
.ds M" ``
|
||||
.ds S" ''
|
||||
.ds N" ``
|
||||
.ds T" ''
|
||||
.ds L' `
|
||||
.ds R' '
|
||||
.ds M' `
|
||||
.ds S' '
|
||||
.ds N' `
|
||||
.ds T' '
|
||||
.ds PI \(*p
|
||||
. ds -- \|\(em\|
|
||||
. ds PI \(*p
|
||||
. ds L" ``
|
||||
. ds R" ''
|
||||
'br\}
|
||||
.\" If the F register is turned on, we'll generate
|
||||
.\" index entries out stderr for the following things:
|
||||
.\" TH Title
|
||||
.\" SH Header
|
||||
.\" Sh Subsection
|
||||
.\" Ip Item
|
||||
.\" X<> Xref (embedded
|
||||
.\" Of course, you have to process the output yourself
|
||||
.\" in some meaninful fashion.
|
||||
.if \nF \{
|
||||
.de IX
|
||||
.tm Index:\\$1\t\\n%\t"\\$2"
|
||||
..
|
||||
.nr % 0
|
||||
.rr F
|
||||
.\"
|
||||
.\" If the F register is turned on, we'll generate index entries on stderr
|
||||
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
|
||||
.\" index entries marked with X<> in POD. Of course, you'll have to process
|
||||
.\" the output yourself in some meaningful fashion.
|
||||
.if \nF \{\
|
||||
. de IX
|
||||
. tm Index:\\$1\t\\n%\t"\\$2"
|
||||
. .
|
||||
. nr % 0
|
||||
. rr F
|
||||
.\}
|
||||
.TH NLMCONV.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
|
||||
.UC
|
||||
.if n .hy 0
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.de CQ \" put $1 in typewriter font
|
||||
.ft CW
|
||||
'if n "\c
|
||||
'if t \\&\\$1\c
|
||||
'if n \\&\\$1\c
|
||||
'if n \&"
|
||||
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
|
||||
'.ft R
|
||||
..
|
||||
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
|
||||
. \" AM - accent mark definitions
|
||||
.\"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it
|
||||
.\" makes way too many mistakes in technical documents.
|
||||
.hy 0
|
||||
.\"
|
||||
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
||||
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
||||
.bd B 3
|
||||
. \" fudge factors for nroff and troff
|
||||
. \" fudge factors for nroff and troff
|
||||
.if n \{\
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
.\}
|
||||
. \" simple accents for nroff and troff
|
||||
. \" simple accents for nroff and troff
|
||||
.if n \{\
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds ? ?
|
||||
. ds ! !
|
||||
. ds /
|
||||
. ds q
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds /
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
|
||||
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
.\}
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
||||
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
||||
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
|
||||
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
|
||||
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
|
||||
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
|
||||
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
||||
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
||||
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
||||
@ -164,138 +117,109 @@
|
||||
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
||||
.ds ae a\h'-(\w'a'u*4/10)'e
|
||||
.ds Ae A\h'-(\w'A'u*4/10)'E
|
||||
.ds oe o\h'-(\w'o'u*4/10)'e
|
||||
.ds Oe O\h'-(\w'O'u*4/10)'E
|
||||
. \" corrections for vroff
|
||||
. \" corrections for vroff
|
||||
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
||||
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
.if \n(.H>23 .if \n(.V>19 \
|
||||
\{\
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds v \h'-1'\o'\(aa\(ga'
|
||||
. ds _ \h'-1'^
|
||||
. ds . \h'-1'.
|
||||
. ds 3 3
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
. ds oe oe
|
||||
. ds Oe OE
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
.\}
|
||||
.rm #[ #] #H #V #F C
|
||||
.\" ======================================================================
|
||||
.\"
|
||||
.IX Title "NLMCONV.1 1"
|
||||
.TH NLMCONV.1 1 "binutils-2.11.90" "2001-05-30" "GNU"
|
||||
.UC
|
||||
.SH "NAME"
|
||||
nlmconv \- converts object code into an NLM.
|
||||
nlmconv \- converts object code into an \s-1NLM\s0.
|
||||
.SH "SYNOPSIS"
|
||||
nlmconv [ \-I \fIbfdname\fR | --input-target=\fIbfdname\fR ]
|
||||
[ \-O \fIbfdname\fR | --output-target=\fIbfdname\fR ]
|
||||
[ \-T \fIheaderfile\fR | --header-file=\fIheaderfile\fR ]
|
||||
[ \-d | --debug] [ \-l \fIlinker\fR | --linker=\fIlinker\fR ]
|
||||
[ \-h | --help ] [ \-V | --version ]
|
||||
.IX Header "SYNOPSIS"
|
||||
nlmconv [ \-I \fIbfdname\fR | \-\-input-target=\fIbfdname\fR ]
|
||||
[ \-O \fIbfdname\fR | \-\-output-target=\fIbfdname\fR ]
|
||||
[ \-T \fIheaderfile\fR | \-\-header-file=\fIheaderfile\fR ]
|
||||
[ \-d | \-\-debug] [ \-l \fIlinker\fR | \-\-linker=\fIlinker\fR ]
|
||||
[ \-h | \-\-help ] [ \-V | \-\-version ]
|
||||
\fIinfile\fR \fIoutfile\fR
|
||||
.SH "DESCRIPTION"
|
||||
\f(CWnlmconv\fR converts the relocatable \fBi386\fR object file
|
||||
\fIinfile\fR into the NetWare Loadable Module \fIoutfile\fR, optionally
|
||||
reading \fIheaderfile\fR for NLM header information. For instructions
|
||||
on writing the NLM command file language used in header files, see the
|
||||
\fBlinkers\fR section, \fBNLMLINK\fR in particular, of the \fINLM
|
||||
Development and Tools Overview\fR, which is part of the NLM Software
|
||||
Developer's Kit (``NLM SDK''), available from Novell, Inc.
|
||||
\f(CWnlmconv\fR uses the GNU Binary File Descriptor library to read
|
||||
\fIinfile\fR;
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\f(CW\*(C`nlmconv\*(C'\fR converts the relocatable \fBi386\fR object file
|
||||
\&\fIinfile\fR into the NetWare Loadable Module \fIoutfile\fR, optionally
|
||||
reading \fIheaderfile\fR for \s-1NLM\s0 header information. For instructions
|
||||
on writing the \s-1NLM\s0 command file language used in header files, see the
|
||||
\&\fBlinkers\fR section, \fB\s-1NLMLINK\s0\fR in particular, of the \fI\s-1NLM\s0
|
||||
Development and Tools Overview\fR, which is part of the \s-1NLM\s0 Software
|
||||
Developer's Kit (``\s-1NLM\s0 \s-1SDK\s0''), available from Novell, Inc.
|
||||
\&\f(CW\*(C`nlmconv\*(C'\fR uses the \s-1GNU\s0 Binary File Descriptor library to read
|
||||
\&\fIinfile\fR;
|
||||
.PP
|
||||
\f(CWnlmconv\fR can perform a link step. In other words, you can list
|
||||
\&\f(CW\*(C`nlmconv\*(C'\fR can perform a link step. In other words, you can list
|
||||
more than one object file for input if you list them in the definitions
|
||||
file (rather than simply specifying one input file on the command line).
|
||||
In this case, \f(CWnlmconv\fR calls the linker for you.
|
||||
In this case, \f(CW\*(C`nlmconv\*(C'\fR calls the linker for you.
|
||||
.SH "OPTIONS"
|
||||
.Ip "\f(CW-I \fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW--input-target=\fIbfdname\fR\fR" 4
|
||||
Object format of the input file. \f(CWnlmconv\fR can usually determine
|
||||
.IX Header "OPTIONS"
|
||||
.Ip "\f(CW\*(C`\-I \f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-I bfdname"
|
||||
.Ip "\f(CW\*(C`\-\-input\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--input-target=bfdname"
|
||||
Object format of the input file. \f(CW\*(C`nlmconv\*(C'\fR can usually determine
|
||||
the format of a given file (so no default is necessary).
|
||||
.Ip "\f(CW-O \fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW--output-target=\fIbfdname\fR\fR" 4
|
||||
Object format of the output file. \f(CWnlmconv\fR infers the output
|
||||
.Ip "\f(CW\*(C`\-O \f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-O bfdname"
|
||||
.Ip "\f(CW\*(C`\-\-output\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--output-target=bfdname"
|
||||
Object format of the output file. \f(CW\*(C`nlmconv\*(C'\fR infers the output
|
||||
format based on the input format, e.g. for a \fBi386\fR input file the
|
||||
output format is \fBnlm32-i386\fR.
|
||||
.Ip "\f(CW-T \fIheaderfile\fR\fR" 4
|
||||
.Ip "\f(CW--header-file=\fIheaderfile\fR\fR" 4
|
||||
output format is \fBnlm32\-i386\fR.
|
||||
.Ip "\f(CW\*(C`\-T \f(CIheaderfile\f(CW\*(C'\fR" 4
|
||||
.IX Item "-T headerfile"
|
||||
.Ip "\f(CW\*(C`\-\-header\-file=\f(CIheaderfile\f(CW\*(C'\fR" 4
|
||||
.IX Item "--header-file=headerfile"
|
||||
Reads \fIheaderfile\fR for \s-1NLM\s0 header information. For instructions on
|
||||
writing the \s-1NLM\s0 command file language used in header files, see see the
|
||||
\fBlinkers\fR section, of the \fI\s-1NLM\s0 Development and Tools
|
||||
\&\fBlinkers\fR section, of the \fI\s-1NLM\s0 Development and Tools
|
||||
Overview\fR, which is part of the \s-1NLM\s0 Software Developer's Kit, available
|
||||
from Novell, Inc.
|
||||
.Ip "\f(CW-d\fR" 4
|
||||
.Ip "\f(CW--debug\fR" 4
|
||||
Displays (on standard error) the linker command line used by \f(CWnlmconv\fR.
|
||||
.Ip "\f(CW-l \fIlinker\fR\fR" 4
|
||||
.Ip "\f(CW--linker=\fIlinker\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-d\*(C'\fR" 4
|
||||
.IX Item "-d"
|
||||
.Ip "\f(CW\*(C`\-\-debug\*(C'\fR" 4
|
||||
.IX Item "--debug"
|
||||
Displays (on standard error) the linker command line used by \f(CW\*(C`nlmconv\*(C'\fR.
|
||||
.Ip "\f(CW\*(C`\-l \f(CIlinker\f(CW\*(C'\fR" 4
|
||||
.IX Item "-l linker"
|
||||
.Ip "\f(CW\*(C`\-\-linker=\f(CIlinker\f(CW\*(C'\fR" 4
|
||||
.IX Item "--linker=linker"
|
||||
Use \fIlinker\fR for any linking. \fIlinker\fR can be an absolute or a
|
||||
relative pathname.
|
||||
.Ip "\f(CW-h\fR" 4
|
||||
.Ip "\f(CW--help\fR" 4
|
||||
.Ip "\f(CW\*(C`\-h\*(C'\fR" 4
|
||||
.IX Item "-h"
|
||||
.Ip "\f(CW\*(C`\-\-help\*(C'\fR" 4
|
||||
.IX Item "--help"
|
||||
Prints a usage summary.
|
||||
.Ip "\f(CW-V\fR" 4
|
||||
.Ip "\f(CW--version\fR" 4
|
||||
Prints the version number for \f(CWnlmconv\fR.
|
||||
.Ip "\f(CW\*(C`\-V\*(C'\fR" 4
|
||||
.IX Item "-V"
|
||||
.Ip "\f(CW\*(C`\-\-version\*(C'\fR" 4
|
||||
.IX Item "--version"
|
||||
Prints the version number for \f(CW\*(C`nlmconv\*(C'\fR.
|
||||
.SH "SEE ALSO"
|
||||
.IX Header "SEE ALSO"
|
||||
the Info entries for \fIbinutils\fR.
|
||||
.SH "COPYRIGHT"
|
||||
.IX Header "COPYRIGHT"
|
||||
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
|
||||
.PP
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||||
Back-Cover Texts. A copy of the license is included in the
|
||||
section entitled \*(L"GNU Free Documentation License\*(R".
|
||||
|
||||
.rn }` ''
|
||||
.IX Title "NLMCONV.1 1"
|
||||
.IX Name "nlmconv - converts object code into an NLM."
|
||||
|
||||
.IX Header "NAME"
|
||||
|
||||
.IX Header "SYNOPSIS"
|
||||
|
||||
.IX Header "DESCRIPTION"
|
||||
|
||||
.IX Header "OPTIONS"
|
||||
|
||||
.IX Item "\f(CW-I \fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--input-target=\fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-O \fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--output-target=\fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-T \fIheaderfile\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--header-file=\fIheaderfile\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-d\fR"
|
||||
|
||||
.IX Item "\f(CW--debug\fR"
|
||||
|
||||
.IX Item "\f(CW-l \fIlinker\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--linker=\fIlinker\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-h\fR"
|
||||
|
||||
.IX Item "\f(CW--help\fR"
|
||||
|
||||
.IX Item "\f(CW-V\fR"
|
||||
|
||||
.IX Item "\f(CW--version\fR"
|
||||
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
.IX Header "COPYRIGHT"
|
||||
|
||||
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
|
||||
|
||||
486
binutils/nm.1
486
binutils/nm.1
@ -1,12 +1,9 @@
|
||||
.rn '' }`
|
||||
''' $RCSfile$$Revision$$Date$
|
||||
'''
|
||||
''' $Log$
|
||||
''' Revision 1.5 2001/03/25 20:32:25 nickc
|
||||
''' Automate generate on man pages
|
||||
'''
|
||||
'''
|
||||
.de Sh
|
||||
.\" Automatically generated by Pod::Man version 1.02
|
||||
.\" Wed May 30 12:24:27 2001
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ======================================================================
|
||||
.de Sh \" Subsection heading
|
||||
.br
|
||||
.if t .Sp
|
||||
.ne 5
|
||||
@ -14,149 +11,105 @@
|
||||
\fB\\$1\fR
|
||||
.PP
|
||||
..
|
||||
.de Sp
|
||||
.de Sp \" Vertical space (when we can't use .PP)
|
||||
.if t .sp .5v
|
||||
.if n .sp
|
||||
..
|
||||
.de Ip
|
||||
.de Ip \" List item
|
||||
.br
|
||||
.ie \\n(.$>=3 .ne \\$3
|
||||
.el .ne 3
|
||||
.IP "\\$1" \\$2
|
||||
..
|
||||
.de Vb
|
||||
.de Vb \" Begin verbatim text
|
||||
.ft CW
|
||||
.nf
|
||||
.ne \\$1
|
||||
..
|
||||
.de Ve
|
||||
.de Ve \" End verbatim text
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
'''
|
||||
'''
|
||||
''' Set up \*(-- to give an unbreakable dash;
|
||||
''' string Tr holds user defined translation string.
|
||||
''' Bell System Logo is used as a dummy character.
|
||||
'''
|
||||
.\" Set up some character translations and predefined strings. \*(-- will
|
||||
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
||||
.\" double quote, and \*(R" will give a right double quote. | will give a
|
||||
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
|
||||
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
|
||||
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
|
||||
.tr \(*W-|\(bv\*(Tr
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.ie n \{\
|
||||
.ds -- \(*W-
|
||||
.ds PI pi
|
||||
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
.ds L" ""
|
||||
.ds R" ""
|
||||
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
|
||||
''' \*(L" and \*(R", except that they are used on ".xx" lines,
|
||||
''' such as .IP and .SH, which do another additional levels of
|
||||
''' double-quote interpretation
|
||||
.ds M" """
|
||||
.ds S" """
|
||||
.ds N" """""
|
||||
.ds T" """""
|
||||
.ds L' '
|
||||
.ds R' '
|
||||
.ds M' '
|
||||
.ds S' '
|
||||
.ds N' '
|
||||
.ds T' '
|
||||
. ds -- \(*W-
|
||||
. ds PI pi
|
||||
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
. ds L" ""
|
||||
. ds R" ""
|
||||
. ds C` `
|
||||
. ds C' '
|
||||
'br\}
|
||||
.el\{\
|
||||
.ds -- \(em\|
|
||||
.tr \*(Tr
|
||||
.ds L" ``
|
||||
.ds R" ''
|
||||
.ds M" ``
|
||||
.ds S" ''
|
||||
.ds N" ``
|
||||
.ds T" ''
|
||||
.ds L' `
|
||||
.ds R' '
|
||||
.ds M' `
|
||||
.ds S' '
|
||||
.ds N' `
|
||||
.ds T' '
|
||||
.ds PI \(*p
|
||||
. ds -- \|\(em\|
|
||||
. ds PI \(*p
|
||||
. ds L" ``
|
||||
. ds R" ''
|
||||
'br\}
|
||||
.\" If the F register is turned on, we'll generate
|
||||
.\" index entries out stderr for the following things:
|
||||
.\" TH Title
|
||||
.\" SH Header
|
||||
.\" Sh Subsection
|
||||
.\" Ip Item
|
||||
.\" X<> Xref (embedded
|
||||
.\" Of course, you have to process the output yourself
|
||||
.\" in some meaninful fashion.
|
||||
.if \nF \{
|
||||
.de IX
|
||||
.tm Index:\\$1\t\\n%\t"\\$2"
|
||||
..
|
||||
.nr % 0
|
||||
.rr F
|
||||
.\"
|
||||
.\" If the F register is turned on, we'll generate index entries on stderr
|
||||
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
|
||||
.\" index entries marked with X<> in POD. Of course, you'll have to process
|
||||
.\" the output yourself in some meaningful fashion.
|
||||
.if \nF \{\
|
||||
. de IX
|
||||
. tm Index:\\$1\t\\n%\t"\\$2"
|
||||
. .
|
||||
. nr % 0
|
||||
. rr F
|
||||
.\}
|
||||
.TH NM.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
|
||||
.UC
|
||||
.if n .hy 0
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.de CQ \" put $1 in typewriter font
|
||||
.ft CW
|
||||
'if n "\c
|
||||
'if t \\&\\$1\c
|
||||
'if n \\&\\$1\c
|
||||
'if n \&"
|
||||
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
|
||||
'.ft R
|
||||
..
|
||||
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
|
||||
. \" AM - accent mark definitions
|
||||
.\"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it
|
||||
.\" makes way too many mistakes in technical documents.
|
||||
.hy 0
|
||||
.\"
|
||||
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
||||
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
||||
.bd B 3
|
||||
. \" fudge factors for nroff and troff
|
||||
. \" fudge factors for nroff and troff
|
||||
.if n \{\
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
.\}
|
||||
. \" simple accents for nroff and troff
|
||||
. \" simple accents for nroff and troff
|
||||
.if n \{\
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds ? ?
|
||||
. ds ! !
|
||||
. ds /
|
||||
. ds q
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds /
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
|
||||
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
.\}
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
||||
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
||||
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
|
||||
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
|
||||
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
|
||||
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
|
||||
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
||||
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
||||
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
||||
@ -164,49 +117,48 @@
|
||||
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
||||
.ds ae a\h'-(\w'a'u*4/10)'e
|
||||
.ds Ae A\h'-(\w'A'u*4/10)'E
|
||||
.ds oe o\h'-(\w'o'u*4/10)'e
|
||||
.ds Oe O\h'-(\w'O'u*4/10)'E
|
||||
. \" corrections for vroff
|
||||
. \" corrections for vroff
|
||||
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
||||
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
.if \n(.H>23 .if \n(.V>19 \
|
||||
\{\
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds v \h'-1'\o'\(aa\(ga'
|
||||
. ds _ \h'-1'^
|
||||
. ds . \h'-1'.
|
||||
. ds 3 3
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
. ds oe oe
|
||||
. ds Oe OE
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
.\}
|
||||
.rm #[ #] #H #V #F C
|
||||
.\" ======================================================================
|
||||
.\"
|
||||
.IX Title "NM.1 1"
|
||||
.TH NM.1 1 "binutils-2.11.90" "2001-05-30" "GNU"
|
||||
.UC
|
||||
.SH "NAME"
|
||||
nm \- list symbols from object files
|
||||
.SH "SYNOPSIS"
|
||||
nm [ \-a | --debug-syms ] [ \-g | --extern-only ]
|
||||
[ \-B ] [ \-C | --demangle[=\fIstyle\fR] ] [ \-D | --dynamic ]
|
||||
[ \-s | --print-armap ] [ \-A | \-o | --print-file-name ]
|
||||
[ \-n | \-v | --numeric-sort ] [ \-p | --no-sort ]
|
||||
[ \-r | --reverse-sort ] [ --size-sort ] [ \-u | --undefined-only ]
|
||||
[ \-t \fIradix\fR | --radix=\fIradix\fR ] [ \-P | --portability ]
|
||||
[ --target=\fIbfdname\fR ] [ \-f \fIformat\fR | --format=\fIformat\fR ]
|
||||
[ --defined-only ] [\-l | --line-numbers ] [ --no-demangle ]
|
||||
[ \-V | --version ] [ \-X 32_64 ] [ --help ] [ \fIobjfile\fR... ]
|
||||
.IX Header "SYNOPSIS"
|
||||
nm [ \-a | \-\-debug-syms ] [ \-g | \-\-extern-only ]
|
||||
[ \-B ] [ \-C | \-\-demangle[=\fIstyle\fR] ] [ \-D | \-\-dynamic ]
|
||||
[ \-s | \-\-print-armap ] [ \-A | \-o | \-\-print-file-name ]
|
||||
[ \-n | \-v | \-\-numeric-sort ] [ \-p | \-\-no-sort ]
|
||||
[ \-r | \-\-reverse-sort ] [ \-\-size-sort ] [ \-u | \-\-undefined-only ]
|
||||
[ \-t \fIradix\fR | \-\-radix=\fIradix\fR ] [ \-P | \-\-portability ]
|
||||
[ \-\-target=\fIbfdname\fR ] [ \-f \fIformat\fR | \-\-format=\fIformat\fR ]
|
||||
[ \-\-defined-only ] [\-l | \-\-line-numbers ] [ \-\-no-demangle ]
|
||||
[ \-V | \-\-version ] [ \-X 32_64 ] [ \-\-help ] [ \fIobjfile\fR... ]
|
||||
.SH "DESCRIPTION"
|
||||
GNU \f(CWnm\fR lists the symbols from object files \fIobjfile\fR....
|
||||
If no object files are listed as arguments, \f(CWnm\fR assumes the file
|
||||
\fIa.out\fR.
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\s-1GNU\s0 \f(CW\*(C`nm\*(C'\fR lists the symbols from object files \fIobjfile\fR....
|
||||
If no object files are listed as arguments, \f(CW\*(C`nm\*(C'\fR assumes the file
|
||||
\&\fIa.out\fR.
|
||||
.PP
|
||||
For each symbol, \f(CWnm\fR shows:
|
||||
For each symbol, \f(CW\*(C`nm\*(C'\fR shows:
|
||||
.Ip "\(bu" 4
|
||||
The symbol value, in the radix selected by options (see below), or
|
||||
hexadecimal by default.
|
||||
@ -214,51 +166,217 @@ hexadecimal by default.
|
||||
The symbol type. At least the following types are used; others are, as
|
||||
well, depending on the object file format. If lowercase, the symbol is
|
||||
local; if uppercase, the symbol is global (external).
|
||||
.Ip "\f(CWA\fR" 8
|
||||
.RS 4
|
||||
.Ip "\f(CW\*(C`A\*(C'\fR" 4
|
||||
.IX Item "A"
|
||||
The symbol's value is absolute, and will not be changed by further
|
||||
linking.
|
||||
.Ip "\f(CWB\fR" 8
|
||||
.Ip "\f(CW\*(C`B\*(C'\fR" 4
|
||||
.IX Item "B"
|
||||
The symbol is in the uninitialized data section (known as \s-1BSS\s0).
|
||||
.Ip "\f(CWC\fR" 8
|
||||
.Ip "\f(CW\*(C`C\*(C'\fR" 4
|
||||
.IX Item "C"
|
||||
The symbol is common. Common symbols are uninitialized data. When
|
||||
linking, multiple common symbols may appear with the same name. If the
|
||||
symbol is defined anywhere, the common symbols are treated as undefined
|
||||
references.
|
||||
.Ip "\f(CW\*(C`D\*(C'\fR" 4
|
||||
.IX Item "D"
|
||||
The symbol is in the initialized data section.
|
||||
.Ip "\f(CW\*(C`G\*(C'\fR" 4
|
||||
.IX Item "G"
|
||||
The symbol is in an initialized data section for small objects. Some
|
||||
object file formats permit more efficient access to small data objects,
|
||||
such as a global int variable as opposed to a large global array.
|
||||
.Ip "\f(CW\*(C`I\*(C'\fR" 4
|
||||
.IX Item "I"
|
||||
The symbol is an indirect reference to another symbol. This is a \s-1GNU\s0
|
||||
extension to the a.out object file format which is rarely used.
|
||||
.Ip "\f(CW\*(C`N\*(C'\fR" 4
|
||||
.IX Item "N"
|
||||
The symbol is a debugging symbol.
|
||||
.Ip "\f(CW\*(C`R\*(C'\fR" 4
|
||||
.IX Item "R"
|
||||
The symbol is in a read only data section.
|
||||
.Ip "\f(CW\*(C`S\*(C'\fR" 4
|
||||
.IX Item "S"
|
||||
The symbol is in an uninitialized data section for small objects.
|
||||
.Ip "\f(CW\*(C`T\*(C'\fR" 4
|
||||
.IX Item "T"
|
||||
The symbol is in the text (code) section.
|
||||
.Ip "\f(CW\*(C`U\*(C'\fR" 4
|
||||
.IX Item "U"
|
||||
The symbol is undefined.
|
||||
.Ip "\f(CW\*(C`V\*(C'\fR" 4
|
||||
.IX Item "V"
|
||||
The symbol is a weak object. When a weak defined symbol is linked with
|
||||
a normal defined symbol, the normal defined symbol is used with no error.
|
||||
When a weak undefined symbol is linked and the symbol is not defined,
|
||||
the value of the weak symbol becomes zero with no error.
|
||||
.Ip "\f(CW\*(C`W\*(C'\fR" 4
|
||||
.IX Item "W"
|
||||
The symbol is a weak symbol that has not been specifically tagged as a
|
||||
weak object symbol. When a weak defined symbol is linked with a normal
|
||||
defined symbol, the normal defined symbol is used with no error.
|
||||
When a weak undefined symbol is linked and the symbol is not defined,
|
||||
the value of the weak symbol becomes zero with no error.
|
||||
.Ip "\f(CW\*(C`\-\*(C'\fR" 4
|
||||
.IX Item "-"
|
||||
The symbol is a stabs symbol in an a.out object file. In this case, the
|
||||
next values printed are the stabs other field, the stabs desc field, and
|
||||
the stab type. Stabs symbols are used to hold debugging information;
|
||||
for more information, see \f(CW@ref\fR{Top,Stabs,Stabs Overview,stabs.info, The
|
||||
``stabs'' debug format}.
|
||||
.Ip "\f(CW\*(C`?\*(C'\fR" 4
|
||||
.IX Item "?"
|
||||
The symbol type is unknown, or object file format specific.
|
||||
.RE
|
||||
.RS 4
|
||||
.RE
|
||||
.Ip "\(bu" 4
|
||||
The symbol name.
|
||||
.SH "OPTIONS"
|
||||
.IX Header "OPTIONS"
|
||||
The long and short forms of options, shown here as alternatives, are
|
||||
equivalent.
|
||||
.Ip "\f(CW\*(C`\-A\*(C'\fR" 4
|
||||
.IX Item "-A"
|
||||
.Ip "\f(CW\*(C`\-o\*(C'\fR" 4
|
||||
.IX Item "-o"
|
||||
.Ip "\f(CW\*(C`\-\-print\-file\-name \*(C'\fR" 4
|
||||
.IX Item "--print-file-name "
|
||||
Precede each symbol by the name of the input file (or archive member)
|
||||
in which it was found, rather than identifying the input file once only,
|
||||
before all of its symbols.
|
||||
.Ip "\f(CW\*(C`\-a\*(C'\fR" 4
|
||||
.IX Item "-a"
|
||||
.Ip "\f(CW\*(C`\-\-debug\-syms \*(C'\fR" 4
|
||||
.IX Item "--debug-syms "
|
||||
Display all symbols, even debugger-only symbols; normally these are not
|
||||
listed.
|
||||
.Ip "\f(CW\*(C`\-B\*(C'\fR" 4
|
||||
.IX Item "-B"
|
||||
The same as \fB\*(--format=bsd\fR (for compatibility with the \s-1MIPS\s0 \f(CW\*(C`nm\*(C'\fR).
|
||||
.Ip "\f(CW\*(C`\-C\*(C'\fR" 4
|
||||
.IX Item "-C"
|
||||
.Ip "\f(CW\*(C`\-\-demangle[=\f(CIstyle\f(CW]\*(C'\fR" 4
|
||||
.IX Item "--demangle[=style]"
|
||||
Decode (\fIdemangle\fR) low-level symbol names into user-level names.
|
||||
Besides removing any initial underscore prepended by the system, this
|
||||
makes \*(C+ function names readable. Different compilers have different
|
||||
mangling styles. The optional demangling style argument can be used to
|
||||
choose an appropriate demangling style for your compiler.
|
||||
.Ip "\f(CW\*(C`\-\-no\-demangle\*(C'\fR" 4
|
||||
.IX Item "--no-demangle"
|
||||
Do not demangle low-level symbol names. This is the default.
|
||||
.Ip "\f(CW\*(C`\-D\*(C'\fR" 4
|
||||
.IX Item "-D"
|
||||
.Ip "\f(CW\*(C`\-\-dynamic\*(C'\fR" 4
|
||||
.IX Item "--dynamic"
|
||||
Display the dynamic symbols rather than the normal symbols. This is
|
||||
only meaningful for dynamic objects, such as certain types of shared
|
||||
libraries.
|
||||
.Ip "\f(CW\*(C`\-f \f(CIformat\f(CW\*(C'\fR" 4
|
||||
.IX Item "-f format"
|
||||
.Ip "\f(CW\*(C`\-\-format=\f(CIformat\f(CW\*(C'\fR" 4
|
||||
.IX Item "--format=format"
|
||||
Use the output format \fIformat\fR, which can be \f(CW\*(C`bsd\*(C'\fR,
|
||||
\&\f(CW\*(C`sysv\*(C'\fR, or \f(CW\*(C`posix\*(C'\fR. The default is \f(CW\*(C`bsd\*(C'\fR.
|
||||
Only the first character of \fIformat\fR is significant; it can be
|
||||
either upper or lower case.
|
||||
.Ip "\f(CW\*(C`\-g\*(C'\fR" 4
|
||||
.IX Item "-g"
|
||||
.Ip "\f(CW\*(C`\-\-extern\-only \*(C'\fR" 4
|
||||
.IX Item "--extern-only "
|
||||
Display only external symbols.
|
||||
.Ip "\f(CW\*(C`\-l\*(C'\fR" 4
|
||||
.IX Item "-l"
|
||||
.Ip "\f(CW\*(C`\-\-line\-numbers\*(C'\fR" 4
|
||||
.IX Item "--line-numbers"
|
||||
For each symbol, use debugging information to try to find a filename and
|
||||
line number. For a defined symbol, look for the line number of the
|
||||
address of the symbol. For an undefined symbol, look for the line
|
||||
number of a relocation entry which refers to the symbol. If line number
|
||||
information can be found, print it after the other symbol information.
|
||||
.Ip "\f(CW\*(C`\-n\*(C'\fR" 4
|
||||
.IX Item "-n"
|
||||
.Ip "\f(CW\*(C`\-v\*(C'\fR" 4
|
||||
.IX Item "-v"
|
||||
.Ip "\f(CW\*(C`\-\-numeric\-sort \*(C'\fR" 4
|
||||
.IX Item "--numeric-sort "
|
||||
Sort symbols numerically by their addresses, rather than alphabetically
|
||||
by their names.
|
||||
.Ip "\f(CW\*(C`\-p\*(C'\fR" 4
|
||||
.IX Item "-p"
|
||||
.Ip "\f(CW\*(C`\-\-no\-sort \*(C'\fR" 4
|
||||
.IX Item "--no-sort "
|
||||
Do not bother to sort the symbols in any order; print them in the order
|
||||
encountered.
|
||||
.Ip "\f(CW\*(C`\-P\*(C'\fR" 4
|
||||
.IX Item "-P"
|
||||
.Ip "\f(CW\*(C`\-\-portability\*(C'\fR" 4
|
||||
.IX Item "--portability"
|
||||
Use the \s-1POSIX\s0.2 standard output format instead of the default format.
|
||||
Equivalent to \fB\-f posix\fR.
|
||||
.Ip "\f(CW\*(C`\-s\*(C'\fR" 4
|
||||
.IX Item "-s"
|
||||
.Ip "\f(CW\*(C`\-\-print\-armap\*(C'\fR" 4
|
||||
.IX Item "--print-armap"
|
||||
When listing symbols from archive members, include the index: a mapping
|
||||
(stored in the archive by \f(CW\*(C`ar\*(C'\fR or \f(CW\*(C`ranlib\*(C'\fR) of which modules
|
||||
contain definitions for which names.
|
||||
.Ip "\f(CW\*(C`\-r\*(C'\fR" 4
|
||||
.IX Item "-r"
|
||||
.Ip "\f(CW\*(C`\-\-reverse\-sort \*(C'\fR" 4
|
||||
.IX Item "--reverse-sort "
|
||||
Reverse the order of the sort (whether numeric or alphabetic); let the
|
||||
last come first.
|
||||
.Ip "\f(CW\*(C`\-\-size\-sort\*(C'\fR" 4
|
||||
.IX Item "--size-sort"
|
||||
Sort symbols by size. The size is computed as the difference between
|
||||
the value of the symbol and the value of the symbol with the next higher
|
||||
value. The size of the symbol is printed, rather than the value.
|
||||
.Ip "\f(CW\*(C`\-t \f(CIradix\f(CW\*(C'\fR" 4
|
||||
.IX Item "-t radix"
|
||||
.Ip "\f(CW\*(C`\-\-radix=\f(CIradix\f(CW\*(C'\fR" 4
|
||||
.IX Item "--radix=radix"
|
||||
Use \fIradix\fR as the radix for printing the symbol values. It must be
|
||||
\&\fBd\fR for decimal, \fBo\fR for octal, or \fBx\fR for hexadecimal.
|
||||
.Ip "\f(CW\*(C`\-\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--target=bfdname"
|
||||
Specify an object code format other than your system's default format.
|
||||
.Ip "\f(CW\*(C`\-u\*(C'\fR" 4
|
||||
.IX Item "-u"
|
||||
.Ip "\f(CW\*(C`\-\-undefined\-only \*(C'\fR" 4
|
||||
.IX Item "--undefined-only "
|
||||
Display only undefined symbols (those external to each object file).
|
||||
.Ip "\f(CW\*(C`\-\-defined\-only\*(C'\fR" 4
|
||||
.IX Item "--defined-only"
|
||||
Display only defined symbols for each object file.
|
||||
.Ip "\f(CW\*(C`\-V\*(C'\fR" 4
|
||||
.IX Item "-V"
|
||||
.Ip "\f(CW\*(C`\-\-version\*(C'\fR" 4
|
||||
.IX Item "--version"
|
||||
Show the version number of \f(CW\*(C`nm\*(C'\fR and exit.
|
||||
.Ip "\f(CW\*(C`\-X\*(C'\fR" 4
|
||||
.IX Item "-X"
|
||||
This option is ignored for compatibility with the \s-1AIX\s0 version of
|
||||
\&\f(CW\*(C`nm\*(C'\fR. It takes one parameter which must be the string
|
||||
\&\f(CW\*(C`32_64\*(C'\fR. The default mode of \s-1AIX\s0 \f(CW\*(C`nm\*(C'\fR corresponds
|
||||
to \f(CW\*(C`\-X 32\*(C'\fR, which is not supported by \s-1GNU\s0 \f(CW\*(C`nm\*(C'\fR.
|
||||
.Ip "\f(CW\*(C`\-\-help\*(C'\fR" 4
|
||||
.IX Item "--help"
|
||||
Show a summary of the options to \f(CW\*(C`nm\*(C'\fR and exit.
|
||||
.SH "SEE ALSO"
|
||||
.IX Header "SEE ALSO"
|
||||
\&\fIar\fR\|(1), \fIobjdump\fR\|(1), \fIranlib\fR\|(1), and the Info entries for \fIbinutils\fR.
|
||||
.SH "COPYRIGHT"
|
||||
.IX Header "COPYRIGHT"
|
||||
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
|
||||
.Sp
|
||||
.PP
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||||
Back-Cover Texts. A copy of the license is included in the
|
||||
section entitled \*(L"GNU Free Documentation License\*(R".
|
||||
|
||||
.rn }` ''
|
||||
.IX Title "NM.1 1"
|
||||
.IX Name "nm - list symbols from object files"
|
||||
|
||||
.IX Header "NAME"
|
||||
|
||||
.IX Header "SYNOPSIS"
|
||||
|
||||
.IX Header "DESCRIPTION"
|
||||
|
||||
.IX Item "\(bu"
|
||||
|
||||
.IX Item "\(bu"
|
||||
|
||||
.IX Item "\f(CWA\fR"
|
||||
|
||||
.IX Item "\f(CWB\fR"
|
||||
|
||||
.IX Item "\f(CWC\fR"
|
||||
|
||||
.IX Header "OPTIONS"
|
||||
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
.IX Header "COPYRIGHT"
|
||||
|
||||
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
|
||||
|
||||
@ -1,12 +1,9 @@
|
||||
.rn '' }`
|
||||
''' $RCSfile$$Revision$$Date$
|
||||
'''
|
||||
''' $Log$
|
||||
''' Revision 1.10 2001/03/25 20:32:25 nickc
|
||||
''' Automate generate on man pages
|
||||
'''
|
||||
'''
|
||||
.de Sh
|
||||
.\" Automatically generated by Pod::Man version 1.02
|
||||
.\" Wed May 30 12:24:28 2001
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ======================================================================
|
||||
.de Sh \" Subsection heading
|
||||
.br
|
||||
.if t .Sp
|
||||
.ne 5
|
||||
@ -14,149 +11,105 @@
|
||||
\fB\\$1\fR
|
||||
.PP
|
||||
..
|
||||
.de Sp
|
||||
.de Sp \" Vertical space (when we can't use .PP)
|
||||
.if t .sp .5v
|
||||
.if n .sp
|
||||
..
|
||||
.de Ip
|
||||
.de Ip \" List item
|
||||
.br
|
||||
.ie \\n(.$>=3 .ne \\$3
|
||||
.el .ne 3
|
||||
.IP "\\$1" \\$2
|
||||
..
|
||||
.de Vb
|
||||
.de Vb \" Begin verbatim text
|
||||
.ft CW
|
||||
.nf
|
||||
.ne \\$1
|
||||
..
|
||||
.de Ve
|
||||
.de Ve \" End verbatim text
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
'''
|
||||
'''
|
||||
''' Set up \*(-- to give an unbreakable dash;
|
||||
''' string Tr holds user defined translation string.
|
||||
''' Bell System Logo is used as a dummy character.
|
||||
'''
|
||||
.\" Set up some character translations and predefined strings. \*(-- will
|
||||
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
||||
.\" double quote, and \*(R" will give a right double quote. | will give a
|
||||
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
|
||||
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
|
||||
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
|
||||
.tr \(*W-|\(bv\*(Tr
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.ie n \{\
|
||||
.ds -- \(*W-
|
||||
.ds PI pi
|
||||
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
.ds L" ""
|
||||
.ds R" ""
|
||||
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
|
||||
''' \*(L" and \*(R", except that they are used on ".xx" lines,
|
||||
''' such as .IP and .SH, which do another additional levels of
|
||||
''' double-quote interpretation
|
||||
.ds M" """
|
||||
.ds S" """
|
||||
.ds N" """""
|
||||
.ds T" """""
|
||||
.ds L' '
|
||||
.ds R' '
|
||||
.ds M' '
|
||||
.ds S' '
|
||||
.ds N' '
|
||||
.ds T' '
|
||||
. ds -- \(*W-
|
||||
. ds PI pi
|
||||
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
. ds L" ""
|
||||
. ds R" ""
|
||||
. ds C` `
|
||||
. ds C' '
|
||||
'br\}
|
||||
.el\{\
|
||||
.ds -- \(em\|
|
||||
.tr \*(Tr
|
||||
.ds L" ``
|
||||
.ds R" ''
|
||||
.ds M" ``
|
||||
.ds S" ''
|
||||
.ds N" ``
|
||||
.ds T" ''
|
||||
.ds L' `
|
||||
.ds R' '
|
||||
.ds M' `
|
||||
.ds S' '
|
||||
.ds N' `
|
||||
.ds T' '
|
||||
.ds PI \(*p
|
||||
. ds -- \|\(em\|
|
||||
. ds PI \(*p
|
||||
. ds L" ``
|
||||
. ds R" ''
|
||||
'br\}
|
||||
.\" If the F register is turned on, we'll generate
|
||||
.\" index entries out stderr for the following things:
|
||||
.\" TH Title
|
||||
.\" SH Header
|
||||
.\" Sh Subsection
|
||||
.\" Ip Item
|
||||
.\" X<> Xref (embedded
|
||||
.\" Of course, you have to process the output yourself
|
||||
.\" in some meaninful fashion.
|
||||
.if \nF \{
|
||||
.de IX
|
||||
.tm Index:\\$1\t\\n%\t"\\$2"
|
||||
..
|
||||
.nr % 0
|
||||
.rr F
|
||||
.\"
|
||||
.\" If the F register is turned on, we'll generate index entries on stderr
|
||||
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
|
||||
.\" index entries marked with X<> in POD. Of course, you'll have to process
|
||||
.\" the output yourself in some meaningful fashion.
|
||||
.if \nF \{\
|
||||
. de IX
|
||||
. tm Index:\\$1\t\\n%\t"\\$2"
|
||||
. .
|
||||
. nr % 0
|
||||
. rr F
|
||||
.\}
|
||||
.TH OBJCOPY.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
|
||||
.UC
|
||||
.if n .hy 0
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.de CQ \" put $1 in typewriter font
|
||||
.ft CW
|
||||
'if n "\c
|
||||
'if t \\&\\$1\c
|
||||
'if n \\&\\$1\c
|
||||
'if n \&"
|
||||
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
|
||||
'.ft R
|
||||
..
|
||||
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
|
||||
. \" AM - accent mark definitions
|
||||
.\"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it
|
||||
.\" makes way too many mistakes in technical documents.
|
||||
.hy 0
|
||||
.\"
|
||||
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
||||
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
||||
.bd B 3
|
||||
. \" fudge factors for nroff and troff
|
||||
. \" fudge factors for nroff and troff
|
||||
.if n \{\
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
.\}
|
||||
. \" simple accents for nroff and troff
|
||||
. \" simple accents for nroff and troff
|
||||
.if n \{\
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds ? ?
|
||||
. ds ! !
|
||||
. ds /
|
||||
. ds q
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds /
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
|
||||
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
.\}
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
||||
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
||||
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
|
||||
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
|
||||
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
|
||||
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
|
||||
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
||||
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
||||
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
||||
@ -164,119 +117,135 @@
|
||||
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
||||
.ds ae a\h'-(\w'a'u*4/10)'e
|
||||
.ds Ae A\h'-(\w'A'u*4/10)'E
|
||||
.ds oe o\h'-(\w'o'u*4/10)'e
|
||||
.ds Oe O\h'-(\w'O'u*4/10)'E
|
||||
. \" corrections for vroff
|
||||
. \" corrections for vroff
|
||||
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
||||
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
.if \n(.H>23 .if \n(.V>19 \
|
||||
\{\
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds v \h'-1'\o'\(aa\(ga'
|
||||
. ds _ \h'-1'^
|
||||
. ds . \h'-1'.
|
||||
. ds 3 3
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
. ds oe oe
|
||||
. ds Oe OE
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
.\}
|
||||
.rm #[ #] #H #V #F C
|
||||
.\" ======================================================================
|
||||
.\"
|
||||
.IX Title "OBJCOPY.1 1"
|
||||
.TH OBJCOPY.1 1 "binutils-2.11.90" "2001-05-30" "GNU"
|
||||
.UC
|
||||
.SH "NAME"
|
||||
objcopy \- copy and translate object files
|
||||
.SH "SYNOPSIS"
|
||||
objcopy [ \-F \fIbfdname\fR | --target=\fIbfdname\fR ]
|
||||
[ \-I \fIbfdname\fR | --input-target=\fIbfdname\fR ]
|
||||
[ \-O \fIbfdname\fR | --output-target=\fIbfdname\fR ]
|
||||
[ \-B \fIbfdarch\fR | --binary-architecture=\fIbfdarch\fR ]
|
||||
[ \-S | --strip-all ] [ \-g | --strip-debug ]
|
||||
[ \-K \fIsymbolname\fR | --keep-symbol=\fIsymbolname\fR ]
|
||||
[ \-N \fIsymbolname\fR | --strip-symbol=\fIsymbolname\fR ]
|
||||
[ \-L \fIsymbolname\fR | --localize-symbol=\fIsymbolname\fR ]
|
||||
[ \-W \fIsymbolname\fR | --weaken-symbol=\fIsymbolname\fR ]
|
||||
[ \-x | --discard-all ] [ \-X | --discard-locals ]
|
||||
[ \-b \fIbyte\fR | --byte=\fIbyte\fR ]
|
||||
[ \-i \fIinterleave\fR | --interleave=\fIinterleave\fR ]
|
||||
[ \-j \fIsectionname\fR | --only-section=\fIsectionname\fR ]
|
||||
[ \-R \fIsectionname\fR | --remove-section=\fIsectionname\fR ]
|
||||
[ \-p | --preserve-dates ] [ --debugging ]
|
||||
[ --gap-fill=\fIval\fR ] [ --pad-to=\fIaddress\fR ]
|
||||
[ --set-start=\fIval\fR ] [ --adjust-start=\fIincr\fR ]
|
||||
[ --change-addresses=\fIincr\fR ]
|
||||
[ --change-section-address \fIsection\fR{=,+,\-}\fIval\fR ]
|
||||
[ --change-section-lma \fIsection\fR{=,+,\-}\fIval\fR ]
|
||||
[ --change-section-vma \fIsection\fR{=,+,\-}\fIval\fR ]
|
||||
[ --change-warnings ] [ --no-change-warnings ]
|
||||
[ --set-section-flags \fIsection\fR=\fIflags\fR ]
|
||||
[ --add-section \fIsectionname\fR=\fIfilename\fR ]
|
||||
[ --change-leading-char ] [ --remove-leading-char ]
|
||||
[ --srec-len=\fIival\fR ] [ --srec-forceS3 ]
|
||||
[ --redefine-sym \fIold\fR=\fInew\fR ] [ --weaken ]
|
||||
[ \-v | --verbose ] [ \-V | --version ] [ --help ]
|
||||
.IX Header "SYNOPSIS"
|
||||
objcopy [ \-F \fIbfdname\fR | \-\-target=\fIbfdname\fR ]
|
||||
[ \-I \fIbfdname\fR | \-\-input-target=\fIbfdname\fR ]
|
||||
[ \-O \fIbfdname\fR | \-\-output-target=\fIbfdname\fR ]
|
||||
[ \-B \fIbfdarch\fR | \-\-binary-architecture=\fIbfdarch\fR ]
|
||||
[ \-S | \-\-strip-all ] [ \-g | \-\-strip-debug ]
|
||||
[ \-K \fIsymbolname\fR | \-\-keep-symbol=\fIsymbolname\fR ]
|
||||
[ \-N \fIsymbolname\fR | \-\-strip-symbol=\fIsymbolname\fR ]
|
||||
[ \-G \fIsymbolname\fR | \-\-keep-global-symbol=\fIsymbolname\fR]
|
||||
[ \-L \fIsymbolname\fR | \-\-localize-symbol=\fIsymbolname\fR ]
|
||||
[ \-W \fIsymbolname\fR | \-\-weaken-symbol=\fIsymbolname\fR ]
|
||||
[ \-x | \-\-discard-all ] [ \-X | \-\-discard-locals ]
|
||||
[ \-b \fIbyte\fR | \-\-byte=\fIbyte\fR ]
|
||||
[ \-i \fIinterleave\fR | \-\-interleave=\fIinterleave\fR ]
|
||||
[ \-j \fIsectionname\fR | \-\-only-section=\fIsectionname\fR ]
|
||||
[ \-R \fIsectionname\fR | \-\-remove-section=\fIsectionname\fR ]
|
||||
[ \-p | \-\-preserve-dates ] [ \-\-debugging ]
|
||||
[ \-\-gap-fill=\fIval\fR ] [ \-\-pad-to=\fIaddress\fR ]
|
||||
[ \-\-set-start=\fIval\fR ] [ \-\-adjust-start=\fIincr\fR ]
|
||||
[ \-\-change-addresses=\fIincr\fR ]
|
||||
[ \-\-change-section-address \fIsection\fR{=,+,\-}\fIval\fR ]
|
||||
[ \-\-change-section-lma \fIsection\fR{=,+,\-}\fIval\fR ]
|
||||
[ \-\-change-section-vma \fIsection\fR{=,+,\-}\fIval\fR ]
|
||||
[ \-\-change-warnings ] [ \-\-no-change-warnings ]
|
||||
[ \-\-set-section-flags \fIsection\fR=\fIflags\fR ]
|
||||
[ \-\-add-section \fIsectionname\fR=\fIfilename\fR ]
|
||||
[ \-\-change-leading-char ] [ \-\-remove-leading-char ]
|
||||
[ \-\-srec-len=\fIival\fR ] [ \-\-srec-forceS3 ]
|
||||
[ \-\-redefine-sym \fIold\fR=\fInew\fR ] [ \-\-weaken ]
|
||||
[ \-\-keep-symbols=\fIfilename\fR ]
|
||||
[ \-\-strip-symbols=\fIfilename\fR ]
|
||||
[ \-\-keep-global-symbols=\fIfilename\fR ]
|
||||
[ \-\-localize-symbols=\fIfilename\fR ]
|
||||
[ \-\-weaken-symbols=\fIfilename\fR ]
|
||||
[ \-v | \-\-verbose ] [ \-V | \-\-version ] [ \-\-help ]
|
||||
\fIinfile\fR [\fIoutfile\fR]
|
||||
.SH "DESCRIPTION"
|
||||
The GNU \f(CWobjcopy\fR utility copies the contents of an object
|
||||
file to another. \f(CWobjcopy\fR uses the GNU BFD Library to
|
||||
.IX Header "DESCRIPTION"
|
||||
The \s-1GNU\s0 \f(CW\*(C`objcopy\*(C'\fR utility copies the contents of an object
|
||||
file to another. \f(CW\*(C`objcopy\*(C'\fR uses the \s-1GNU\s0 \s-1BFD\s0 Library to
|
||||
read and write the object files. It can write the destination object
|
||||
file in a format different from that of the source object file. The
|
||||
exact behavior of \f(CWobjcopy\fR is controlled by command-line options.
|
||||
Note that \f(CWobjcopy\fR should be able to copy a fully linked file
|
||||
exact behavior of \f(CW\*(C`objcopy\*(C'\fR is controlled by command-line options.
|
||||
Note that \f(CW\*(C`objcopy\*(C'\fR should be able to copy a fully linked file
|
||||
between any two formats. However, copying a relocatable object file
|
||||
between any two formats may not work as expected.
|
||||
.PP
|
||||
\f(CWobjcopy\fR creates temporary files to do its translations and
|
||||
deletes them afterward. \f(CWobjcopy\fR uses BFD to do all its
|
||||
translation work; it has access to all the formats described in BFD
|
||||
\&\f(CW\*(C`objcopy\*(C'\fR creates temporary files to do its translations and
|
||||
deletes them afterward. \f(CW\*(C`objcopy\*(C'\fR uses \s-1BFD\s0 to do all its
|
||||
translation work; it has access to all the formats described in \s-1BFD\s0
|
||||
and thus is able to recognize most formats without being told
|
||||
explicitly.
|
||||
.PP
|
||||
\f(CWobjcopy\fR can be used to generate S\-records by using an output
|
||||
\&\f(CW\*(C`objcopy\*(C'\fR can be used to generate S-records by using an output
|
||||
target of \fBsrec\fR (e.g., use \fB\-O srec\fR).
|
||||
.PP
|
||||
\f(CWobjcopy\fR can be used to generate a raw binary file by using an
|
||||
\&\f(CW\*(C`objcopy\*(C'\fR can be used to generate a raw binary file by using an
|
||||
output target of \fBbinary\fR (e.g., use \fB\-O binary\fR). When
|
||||
\f(CWobjcopy\fR generates a raw binary file, it will essentially produce
|
||||
\&\f(CW\*(C`objcopy\*(C'\fR generates a raw binary file, it will essentially produce
|
||||
a memory dump of the contents of the input object file. All symbols and
|
||||
relocation information will be discarded. The memory dump will start at
|
||||
the load address of the lowest section copied into the output file.
|
||||
.PP
|
||||
When generating an S\-record or a raw binary file, it may be helpful to
|
||||
When generating an S-record or a raw binary file, it may be helpful to
|
||||
use \fB\-S\fR to remove sections containing debugging information. In
|
||||
some cases \fB\-R\fR will be useful to remove sections which contain
|
||||
information that is not needed by the binary file.
|
||||
.PP
|
||||
Note \- \f(CWobjcopy\fR is not able to change the endianness of its input
|
||||
Note \- \f(CW\*(C`objcopy\*(C'\fR is not able to change the endianness of its input
|
||||
files. If the input format has an endianness, (some formats do not),
|
||||
\f(CWobjcopy\fR can only copy the inputs into file formats that have the
|
||||
\&\f(CW\*(C`objcopy\*(C'\fR can only copy the inputs into file formats that have the
|
||||
same endianness or which have no endianness (eg \fBsrec\fR).
|
||||
.SH "OPTIONS"
|
||||
.Ip "\f(CW\fIinfile\fR\fR" 4
|
||||
.Ip "\f(CW\fIoutfile\fR\fR" 4
|
||||
.IX Header "OPTIONS"
|
||||
.Ip "\f(CW\*(C`\f(CIinfile\f(CW\*(C'\fR" 4
|
||||
.IX Item "infile"
|
||||
.Ip "\f(CW\*(C`\f(CIoutfile\f(CW\*(C'\fR" 4
|
||||
.IX Item "outfile"
|
||||
The input and output files, respectively.
|
||||
If you do not specify \fIoutfile\fR, \f(CWobjcopy\fR creates a
|
||||
If you do not specify \fIoutfile\fR, \f(CW\*(C`objcopy\*(C'\fR creates a
|
||||
temporary file and destructively renames the result with
|
||||
the name of \fIinfile\fR.
|
||||
.Ip "\f(CW-I \fIbfdname\fR \fR" 4
|
||||
.Ip "\f(CW--input-target=\fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-I \f(CIbfdname\f(CW \*(C'\fR" 4
|
||||
.IX Item "-I bfdname "
|
||||
.Ip "\f(CW\*(C`\-\-input\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--input-target=bfdname"
|
||||
Consider the source file's object format to be \fIbfdname\fR, rather than
|
||||
attempting to deduce it.
|
||||
.Ip "\f(CW-O \fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW--output-target=\fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-O \f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-O bfdname"
|
||||
.Ip "\f(CW\*(C`\-\-output\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--output-target=bfdname"
|
||||
Write the output file using the object format \fIbfdname\fR.
|
||||
.Ip "\f(CW-F \fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW--target=\fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-F \f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-F bfdname"
|
||||
.Ip "\f(CW\*(C`\-\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--target=bfdname"
|
||||
Use \fIbfdname\fR as the object format for both the input and the output
|
||||
file; i.e., simply transfer data from source to destination with no
|
||||
translation.
|
||||
.Ip "\f(CW-B \fIbfdarch\fR\fR" 4
|
||||
.Ip "\f(CW--binary-architecture=\fIbfdarch\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-B \f(CIbfdarch\f(CW\*(C'\fR" 4
|
||||
.IX Item "-B bfdarch"
|
||||
.Ip "\f(CW\*(C`\-\-binary\-architecture=\f(CIbfdarch\f(CW\*(C'\fR" 4
|
||||
.IX Item "--binary-architecture=bfdarch"
|
||||
Useful when transforming a raw binary input file into an object file.
|
||||
In this case the output architecture can be set to \fIbfdarch\fR. This
|
||||
option will be ignored if the input file has a known \fIbfdarch\fR. You
|
||||
@ -285,349 +254,295 @@ symbols that are created by the conversion process. These symbols are
|
||||
called _binary_\fIobjfile\fR_start, _binary_\fIobjfile\fR_end and
|
||||
_binary_\fIobjfile\fR_size. e.g. you can transform a picture file into
|
||||
an object file and then access it in your code using these symbols.
|
||||
.Ip "\f(CW-j \fIsectionname\fR\fR" 4
|
||||
.Ip "\f(CW--only-section=\fIsectionname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-j \f(CIsectionname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-j sectionname"
|
||||
.Ip "\f(CW\*(C`\-\-only\-section=\f(CIsectionname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--only-section=sectionname"
|
||||
Copy only the named section from the input file to the output file.
|
||||
This option may be given more than once. Note that using this option
|
||||
inappropriately may make the output file unusable.
|
||||
.Ip "\f(CW-R \fIsectionname\fR\fR" 4
|
||||
.Ip "\f(CW--remove-section=\fIsectionname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-R \f(CIsectionname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-R sectionname"
|
||||
.Ip "\f(CW\*(C`\-\-remove\-section=\f(CIsectionname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--remove-section=sectionname"
|
||||
Remove any section named \fIsectionname\fR from the output file. This
|
||||
option may be given more than once. Note that using this option
|
||||
inappropriately may make the output file unusable.
|
||||
.Ip "\f(CW-S\fR" 4
|
||||
.Ip "\f(CW--strip-all\fR" 4
|
||||
.Ip "\f(CW\*(C`\-S\*(C'\fR" 4
|
||||
.IX Item "-S"
|
||||
.Ip "\f(CW\*(C`\-\-strip\-all\*(C'\fR" 4
|
||||
.IX Item "--strip-all"
|
||||
Do not copy relocation and symbol information from the source file.
|
||||
.Ip "\f(CW-g\fR" 4
|
||||
.Ip "\f(CW--strip-debug\fR" 4
|
||||
.Ip "\f(CW\*(C`\-g\*(C'\fR" 4
|
||||
.IX Item "-g"
|
||||
.Ip "\f(CW\*(C`\-\-strip\-debug\*(C'\fR" 4
|
||||
.IX Item "--strip-debug"
|
||||
Do not copy debugging symbols from the source file.
|
||||
.Ip "\f(CW--strip-unneeded\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-strip\-unneeded\*(C'\fR" 4
|
||||
.IX Item "--strip-unneeded"
|
||||
Strip all symbols that are not needed for relocation processing.
|
||||
.Ip "\f(CW-K \fIsymbolname\fR\fR" 4
|
||||
.Ip "\f(CW--keep-symbol=\fIsymbolname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-K \f(CIsymbolname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-K symbolname"
|
||||
.Ip "\f(CW\*(C`\-\-keep\-symbol=\f(CIsymbolname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--keep-symbol=symbolname"
|
||||
Copy only symbol \fIsymbolname\fR from the source file. This option may
|
||||
be given more than once.
|
||||
.Ip "\f(CW-N \fIsymbolname\fR\fR" 4
|
||||
.Ip "\f(CW--strip-symbol=\fIsymbolname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-N \f(CIsymbolname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-N symbolname"
|
||||
.Ip "\f(CW\*(C`\-\-strip\-symbol=\f(CIsymbolname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--strip-symbol=symbolname"
|
||||
Do not copy symbol \fIsymbolname\fR from the source file. This option
|
||||
may be given more than once.
|
||||
.Ip "\f(CW-L \fIsymbolname\fR\fR" 4
|
||||
.Ip "\f(CW--localize-symbol=\fIsymbolname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-G \f(CIsymbolname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-G symbolname"
|
||||
.Ip "\f(CW\*(C`\-\-keep\-global\-symbol=\f(CIsymbolname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--keep-global-symbol=symbolname"
|
||||
Keep only symbol \fIsymbolname\fR global. Make all other symbols local
|
||||
to the file, so that they are not visible externally. This option may
|
||||
be given more than once.
|
||||
.Ip "\f(CW\*(C`\-L \f(CIsymbolname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-L symbolname"
|
||||
.Ip "\f(CW\*(C`\-\-localize\-symbol=\f(CIsymbolname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--localize-symbol=symbolname"
|
||||
Make symbol \fIsymbolname\fR local to the file, so that it is not
|
||||
visible externally. This option may be given more than once.
|
||||
.Ip "\f(CW-W \fIsymbolname\fR\fR" 4
|
||||
.Ip "\f(CW--weaken-symbol=\fIsymbolname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-W \f(CIsymbolname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-W symbolname"
|
||||
.Ip "\f(CW\*(C`\-\-weaken\-symbol=\f(CIsymbolname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--weaken-symbol=symbolname"
|
||||
Make symbol \fIsymbolname\fR weak. This option may be given more than once.
|
||||
.Ip "\f(CW-x\fR" 4
|
||||
.Ip "\f(CW--discard-all\fR" 4
|
||||
.Ip "\f(CW\*(C`\-x\*(C'\fR" 4
|
||||
.IX Item "-x"
|
||||
.Ip "\f(CW\*(C`\-\-discard\-all\*(C'\fR" 4
|
||||
.IX Item "--discard-all"
|
||||
Do not copy non-global symbols from the source file.
|
||||
.Ip "\f(CW-X\fR" 4
|
||||
.Ip "\f(CW--discard-locals\fR" 4
|
||||
.Ip "\f(CW\*(C`\-X\*(C'\fR" 4
|
||||
.IX Item "-X"
|
||||
.Ip "\f(CW\*(C`\-\-discard\-locals\*(C'\fR" 4
|
||||
.IX Item "--discard-locals"
|
||||
Do not copy compiler-generated local symbols.
|
||||
(These usually start with \fBL\fR or \fB.\fR.)
|
||||
.Ip "\f(CW-b \fIbyte\fR\fR" 4
|
||||
.Ip "\f(CW--byte=\fIbyte\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-b \f(CIbyte\f(CW\*(C'\fR" 4
|
||||
.IX Item "-b byte"
|
||||
.Ip "\f(CW\*(C`\-\-byte=\f(CIbyte\f(CW\*(C'\fR" 4
|
||||
.IX Item "--byte=byte"
|
||||
Keep only every \fIbyte\fRth byte of the input file (header data is not
|
||||
affected). \fIbyte\fR can be in the range from 0 to \fIinterleave\fR\-1,
|
||||
where \fIinterleave\fR is given by the \fB\-i\fR or \fB--interleave\fR
|
||||
where \fIinterleave\fR is given by the \fB\-i\fR or \fB\*(--interleave\fR
|
||||
option, or the default of 4. This option is useful for creating files
|
||||
to program \s-1ROM\s0. It is typically used with an \f(CWsrec\fR output
|
||||
to program \s-1ROM\s0. It is typically used with an \f(CW\*(C`srec\*(C'\fR output
|
||||
target.
|
||||
.Ip "\f(CW-i \fIinterleave\fR\fR" 4
|
||||
.Ip "\f(CW--interleave=\fIinterleave\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-i \f(CIinterleave\f(CW\*(C'\fR" 4
|
||||
.IX Item "-i interleave"
|
||||
.Ip "\f(CW\*(C`\-\-interleave=\f(CIinterleave\f(CW\*(C'\fR" 4
|
||||
.IX Item "--interleave=interleave"
|
||||
Only copy one out of every \fIinterleave\fR bytes. Select which byte to
|
||||
copy with the \fI\-b\fR or \fB--byte\fR option. The default is 4.
|
||||
\f(CWobjcopy\fR ignores this option if you do not specify either \fB\-b\fR or
|
||||
\fB--byte\fR.
|
||||
.Ip "\f(CW-p\fR" 4
|
||||
.Ip "\f(CW--preserve-dates\fR" 4
|
||||
copy with the \fI\-b\fR or \fB\*(--byte\fR option. The default is 4.
|
||||
\&\f(CW\*(C`objcopy\*(C'\fR ignores this option if you do not specify either \fB\-b\fR or
|
||||
\&\fB\*(--byte\fR.
|
||||
.Ip "\f(CW\*(C`\-p\*(C'\fR" 4
|
||||
.IX Item "-p"
|
||||
.Ip "\f(CW\*(C`\-\-preserve\-dates\*(C'\fR" 4
|
||||
.IX Item "--preserve-dates"
|
||||
Set the access and modification dates of the output file to be the same
|
||||
as those of the input file.
|
||||
.Ip "\f(CW--debugging\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-debugging\*(C'\fR" 4
|
||||
.IX Item "--debugging"
|
||||
Convert debugging information, if possible. This is not the default
|
||||
because only certain debugging formats are supported, and the
|
||||
conversion process can be time consuming.
|
||||
.Ip "\f(CW--gap-fill \fIval\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-gap\-fill \f(CIval\f(CW\*(C'\fR" 4
|
||||
.IX Item "--gap-fill val"
|
||||
Fill gaps between sections with \fIval\fR. This operation applies to
|
||||
the \fIload address\fR (\s-1LMA\s0) of the sections. It is done by increasing
|
||||
the size of the section with the lower address, and filling in the extra
|
||||
space created with \fIval\fR.
|
||||
.Ip "\f(CW--pad-to \fIaddress\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-pad\-to \f(CIaddress\f(CW\*(C'\fR" 4
|
||||
.IX Item "--pad-to address"
|
||||
Pad the output file up to the load address \fIaddress\fR. This is
|
||||
done by increasing the size of the last section. The extra space is
|
||||
filled in with the value specified by \fB--gap-fill\fR (default zero).
|
||||
.Ip "\f(CW--set-start \fIval\fR\fR" 4
|
||||
filled in with the value specified by \fB\*(--gap-fill\fR (default zero).
|
||||
.Ip "\f(CW\*(C`\-\-set\-start \f(CIval\f(CW\*(C'\fR" 4
|
||||
.IX Item "--set-start val"
|
||||
Set the start address of the new file to \fIval\fR. Not all object file
|
||||
formats support setting the start address.
|
||||
.Ip "\f(CW--change-start \fIincr\fR\fR" 4
|
||||
.Ip "\f(CW--adjust-start \fIincr\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-change\-start \f(CIincr\f(CW\*(C'\fR" 4
|
||||
.IX Item "--change-start incr"
|
||||
.Ip "\f(CW\*(C`\-\-adjust\-start \f(CIincr\f(CW\*(C'\fR" 4
|
||||
.IX Item "--adjust-start incr"
|
||||
Change the start address by adding \fIincr\fR. Not all object file
|
||||
formats support setting the start address.
|
||||
.Ip "\f(CW--change-addresses \fIincr\fR\fR" 4
|
||||
.Ip "\f(CW--adjust-vma \fIincr\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-change\-addresses \f(CIincr\f(CW\*(C'\fR" 4
|
||||
.IX Item "--change-addresses incr"
|
||||
.Ip "\f(CW\*(C`\-\-adjust\-vma \f(CIincr\f(CW\*(C'\fR" 4
|
||||
.IX Item "--adjust-vma incr"
|
||||
Change the \s-1VMA\s0 and \s-1LMA\s0 addresses of all sections, as well as the start
|
||||
address, by adding \fIincr\fR. Some object file formats do not permit
|
||||
section addresses to be changed arbitrarily. Note that this does not
|
||||
relocate the sections; if the program expects sections to be loaded at a
|
||||
certain address, and this option is used to change the sections such
|
||||
that they are loaded at a different address, the program may fail.
|
||||
.Ip "\f(CW--change-section-address \fIsection\fR{=,+,-}\fIval\fR\fR" 4
|
||||
.Ip "\f(CW--adjust-section-vma \fIsection\fR{=,+,-}\fIval\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-change\-section\-address \f(CIsection\f(CW{=,+,\-}\f(CIval\f(CW\*(C'\fR" 4
|
||||
.IX Item "--change-section-address section{=,+,-}val"
|
||||
.Ip "\f(CW\*(C`\-\-adjust\-section\-vma \f(CIsection\f(CW{=,+,\-}\f(CIval\f(CW\*(C'\fR" 4
|
||||
.IX Item "--adjust-section-vma section{=,+,-}val"
|
||||
Set or change both the \s-1VMA\s0 address and the \s-1LMA\s0 address of the named
|
||||
\fIsection\fR. If \fB=\fR is used, the section address is set to
|
||||
\fIval\fR. Otherwise, \fIval\fR is added to or subtracted from the
|
||||
section address. See the comments under \fB--change-addresses\fR,
|
||||
\&\fIsection\fR. If \fB=\fR is used, the section address is set to
|
||||
\&\fIval\fR. Otherwise, \fIval\fR is added to or subtracted from the
|
||||
section address. See the comments under \fB\*(--change-addresses\fR,
|
||||
above. If \fIsection\fR does not exist in the input file, a warning will
|
||||
be issued, unless \fB--no-change-warnings\fR is used.
|
||||
.Ip "\f(CW--change-section-lma \fIsection\fR{=,+,-}\fIval\fR\fR" 4
|
||||
be issued, unless \fB\*(--no-change-warnings\fR is used.
|
||||
.Ip "\f(CW\*(C`\-\-change\-section\-lma \f(CIsection\f(CW{=,+,\-}\f(CIval\f(CW\*(C'\fR" 4
|
||||
.IX Item "--change-section-lma section{=,+,-}val"
|
||||
Set or change the \s-1LMA\s0 address of the named \fIsection\fR. The \s-1LMA\s0
|
||||
address is the address where the section will be loaded into memory at
|
||||
program load time. Normally this is the same as the \s-1VMA\s0 address, which
|
||||
is the address of the section at program run time, but on some systems,
|
||||
especially those where a program is held in \s-1ROM\s0, the two can be
|
||||
different. If \fB=\fR is used, the section address is set to
|
||||
\fIval\fR. Otherwise, \fIval\fR is added to or subtracted from the
|
||||
section address. See the comments under \fB--change-addresses\fR,
|
||||
\&\fIval\fR. Otherwise, \fIval\fR is added to or subtracted from the
|
||||
section address. See the comments under \fB\*(--change-addresses\fR,
|
||||
above. If \fIsection\fR does not exist in the input file, a warning
|
||||
will be issued, unless \fB--no-change-warnings\fR is used.
|
||||
.Ip "\f(CW--change-section-vma \fIsection\fR{=,+,-}\fIval\fR\fR" 4
|
||||
will be issued, unless \fB\*(--no-change-warnings\fR is used.
|
||||
.Ip "\f(CW\*(C`\-\-change\-section\-vma \f(CIsection\f(CW{=,+,\-}\f(CIval\f(CW\*(C'\fR" 4
|
||||
.IX Item "--change-section-vma section{=,+,-}val"
|
||||
Set or change the \s-1VMA\s0 address of the named \fIsection\fR. The \s-1VMA\s0
|
||||
address is the address where the section will be located once the
|
||||
program has started executing. Normally this is the same as the \s-1LMA\s0
|
||||
address, which is the address where the section will be loaded into
|
||||
memory, but on some systems, especially those where a program is held in
|
||||
\s-1ROM\s0, the two can be different. If \fB=\fR is used, the section address
|
||||
\&\s-1ROM\s0, the two can be different. If \fB=\fR is used, the section address
|
||||
is set to \fIval\fR. Otherwise, \fIval\fR is added to or subtracted
|
||||
from the section address. See the comments under
|
||||
\fB--change-addresses\fR, above. If \fIsection\fR does not exist in
|
||||
\&\fB\*(--change-addresses\fR, above. If \fIsection\fR does not exist in
|
||||
the input file, a warning will be issued, unless
|
||||
\fB--no-change-warnings\fR is used.
|
||||
.Ip "\f(CW--change-warnings\fR" 4
|
||||
.Ip "\f(CW--adjust-warnings\fR" 4
|
||||
If \fB--change-section-address\fR or \fB--change-section-lma\fR or
|
||||
\fB--change-section-vma\fR is used, and the named section does not
|
||||
\&\fB\*(--no-change-warnings\fR is used.
|
||||
.Ip "\f(CW\*(C`\-\-change\-warnings\*(C'\fR" 4
|
||||
.IX Item "--change-warnings"
|
||||
.Ip "\f(CW\*(C`\-\-adjust\-warnings\*(C'\fR" 4
|
||||
.IX Item "--adjust-warnings"
|
||||
If \fB\*(--change-section-address\fR or \fB\*(--change-section-lma\fR or
|
||||
\&\fB\*(--change-section-vma\fR is used, and the named section does not
|
||||
exist, issue a warning. This is the default.
|
||||
.Ip "\f(CW--no-change-warnings\fR" 4
|
||||
.Ip "\f(CW--no-adjust-warnings\fR" 4
|
||||
Do not issue a warning if \fB--change-section-address\fR or
|
||||
\fB--adjust-section-lma\fR or \fB--adjust-section-vma\fR is used, even
|
||||
.Ip "\f(CW\*(C`\-\-no\-change\-warnings\*(C'\fR" 4
|
||||
.IX Item "--no-change-warnings"
|
||||
.Ip "\f(CW\*(C`\-\-no\-adjust\-warnings\*(C'\fR" 4
|
||||
.IX Item "--no-adjust-warnings"
|
||||
Do not issue a warning if \fB\*(--change-section-address\fR or
|
||||
\&\fB\*(--adjust-section-lma\fR or \fB\*(--adjust-section-vma\fR is used, even
|
||||
if the named section does not exist.
|
||||
.Ip "\f(CW--set-section-flags \fIsection\fR=\fIflags\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-set\-section\-flags \f(CIsection\f(CW=\f(CIflags\f(CW\*(C'\fR" 4
|
||||
.IX Item "--set-section-flags section=flags"
|
||||
Set the flags for the named section. The \fIflags\fR argument is a
|
||||
comma separated string of flag names. The recognized names are
|
||||
\fBalloc\fR, \fBcontents\fR, \fBload\fR, \fBnoload\fR,
|
||||
\fBreadonly\fR, \fBcode\fR, \fBdata\fR, \fBrom\fR, \fBshare\fR, and
|
||||
\fBdebug\fR. You can set the \fBcontents\fR flag for a section which
|
||||
\&\fBalloc\fR, \fBcontents\fR, \fBload\fR, \fBnoload\fR,
|
||||
\&\fBreadonly\fR, \fBcode\fR, \fBdata\fR, \fBrom\fR, \fBshare\fR, and
|
||||
\&\fBdebug\fR. You can set the \fBcontents\fR flag for a section which
|
||||
does not have contents, but it is not meaningful to clear the
|
||||
\fBcontents\fR flag of a section which does have contents\*(--just remove
|
||||
\&\fBcontents\fR flag of a section which does have contents\*(--just remove
|
||||
the section instead. Not all flags are meaningful for all object file
|
||||
formats.
|
||||
.Ip "\f(CW--add-section \fIsectionname\fR=\fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-add\-section \f(CIsectionname\f(CW=\f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "--add-section sectionname=filename"
|
||||
Add a new section named \fIsectionname\fR while copying the file. The
|
||||
contents of the new section are taken from the file \fIfilename\fR. The
|
||||
size of the section will be the size of the file. This option only
|
||||
works on file formats which can support sections with arbitrary names.
|
||||
.Ip "\f(CW--change-leading-char\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-change\-leading\-char\*(C'\fR" 4
|
||||
.IX Item "--change-leading-char"
|
||||
Some object file formats use special characters at the start of
|
||||
symbols. The most common such character is underscore, which compilers
|
||||
often add before every symbol. This option tells \f(CWobjcopy\fR to
|
||||
often add before every symbol. This option tells \f(CW\*(C`objcopy\*(C'\fR to
|
||||
change the leading character of every symbol when it converts between
|
||||
object file formats. If the object file formats use the same leading
|
||||
character, this option has no effect. Otherwise, it will add a
|
||||
character, or remove a character, or change a character, as
|
||||
appropriate.
|
||||
.Ip "\f(CW--remove-leading-char\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-remove\-leading\-char\*(C'\fR" 4
|
||||
.IX Item "--remove-leading-char"
|
||||
If the first character of a global symbol is a special symbol leading
|
||||
character used by the object file format, remove the character. The
|
||||
most common symbol leading character is underscore. This option will
|
||||
remove a leading underscore from all global symbols. This can be useful
|
||||
if you want to link together objects of different file formats with
|
||||
different conventions for symbol names. This is different from
|
||||
\f(CW--change-leading-char\fR because it always changes the symbol name
|
||||
\&\f(CW\*(C`\-\-change\-leading\-char\*(C'\fR because it always changes the symbol name
|
||||
when appropriate, regardless of the object file format of the output
|
||||
file.
|
||||
.Ip "\f(CW--srec-len=\fIival\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-srec\-len=\f(CIival\f(CW\*(C'\fR" 4
|
||||
.IX Item "--srec-len=ival"
|
||||
Meaningful only for srec output. Set the maximum length of the Srecords
|
||||
being produced to \fIival\fR. This length covers both address, data and
|
||||
crc fields.
|
||||
.Ip "\f(CW--srec-forceS3\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-srec\-forceS3\*(C'\fR" 4
|
||||
.IX Item "--srec-forceS3"
|
||||
Meaningful only for srec output. Avoid generation of S1/S2 records,
|
||||
creating S3-only record format.
|
||||
.Ip "\f(CW--redefine-sym \fIold\fR=\fInew\fR\fR" 4
|
||||
creating S3\-only record format.
|
||||
.Ip "\f(CW\*(C`\-\-redefine\-sym \f(CIold\f(CW=\f(CInew\f(CW\*(C'\fR" 4
|
||||
.IX Item "--redefine-sym old=new"
|
||||
Change the name of a symbol \fIold\fR, to \fInew\fR. This can be useful
|
||||
when one is trying link two things together for which you have no
|
||||
source, and there are name collisions.
|
||||
.Ip "\f(CW--weaken\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-weaken\*(C'\fR" 4
|
||||
.IX Item "--weaken"
|
||||
Change all global symbols in the file to be weak. This can be useful
|
||||
when building an object which will be linked against other objects using
|
||||
the \f(CW-R\fR option to the linker. This option is only effective when
|
||||
the \f(CW\*(C`\-R\*(C'\fR option to the linker. This option is only effective when
|
||||
using an object file format which supports weak symbols.
|
||||
.Ip "\f(CW-V\fR" 4
|
||||
.Ip "\f(CW--version\fR" 4
|
||||
Show the version number of \f(CWobjcopy\fR.
|
||||
.Ip "\f(CW-v\fR" 4
|
||||
.Ip "\f(CW--verbose\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-keep\-symbols=\f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "--keep-symbols=filename"
|
||||
Apply \fB\*(--keep-symbol\fR option to each symbol listed in the file
|
||||
\&\fIfilename\fR. \fIfilename\fR is simply a flat file, with one symbol
|
||||
name per line. Line comments may be introduced by the hash character.
|
||||
This option may be given more than once.
|
||||
.Ip "\f(CW\*(C`\-\-strip\-symbols=\f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "--strip-symbols=filename"
|
||||
Apply \fB\*(--strip-symbol\fR option to each symbol listed in the file
|
||||
\&\fIfilename\fR. \fIfilename\fR is simply a flat file, with one symbol
|
||||
name per line. Line comments may be introduced by the hash character.
|
||||
This option may be given more than once.
|
||||
.Ip "\f(CW\*(C`\-\-keep\-global\-symbols=\f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "--keep-global-symbols=filename"
|
||||
Apply \fB\*(--keep-global-symbol\fR option to each symbol listed in the
|
||||
file \fIfilename\fR. \fIfilename\fR is simply a flat file, with one
|
||||
symbol name per line. Line comments may be introduced by the hash
|
||||
character. This option may be given more than once.
|
||||
.Ip "\f(CW\*(C`\-\-localize\-symbols=\f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "--localize-symbols=filename"
|
||||
Apply \fB\*(--localize-symbol\fR option to each symbol listed in the file
|
||||
\&\fIfilename\fR. \fIfilename\fR is simply a flat file, with one symbol
|
||||
name per line. Line comments may be introduced by the hash character.
|
||||
This option may be given more than once.
|
||||
.Ip "\f(CW\*(C`\-\-weaken\-symbols=\f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "--weaken-symbols=filename"
|
||||
Apply \fB\*(--weaken-symbol\fR option to each symbol listed in the file
|
||||
\&\fIfilename\fR. \fIfilename\fR is simply a flat file, with one symbol
|
||||
name per line. Line comments may be introduced by the hash character.
|
||||
This option may be given more than once.
|
||||
.Ip "\f(CW\*(C`\-V\*(C'\fR" 4
|
||||
.IX Item "-V"
|
||||
.Ip "\f(CW\*(C`\-\-version\*(C'\fR" 4
|
||||
.IX Item "--version"
|
||||
Show the version number of \f(CW\*(C`objcopy\*(C'\fR.
|
||||
.Ip "\f(CW\*(C`\-v\*(C'\fR" 4
|
||||
.IX Item "-v"
|
||||
.Ip "\f(CW\*(C`\-\-verbose\*(C'\fR" 4
|
||||
.IX Item "--verbose"
|
||||
Verbose output: list all object files modified. In the case of
|
||||
archives, \fBobjcopy \-V\fR lists all members of the archive.
|
||||
.Ip "\f(CW--help\fR" 4
|
||||
Show a summary of the options to \f(CWobjcopy\fR.
|
||||
.Ip "\f(CW\*(C`\-\-help\*(C'\fR" 4
|
||||
.IX Item "--help"
|
||||
Show a summary of the options to \f(CW\*(C`objcopy\*(C'\fR.
|
||||
.SH "SEE ALSO"
|
||||
\fIld\fR\|(1), \fIobjdump\fR\|(1), and the Info entries for \fIbinutils\fR.
|
||||
.IX Header "SEE ALSO"
|
||||
\&\fIld\fR\|(1), \fIobjdump\fR\|(1), and the Info entries for \fIbinutils\fR.
|
||||
.SH "COPYRIGHT"
|
||||
.IX Header "COPYRIGHT"
|
||||
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
|
||||
.PP
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||||
Back-Cover Texts. A copy of the license is included in the
|
||||
section entitled \*(L"GNU Free Documentation License\*(R".
|
||||
|
||||
.rn }` ''
|
||||
.IX Title "OBJCOPY.1 1"
|
||||
.IX Name "objcopy - copy and translate object files"
|
||||
|
||||
.IX Header "NAME"
|
||||
|
||||
.IX Header "SYNOPSIS"
|
||||
|
||||
.IX Header "DESCRIPTION"
|
||||
|
||||
.IX Header "OPTIONS"
|
||||
|
||||
.IX Item "\f(CW\fIinfile\fR\fR"
|
||||
|
||||
.IX Item "\f(CW\fIoutfile\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-I \fIbfdname\fR \fR"
|
||||
|
||||
.IX Item "\f(CW--input-target=\fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-O \fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--output-target=\fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-F \fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--target=\fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-B \fIbfdarch\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--binary-architecture=\fIbfdarch\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-j \fIsectionname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--only-section=\fIsectionname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-R \fIsectionname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--remove-section=\fIsectionname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-S\fR"
|
||||
|
||||
.IX Item "\f(CW--strip-all\fR"
|
||||
|
||||
.IX Item "\f(CW-g\fR"
|
||||
|
||||
.IX Item "\f(CW--strip-debug\fR"
|
||||
|
||||
.IX Item "\f(CW--strip-unneeded\fR"
|
||||
|
||||
.IX Item "\f(CW-K \fIsymbolname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--keep-symbol=\fIsymbolname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-N \fIsymbolname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--strip-symbol=\fIsymbolname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-L \fIsymbolname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--localize-symbol=\fIsymbolname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-W \fIsymbolname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--weaken-symbol=\fIsymbolname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-x\fR"
|
||||
|
||||
.IX Item "\f(CW--discard-all\fR"
|
||||
|
||||
.IX Item "\f(CW-X\fR"
|
||||
|
||||
.IX Item "\f(CW--discard-locals\fR"
|
||||
|
||||
.IX Item "\f(CW-b \fIbyte\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--byte=\fIbyte\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-i \fIinterleave\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--interleave=\fIinterleave\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-p\fR"
|
||||
|
||||
.IX Item "\f(CW--preserve-dates\fR"
|
||||
|
||||
.IX Item "\f(CW--debugging\fR"
|
||||
|
||||
.IX Item "\f(CW--gap-fill \fIval\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--pad-to \fIaddress\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--set-start \fIval\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--change-start \fIincr\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--adjust-start \fIincr\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--change-addresses \fIincr\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--adjust-vma \fIincr\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--change-section-address \fIsection\fR{=,+,-}\fIval\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--adjust-section-vma \fIsection\fR{=,+,-}\fIval\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--change-section-lma \fIsection\fR{=,+,-}\fIval\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--change-section-vma \fIsection\fR{=,+,-}\fIval\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--change-warnings\fR"
|
||||
|
||||
.IX Item "\f(CW--adjust-warnings\fR"
|
||||
|
||||
.IX Item "\f(CW--no-change-warnings\fR"
|
||||
|
||||
.IX Item "\f(CW--no-adjust-warnings\fR"
|
||||
|
||||
.IX Item "\f(CW--set-section-flags \fIsection\fR=\fIflags\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--add-section \fIsectionname\fR=\fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--change-leading-char\fR"
|
||||
|
||||
.IX Item "\f(CW--remove-leading-char\fR"
|
||||
|
||||
.IX Item "\f(CW--srec-len=\fIival\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--srec-forceS3\fR"
|
||||
|
||||
.IX Item "\f(CW--redefine-sym \fIold\fR=\fInew\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--weaken\fR"
|
||||
|
||||
.IX Item "\f(CW-V\fR"
|
||||
|
||||
.IX Item "\f(CW--version\fR"
|
||||
|
||||
.IX Item "\f(CW-v\fR"
|
||||
|
||||
.IX Item "\f(CW--verbose\fR"
|
||||
|
||||
.IX Item "\f(CW--help\fR"
|
||||
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
.IX Header "COPYRIGHT"
|
||||
|
||||
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
|
||||
|
||||
@ -57,6 +57,7 @@ static void copy_section PARAMS ((bfd *, asection *, PTR));
|
||||
static void get_sections PARAMS ((bfd *, asection *, PTR));
|
||||
static int compare_section_lma PARAMS ((const PTR, const PTR));
|
||||
static void add_specific_symbol PARAMS ((const char *, struct symlist **));
|
||||
static void add_specific_symbols PARAMS ((const char *, struct symlist **));
|
||||
static boolean is_specified_symbol PARAMS ((const char *, struct symlist *));
|
||||
static boolean is_strip_section PARAMS ((bfd *, asection *));
|
||||
static unsigned int filter_symbols
|
||||
@ -184,11 +185,13 @@ static boolean change_leading_char = false;
|
||||
|
||||
static boolean remove_leading_char = false;
|
||||
|
||||
/* List of symbols to strip, keep, localize, weaken, or redefine. */
|
||||
/* List of symbols to strip, keep, localize, keep-global, weaken,
|
||||
or redefine. */
|
||||
|
||||
static struct symlist *strip_specific_list = NULL;
|
||||
static struct symlist *keep_specific_list = NULL;
|
||||
static struct symlist *localize_specific_list = NULL;
|
||||
static struct symlist *keepglobal_specific_list = NULL;
|
||||
static struct symlist *weaken_specific_list = NULL;
|
||||
static struct redefine_node *redefine_sym_list = NULL;
|
||||
|
||||
@ -218,6 +221,11 @@ static boolean weaken = false;
|
||||
#define OPTION_REDEFINE_SYM (OPTION_WEAKEN + 1)
|
||||
#define OPTION_SREC_LEN (OPTION_REDEFINE_SYM + 1)
|
||||
#define OPTION_SREC_FORCES3 (OPTION_SREC_LEN + 1)
|
||||
#define OPTION_STRIP_SYMBOLS (OPTION_SREC_FORCES3 + 1)
|
||||
#define OPTION_KEEP_SYMBOLS (OPTION_STRIP_SYMBOLS + 1)
|
||||
#define OPTION_LOCALIZE_SYMBOLS (OPTION_KEEP_SYMBOLS + 1)
|
||||
#define OPTION_KEEPGLOBAL_SYMBOLS (OPTION_LOCALIZE_SYMBOLS + 1)
|
||||
#define OPTION_WEAKEN_SYMBOLS (OPTION_KEEPGLOBAL_SYMBOLS + 1)
|
||||
|
||||
/* Options to handle if running as "strip". */
|
||||
|
||||
@ -280,6 +288,7 @@ static struct option copy_options[] =
|
||||
{"pad-to", required_argument, 0, OPTION_PAD_TO},
|
||||
{"preserve-dates", no_argument, 0, 'p'},
|
||||
{"localize-symbol", required_argument, 0, 'L'},
|
||||
{"keep-global-symbol", required_argument, 0, 'G'},
|
||||
{"remove-leading-char", no_argument, 0, OPTION_REMOVE_LEADING_CHAR},
|
||||
{"remove-section", required_argument, 0, 'R'},
|
||||
{"set-section-flags", required_argument, 0, OPTION_SET_SECTION_FLAGS},
|
||||
@ -296,6 +305,11 @@ static struct option copy_options[] =
|
||||
{"redefine-sym", required_argument, 0, OPTION_REDEFINE_SYM},
|
||||
{"srec-len", required_argument, 0, OPTION_SREC_LEN},
|
||||
{"srec-forceS3", no_argument, 0, OPTION_SREC_FORCES3},
|
||||
{"keep-symbols", required_argument, 0, OPTION_KEEP_SYMBOLS},
|
||||
{"strip-symbols", required_argument, 0, OPTION_STRIP_SYMBOLS},
|
||||
{"keep-global-symbols", required_argument, 0, OPTION_KEEPGLOBAL_SYMBOLS},
|
||||
{"localize-symbols", required_argument, 0, OPTION_LOCALIZE_SYMBOLS},
|
||||
{"weaken-symbols", required_argument, 0, OPTION_WEAKEN_SYMBOLS},
|
||||
{0, no_argument, 0, 0}
|
||||
};
|
||||
|
||||
@ -341,6 +355,7 @@ copy_usage (stream, exit_status)
|
||||
-N --strip-symbol <name> Do not copy symbol <name>\n\
|
||||
-K --keep-symbol <name> Only copy symbol <name>\n\
|
||||
-L --localize-symbol <name> Force symbol <name> to be marked as a local\n\
|
||||
-G --keep-global-symbol <name> Localize all symbols except <name>\n\
|
||||
-W --weaken-symbol <name> Force symbol <name> to be marked as a weak\n\
|
||||
--weaken Force all global symbols to be marked as weak\n\
|
||||
-x --discard-all Remove all non-global symbols\n\
|
||||
@ -370,6 +385,11 @@ copy_usage (stream, exit_status)
|
||||
--redefine-sym <old>=<new> Redefine symbol name <old> to <new>\n\
|
||||
--srec-len <number> Restrict the length of generated Srecords\n\
|
||||
--srec-forceS3 Restrict the type of generated Srecords to S3\n\
|
||||
--strip-symbols <file> -N for all symbols listed in <file>\n\
|
||||
--keep-symbols <file> -K for all symbols listed in <file>\n\
|
||||
--localize-symbols <file> -L for all symbols listed in <file>\n\
|
||||
--keep-global-symbols <file> -G for all symbols listed in <file>\n\
|
||||
--weaken-symbols <file> -W for all symbols listed in <file>\n\
|
||||
-v --verbose List all object files modified\n\
|
||||
-V --version Display this program's version number\n\
|
||||
-h --help Display this output\n\
|
||||
@ -518,6 +538,122 @@ add_specific_symbol (name, list)
|
||||
*list = tmp_list;
|
||||
}
|
||||
|
||||
/* Add symbols listed in `filename' to strip_specific_list. */
|
||||
|
||||
#define IS_WHITESPACE(c) ((c) == ' ' || (c) == '\t')
|
||||
#define IS_LINE_TERMINATOR(c) ((c) == '\n' || (c) == '\r' || (c) == '\0')
|
||||
|
||||
static void
|
||||
add_specific_symbols (filename, list)
|
||||
const char *filename;
|
||||
struct symlist **list;
|
||||
{
|
||||
struct stat st;
|
||||
FILE * f;
|
||||
char * line;
|
||||
char * buffer;
|
||||
unsigned int line_count;
|
||||
|
||||
if (stat (filename, & st) < 0)
|
||||
fatal (_("cannot stat: %s: %s"), filename, strerror (errno));
|
||||
if (st.st_size == 0)
|
||||
return;
|
||||
|
||||
buffer = (char *) xmalloc (st.st_size + 2);
|
||||
f = fopen (filename, FOPEN_RT);
|
||||
if (f == NULL)
|
||||
fatal (_("cannot open: %s: %s"), filename, strerror (errno));
|
||||
|
||||
if (fread (buffer, 1, st.st_size, f) == 0 || ferror (f))
|
||||
fatal (_("%s: fread failed"), filename);
|
||||
|
||||
fclose (f);
|
||||
buffer [st.st_size] = '\n';
|
||||
buffer [st.st_size + 1] = '\0';
|
||||
|
||||
line_count = 1;
|
||||
|
||||
for (line = buffer; * line != '\0'; line ++)
|
||||
{
|
||||
char * eol;
|
||||
char * name;
|
||||
char * name_end;
|
||||
int finished = false;
|
||||
|
||||
for (eol = line;; eol ++)
|
||||
{
|
||||
switch (* eol)
|
||||
{
|
||||
case '\n':
|
||||
* eol = '\0';
|
||||
/* Cope with \n\r. */
|
||||
if (eol[1] == '\r')
|
||||
++ eol;
|
||||
finished = true;
|
||||
break;
|
||||
|
||||
case '\r':
|
||||
* eol = '\0';
|
||||
/* Cope with \r\n. */
|
||||
if (eol[1] == '\n')
|
||||
++ eol;
|
||||
finished = true;
|
||||
break;
|
||||
|
||||
case 0:
|
||||
finished = true;
|
||||
break;
|
||||
|
||||
case '#':
|
||||
/* Line comment, Terminate the line here, in case a
|
||||
name is present and then allow the rest of the
|
||||
loop to find the real end of the line. */
|
||||
* eol = '\0';
|
||||
break;
|
||||
|
||||
default:
|
||||
break;
|
||||
}
|
||||
|
||||
if (finished)
|
||||
break;
|
||||
}
|
||||
|
||||
/* A name may now exist somewhere between 'line' and 'eol'.
|
||||
Strip off leading whitespace and trailing whitespace,
|
||||
then add it to the list. */
|
||||
for (name = line; IS_WHITESPACE (* name); name ++)
|
||||
;
|
||||
for (name_end = name;
|
||||
(! IS_WHITESPACE (* name_end))
|
||||
&& (! IS_LINE_TERMINATOR (* name_end));
|
||||
name_end ++)
|
||||
;
|
||||
|
||||
if (! IS_LINE_TERMINATOR (* name_end))
|
||||
{
|
||||
char * extra;
|
||||
|
||||
for (extra = name_end + 1; IS_WHITESPACE (* extra); extra ++)
|
||||
;
|
||||
|
||||
if (! IS_LINE_TERMINATOR (* extra))
|
||||
non_fatal (_("Ignoring rubbish found on line %d of %s"),
|
||||
line_count, filename);
|
||||
}
|
||||
|
||||
* name_end = '\0';
|
||||
|
||||
if (name_end > name)
|
||||
add_specific_symbol (name, list);
|
||||
|
||||
/* Advance line pointer to end of line. The 'eol ++' in the for
|
||||
loop above will then advance us to the start of the next line. */
|
||||
line = eol;
|
||||
line_count ++;
|
||||
}
|
||||
}
|
||||
|
||||
/* See whether a symbol should be stripped or kept based on
|
||||
strip_specific_list and keep_symbols. */
|
||||
|
||||
@ -636,6 +772,12 @@ filter_symbols (abfd, obfd, osyms, isyms, symcount)
|
||||
else if (relocatable /* Relocatable file. */
|
||||
&& (flags & (BSF_GLOBAL | BSF_WEAK)) != 0)
|
||||
keep = 1;
|
||||
else if (bfd_decode_symclass (sym) == 'I')
|
||||
/* Global symbols in $idata sections need to be retained
|
||||
even if relocatable is false. External users of the
|
||||
library containing the $idata section may reference these
|
||||
symbols. */
|
||||
keep = 1;
|
||||
else if ((flags & BSF_GLOBAL) != 0 /* Global symbol. */
|
||||
|| (flags & BSF_WEAK) != 0
|
||||
|| bfd_is_und_section (bfd_get_section (sym))
|
||||
@ -665,7 +807,9 @@ filter_symbols (abfd, obfd, osyms, isyms, symcount)
|
||||
sym->flags |= BSF_WEAK;
|
||||
}
|
||||
if (keep && (flags & (BSF_GLOBAL | BSF_WEAK))
|
||||
&& is_specified_symbol (name, localize_specific_list))
|
||||
&& (is_specified_symbol (name, localize_specific_list)
|
||||
|| (keepglobal_specific_list != NULL
|
||||
&& ! is_specified_symbol (name, keepglobal_specific_list))))
|
||||
{
|
||||
sym->flags &= ~(BSF_GLOBAL | BSF_WEAK);
|
||||
sym->flags |= BSF_LOCAL;
|
||||
@ -977,6 +1121,7 @@ copy_object (ibfd, obfd)
|
||||
|| strip_specific_list != NULL
|
||||
|| keep_specific_list != NULL
|
||||
|| localize_specific_list != NULL
|
||||
|| keepglobal_specific_list != NULL
|
||||
|| weaken_specific_list != NULL
|
||||
|| sections_removed
|
||||
|| sections_copied
|
||||
@ -1695,7 +1840,7 @@ strip_main (argc, argv)
|
||||
struct section_list *p;
|
||||
char *output_file = NULL;
|
||||
|
||||
while ((c = getopt_long (argc, argv, "I:O:F:K:N:R:o:sSpdgxXVv",
|
||||
while ((c = getopt_long (argc, argv, "b:i:I:j:K:N:s:O:d:F:L:G:R:SpgxXVvW:",
|
||||
strip_options, (int *) 0)) != EOF)
|
||||
{
|
||||
switch (c)
|
||||
@ -1903,6 +2048,10 @@ copy_main (argc, argv)
|
||||
add_specific_symbol (optarg, &localize_specific_list);
|
||||
break;
|
||||
|
||||
case 'G':
|
||||
add_specific_symbol (optarg, &keepglobal_specific_list);
|
||||
break;
|
||||
|
||||
case 'W':
|
||||
add_specific_symbol (optarg, &weaken_specific_list);
|
||||
break;
|
||||
@ -2169,6 +2318,26 @@ copy_main (argc, argv)
|
||||
S3Forced = true;
|
||||
break;
|
||||
|
||||
case OPTION_STRIP_SYMBOLS:
|
||||
add_specific_symbols (optarg, &strip_specific_list);
|
||||
break;
|
||||
|
||||
case OPTION_KEEP_SYMBOLS:
|
||||
add_specific_symbols (optarg, &keep_specific_list);
|
||||
break;
|
||||
|
||||
case OPTION_LOCALIZE_SYMBOLS:
|
||||
add_specific_symbols (optarg, &localize_specific_list);
|
||||
break;
|
||||
|
||||
case OPTION_KEEPGLOBAL_SYMBOLS:
|
||||
add_specific_symbols (optarg, &keepglobal_specific_list);
|
||||
break;
|
||||
|
||||
case OPTION_WEAKEN_SYMBOLS:
|
||||
add_specific_symbols (optarg, &weaken_specific_list);
|
||||
break;
|
||||
|
||||
case 0:
|
||||
break; /* we've been given a long option */
|
||||
|
||||
|
||||
@ -1,12 +1,9 @@
|
||||
.rn '' }`
|
||||
''' $RCSfile$$Revision$$Date$
|
||||
'''
|
||||
''' $Log$
|
||||
''' Revision 1.5 2001/03/25 20:32:25 nickc
|
||||
''' Automate generate on man pages
|
||||
'''
|
||||
'''
|
||||
.de Sh
|
||||
.\" Automatically generated by Pod::Man version 1.02
|
||||
.\" Wed May 30 12:24:28 2001
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ======================================================================
|
||||
.de Sh \" Subsection heading
|
||||
.br
|
||||
.if t .Sp
|
||||
.ne 5
|
||||
@ -14,149 +11,105 @@
|
||||
\fB\\$1\fR
|
||||
.PP
|
||||
..
|
||||
.de Sp
|
||||
.de Sp \" Vertical space (when we can't use .PP)
|
||||
.if t .sp .5v
|
||||
.if n .sp
|
||||
..
|
||||
.de Ip
|
||||
.de Ip \" List item
|
||||
.br
|
||||
.ie \\n(.$>=3 .ne \\$3
|
||||
.el .ne 3
|
||||
.IP "\\$1" \\$2
|
||||
..
|
||||
.de Vb
|
||||
.de Vb \" Begin verbatim text
|
||||
.ft CW
|
||||
.nf
|
||||
.ne \\$1
|
||||
..
|
||||
.de Ve
|
||||
.de Ve \" End verbatim text
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
'''
|
||||
'''
|
||||
''' Set up \*(-- to give an unbreakable dash;
|
||||
''' string Tr holds user defined translation string.
|
||||
''' Bell System Logo is used as a dummy character.
|
||||
'''
|
||||
.\" Set up some character translations and predefined strings. \*(-- will
|
||||
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
||||
.\" double quote, and \*(R" will give a right double quote. | will give a
|
||||
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
|
||||
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
|
||||
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
|
||||
.tr \(*W-|\(bv\*(Tr
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.ie n \{\
|
||||
.ds -- \(*W-
|
||||
.ds PI pi
|
||||
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
.ds L" ""
|
||||
.ds R" ""
|
||||
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
|
||||
''' \*(L" and \*(R", except that they are used on ".xx" lines,
|
||||
''' such as .IP and .SH, which do another additional levels of
|
||||
''' double-quote interpretation
|
||||
.ds M" """
|
||||
.ds S" """
|
||||
.ds N" """""
|
||||
.ds T" """""
|
||||
.ds L' '
|
||||
.ds R' '
|
||||
.ds M' '
|
||||
.ds S' '
|
||||
.ds N' '
|
||||
.ds T' '
|
||||
. ds -- \(*W-
|
||||
. ds PI pi
|
||||
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
. ds L" ""
|
||||
. ds R" ""
|
||||
. ds C` `
|
||||
. ds C' '
|
||||
'br\}
|
||||
.el\{\
|
||||
.ds -- \(em\|
|
||||
.tr \*(Tr
|
||||
.ds L" ``
|
||||
.ds R" ''
|
||||
.ds M" ``
|
||||
.ds S" ''
|
||||
.ds N" ``
|
||||
.ds T" ''
|
||||
.ds L' `
|
||||
.ds R' '
|
||||
.ds M' `
|
||||
.ds S' '
|
||||
.ds N' `
|
||||
.ds T' '
|
||||
.ds PI \(*p
|
||||
. ds -- \|\(em\|
|
||||
. ds PI \(*p
|
||||
. ds L" ``
|
||||
. ds R" ''
|
||||
'br\}
|
||||
.\" If the F register is turned on, we'll generate
|
||||
.\" index entries out stderr for the following things:
|
||||
.\" TH Title
|
||||
.\" SH Header
|
||||
.\" Sh Subsection
|
||||
.\" Ip Item
|
||||
.\" X<> Xref (embedded
|
||||
.\" Of course, you have to process the output yourself
|
||||
.\" in some meaninful fashion.
|
||||
.if \nF \{
|
||||
.de IX
|
||||
.tm Index:\\$1\t\\n%\t"\\$2"
|
||||
..
|
||||
.nr % 0
|
||||
.rr F
|
||||
.\"
|
||||
.\" If the F register is turned on, we'll generate index entries on stderr
|
||||
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
|
||||
.\" index entries marked with X<> in POD. Of course, you'll have to process
|
||||
.\" the output yourself in some meaningful fashion.
|
||||
.if \nF \{\
|
||||
. de IX
|
||||
. tm Index:\\$1\t\\n%\t"\\$2"
|
||||
. .
|
||||
. nr % 0
|
||||
. rr F
|
||||
.\}
|
||||
.TH OBJDUMP.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
|
||||
.UC
|
||||
.if n .hy 0
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.de CQ \" put $1 in typewriter font
|
||||
.ft CW
|
||||
'if n "\c
|
||||
'if t \\&\\$1\c
|
||||
'if n \\&\\$1\c
|
||||
'if n \&"
|
||||
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
|
||||
'.ft R
|
||||
..
|
||||
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
|
||||
. \" AM - accent mark definitions
|
||||
.\"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it
|
||||
.\" makes way too many mistakes in technical documents.
|
||||
.hy 0
|
||||
.\"
|
||||
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
||||
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
||||
.bd B 3
|
||||
. \" fudge factors for nroff and troff
|
||||
. \" fudge factors for nroff and troff
|
||||
.if n \{\
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
.\}
|
||||
. \" simple accents for nroff and troff
|
||||
. \" simple accents for nroff and troff
|
||||
.if n \{\
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds ? ?
|
||||
. ds ! !
|
||||
. ds /
|
||||
. ds q
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds /
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
|
||||
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
.\}
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
||||
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
||||
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
|
||||
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
|
||||
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
|
||||
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
|
||||
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
||||
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
||||
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
||||
@ -164,417 +117,343 @@
|
||||
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
||||
.ds ae a\h'-(\w'a'u*4/10)'e
|
||||
.ds Ae A\h'-(\w'A'u*4/10)'E
|
||||
.ds oe o\h'-(\w'o'u*4/10)'e
|
||||
.ds Oe O\h'-(\w'O'u*4/10)'E
|
||||
. \" corrections for vroff
|
||||
. \" corrections for vroff
|
||||
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
||||
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
.if \n(.H>23 .if \n(.V>19 \
|
||||
\{\
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds v \h'-1'\o'\(aa\(ga'
|
||||
. ds _ \h'-1'^
|
||||
. ds . \h'-1'.
|
||||
. ds 3 3
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
. ds oe oe
|
||||
. ds Oe OE
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
.\}
|
||||
.rm #[ #] #H #V #F C
|
||||
.\" ======================================================================
|
||||
.\"
|
||||
.IX Title "OBJDUMP.1 1"
|
||||
.TH OBJDUMP.1 1 "binutils-2.11.90" "2001-05-30" "GNU"
|
||||
.UC
|
||||
.SH "NAME"
|
||||
objdump \- display information from object files.
|
||||
.SH "SYNOPSIS"
|
||||
objdump [ \-a | --archive-headers ]
|
||||
[ \-b \fIbfdname\fR | --target=\fIbfdname\fR ]
|
||||
[ \-C | --demangle[=\fIstyle\fR] ]
|
||||
[ \-d | --disassemble ]
|
||||
[ \-D | --disassemble-all ]
|
||||
[ \-z | --disassemble-zeroes ]
|
||||
[ \-EB | \-EL | --endian={big | little } ]
|
||||
[ \-f | --file-headers ]
|
||||
[ --file-start-context ]
|
||||
[ \-g | --debugging ]
|
||||
[ \-h | --section-headers | --headers ]
|
||||
[ \-i | --info ]
|
||||
[ \-j \fIsection\fR | --section=\fIsection\fR ]
|
||||
[ \-l | --line-numbers ]
|
||||
[ \-S | --source ]
|
||||
[ \-m \fImachine\fR | --architecture=\fImachine\fR ]
|
||||
[ \-M \fIoptions\fR | --disassembler-options=\fIoptions\fR]
|
||||
[ \-p | --private-headers ]
|
||||
[ \-r | --reloc ]
|
||||
[ \-R | --dynamic-reloc ]
|
||||
[ \-s | --full-contents ]
|
||||
[ \-G | --stabs ]
|
||||
[ \-t | --syms ]
|
||||
[ \-T | --dynamic-syms ]
|
||||
[ \-x | --all-headers ]
|
||||
[ \-w | --wide ]
|
||||
[ --start-address=\fIaddress\fR ]
|
||||
[ --stop-address=\fIaddress\fR ]
|
||||
[ --prefix-addresses]
|
||||
[ --[no-]show-raw-insn ]
|
||||
[ --adjust-vma=\fIoffset\fR ]
|
||||
[ \-V | --version ]
|
||||
[ \-H | --help ]
|
||||
.IX Header "SYNOPSIS"
|
||||
objdump [ \-a | \-\-archive-headers ]
|
||||
[ \-b \fIbfdname\fR | \-\-target=\fIbfdname\fR ]
|
||||
[ \-C | \-\-demangle[=\fIstyle\fR] ]
|
||||
[ \-d | \-\-disassemble ]
|
||||
[ \-D | \-\-disassemble-all ]
|
||||
[ \-z | \-\-disassemble-zeroes ]
|
||||
[ \-EB | \-EL | \-\-endian={big | little } ]
|
||||
[ \-f | \-\-file-headers ]
|
||||
[ \-\-file-start-context ]
|
||||
[ \-g | \-\-debugging ]
|
||||
[ \-h | \-\-section-headers | \-\-headers ]
|
||||
[ \-i | \-\-info ]
|
||||
[ \-j \fIsection\fR | \-\-section=\fIsection\fR ]
|
||||
[ \-l | \-\-line-numbers ]
|
||||
[ \-S | \-\-source ]
|
||||
[ \-m \fImachine\fR | \-\-architecture=\fImachine\fR ]
|
||||
[ \-M \fIoptions\fR | \-\-disassembler-options=\fIoptions\fR]
|
||||
[ \-p | \-\-private-headers ]
|
||||
[ \-r | \-\-reloc ]
|
||||
[ \-R | \-\-dynamic-reloc ]
|
||||
[ \-s | \-\-full-contents ]
|
||||
[ \-G | \-\-stabs ]
|
||||
[ \-t | \-\-syms ]
|
||||
[ \-T | \-\-dynamic-syms ]
|
||||
[ \-x | \-\-all-headers ]
|
||||
[ \-w | \-\-wide ]
|
||||
[ \-\-start-address=\fIaddress\fR ]
|
||||
[ \-\-stop-address=\fIaddress\fR ]
|
||||
[ \-\-prefix-addresses]
|
||||
[ \-\-[no-]show-raw-insn ]
|
||||
[ \-\-adjust-vma=\fIoffset\fR ]
|
||||
[ \-V | \-\-version ]
|
||||
[ \-H | \-\-help ]
|
||||
\fIobjfile\fR...
|
||||
.SH "DESCRIPTION"
|
||||
\f(CWobjdump\fR displays information about one or more object files.
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\f(CW\*(C`objdump\*(C'\fR 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.
|
||||
.PP
|
||||
\fIobjfile\fR... are the object files to be examined. When you
|
||||
specify archives, \f(CWobjdump\fR shows information on each of the member
|
||||
\&\fIobjfile\fR... are the object files to be examined. When you
|
||||
specify archives, \f(CW\*(C`objdump\*(C'\fR shows information on each of the member
|
||||
object files.
|
||||
.SH "OPTIONS"
|
||||
.IX Header "OPTIONS"
|
||||
The long and short forms of options, shown here as alternatives, are
|
||||
equivalent. At least one option from the list
|
||||
\fB\-a,\-d,\-D,\-f,\-g,\-G,\-h,\-H,\-p,\-r,\-R,\-S,\-t,\-T,\-V,\-x\fR must be given.
|
||||
.Ip "\f(CW-a\fR" 4
|
||||
.Ip "\f(CW--archive-header\fR" 4
|
||||
\&\fB\-a,\-d,\-D,\-f,\-g,\-G,\-h,\-H,\-p,\-r,\-R,\-S,\-t,\-T,\-V,\-x\fR must be given.
|
||||
.Ip "\f(CW\*(C`\-a\*(C'\fR" 4
|
||||
.IX Item "-a"
|
||||
.Ip "\f(CW\*(C`\-\-archive\-header\*(C'\fR" 4
|
||||
.IX Item "--archive-header"
|
||||
If any of the \fIobjfile\fR files are archives, display the archive
|
||||
header information (in a format similar to \fBls \-l\fR). Besides the
|
||||
information you could list with \fBar tv\fR, \fBobjdump \-a\fR shows
|
||||
the object file format of each archive member.
|
||||
.Ip "\f(CW--adjust-vma=\fIoffset\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-adjust\-vma=\f(CIoffset\f(CW\*(C'\fR" 4
|
||||
.IX Item "--adjust-vma=offset"
|
||||
When dumping information, first add \fIoffset\fR to all the section
|
||||
addresses. This is useful if the section addresses do not correspond to
|
||||
the symbol table, which can happen when putting sections at particular
|
||||
addresses when using a format which can not represent section addresses,
|
||||
such as a.out.
|
||||
.Ip "\f(CW-b \fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW--target=\fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-b \f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-b bfdname"
|
||||
.Ip "\f(CW\*(C`\-\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--target=bfdname"
|
||||
Specify that the object-code format for the object files is
|
||||
\fIbfdname\fR. This option may not be necessary; \fIobjdump\fR can
|
||||
\&\fIbfdname\fR. This option may not be necessary; \fIobjdump\fR can
|
||||
automatically recognize many formats.
|
||||
.Sp
|
||||
For example,
|
||||
|
||||
objdump \-b oasys \-m vax \-h fu.o
|
||||
.Sp
|
||||
.Vb 1
|
||||
\& objdump -b oasys -m vax -h fu.o
|
||||
.Ve
|
||||
displays summary information from the section headers (\fB\-h\fR) of
|
||||
\fIfu.o\fR, which is explicitly identified (\fB\-m\fR) as a \s-1VAX\s0 object
|
||||
\&\fIfu.o\fR, which is explicitly identified (\fB\-m\fR) as a \s-1VAX\s0 object
|
||||
file in the format produced by Oasys compilers. You can list the
|
||||
formats available with the \fB\-i\fR option.
|
||||
.Ip "\f(CW-C\fR" 4
|
||||
.Ip "\f(CW--demangle[=\fIstyle\fR]\fR" 4
|
||||
.Ip "\f(CW\*(C`\-C\*(C'\fR" 4
|
||||
.IX Item "-C"
|
||||
.Ip "\f(CW\*(C`\-\-demangle[=\f(CIstyle\f(CW]\*(C'\fR" 4
|
||||
.IX Item "--demangle[=style]"
|
||||
Decode (\fIdemangle\fR) low-level symbol names into user-level names.
|
||||
Besides removing any initial underscore prepended by the system, this
|
||||
makes \*(C+ function names readable. Different compilers have different
|
||||
mangling styles. The optional demangling style argument can be used to
|
||||
choose an appropriate demangling style for your compiler.
|
||||
.Ip "\f(CW-G\fR" 4
|
||||
.Ip "\f(CW--debugging\fR" 4
|
||||
.Ip "\f(CW\*(C`\-G\*(C'\fR" 4
|
||||
.IX Item "-G"
|
||||
.Ip "\f(CW\*(C`\-\-debugging\*(C'\fR" 4
|
||||
.IX Item "--debugging"
|
||||
Display debugging information. This attempts to parse debugging
|
||||
information stored in the file and print it out using a C like syntax.
|
||||
Only certain types of debugging information have been implemented.
|
||||
.Ip "\f(CW-d\fR" 4
|
||||
.Ip "\f(CW--disassemble\fR" 4
|
||||
.Ip "\f(CW\*(C`\-d\*(C'\fR" 4
|
||||
.IX Item "-d"
|
||||
.Ip "\f(CW\*(C`\-\-disassemble\*(C'\fR" 4
|
||||
.IX Item "--disassemble"
|
||||
Display the assembler mnemonics for the machine instructions from
|
||||
\fIobjfile\fR. This option only disassembles those sections which are
|
||||
\&\fIobjfile\fR. This option only disassembles those sections which are
|
||||
expected to contain instructions.
|
||||
.Ip "\f(CW-D\fR" 4
|
||||
.Ip "\f(CW--disassemble-all\fR" 4
|
||||
.Ip "\f(CW\*(C`\-D\*(C'\fR" 4
|
||||
.IX Item "-D"
|
||||
.Ip "\f(CW\*(C`\-\-disassemble\-all\*(C'\fR" 4
|
||||
.IX Item "--disassemble-all"
|
||||
Like \fB\-d\fR, but disassemble the contents of all sections, not just
|
||||
those expected to contain instructions.
|
||||
.Ip "\f(CW--prefix-addresses\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-prefix\-addresses\*(C'\fR" 4
|
||||
.IX Item "--prefix-addresses"
|
||||
When disassembling, print the complete address on each line. This is
|
||||
the older disassembly format.
|
||||
.Ip "\f(CW--disassemble-zeroes\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-disassemble\-zeroes\*(C'\fR" 4
|
||||
.IX Item "--disassemble-zeroes"
|
||||
Normally the disassembly output will skip blocks of zeroes. This
|
||||
option directs the disassembler to disassemble those blocks, just like
|
||||
any other data.
|
||||
.Ip "\f(CW-EB\fR" 4
|
||||
.Ip "\f(CW-EL\fR" 4
|
||||
.Ip "\f(CW--endian={big|little}\fR" 4
|
||||
.Ip "\f(CW\*(C`\-EB\*(C'\fR" 4
|
||||
.IX Item "-EB"
|
||||
.Ip "\f(CW\*(C`\-EL\*(C'\fR" 4
|
||||
.IX Item "-EL"
|
||||
.Ip "\f(CW\*(C`\-\-endian={big|little}\*(C'\fR" 4
|
||||
.IX Item "--endian={big|little}"
|
||||
Specify the endianness of the object files. This only affects
|
||||
disassembly. This can be useful when disassembling a file format which
|
||||
does not describe endianness information, such as S\-records.
|
||||
.Ip "\f(CW-f\fR" 4
|
||||
.Ip "\f(CW--file-header\fR" 4
|
||||
does not describe endianness information, such as S-records.
|
||||
.Ip "\f(CW\*(C`\-f\*(C'\fR" 4
|
||||
.IX Item "-f"
|
||||
.Ip "\f(CW\*(C`\-\-file\-header\*(C'\fR" 4
|
||||
.IX Item "--file-header"
|
||||
Display summary information from the overall header of
|
||||
each of the \fIobjfile\fR files.
|
||||
.Ip "\f(CW--file-start-context\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-file\-start\-context\*(C'\fR" 4
|
||||
.IX Item "--file-start-context"
|
||||
Specify that when displaying interlisted source code/disassembly
|
||||
(assumes \*(L'\-S') from a file that has not yet been displayed, extend the
|
||||
(assumes '\-S') from a file that has not yet been displayed, extend the
|
||||
context to the start of the file.
|
||||
.Ip "\f(CW-h\fR" 4
|
||||
.Ip "\f(CW--section-header\fR" 4
|
||||
.Ip "\f(CW--header\fR" 4
|
||||
.Ip "\f(CW\*(C`\-h\*(C'\fR" 4
|
||||
.IX Item "-h"
|
||||
.Ip "\f(CW\*(C`\-\-section\-header\*(C'\fR" 4
|
||||
.IX Item "--section-header"
|
||||
.Ip "\f(CW\*(C`\-\-header\*(C'\fR" 4
|
||||
.IX Item "--header"
|
||||
Display summary information from the section headers of the
|
||||
object file.
|
||||
.Sp
|
||||
File segments may be relocated to nonstandard addresses, for example by
|
||||
using the \fB\-Ttext\fR, \fB\-Tdata\fR, or \fB\-Tbss\fR options to
|
||||
\f(CWld\fR. However, some object file formats, such as a.out, do not
|
||||
\&\f(CW\*(C`ld\*(C'\fR. However, some object file formats, such as a.out, do not
|
||||
store the starting address of the file segments. In those situations,
|
||||
although \f(CWld\fR relocates the sections correctly, using \fBobjdump
|
||||
\-h\fR to list the file section headers cannot show the correct addresses.
|
||||
although \f(CW\*(C`ld\*(C'\fR relocates the sections correctly, using \fBobjdump
|
||||
\&\-h\fR to list the file section headers cannot show the correct addresses.
|
||||
Instead, it shows the usual addresses, which are implicit for the
|
||||
target.
|
||||
.Ip "\f(CW--help\fR" 4
|
||||
Print a summary of the options to \f(CWobjdump\fR and exit.
|
||||
.Ip "\f(CW-i\fR" 4
|
||||
.Ip "\f(CW--info\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-help\*(C'\fR" 4
|
||||
.IX Item "--help"
|
||||
Print a summary of the options to \f(CW\*(C`objdump\*(C'\fR and exit.
|
||||
.Ip "\f(CW\*(C`\-i\*(C'\fR" 4
|
||||
.IX Item "-i"
|
||||
.Ip "\f(CW\*(C`\-\-info\*(C'\fR" 4
|
||||
.IX Item "--info"
|
||||
Display a list showing all architectures and object formats available
|
||||
for specification with \fB\-b\fR or \fB\-m\fR.
|
||||
.Ip "\f(CW-j \fIname\fR\fR" 4
|
||||
.Ip "\f(CW--section=\fIname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-j \f(CIname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-j name"
|
||||
.Ip "\f(CW\*(C`\-\-section=\f(CIname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--section=name"
|
||||
Display information only for section \fIname\fR.
|
||||
.Ip "\f(CW-l\fR" 4
|
||||
.Ip "\f(CW--line-numbers\fR" 4
|
||||
.Ip "\f(CW\*(C`\-l\*(C'\fR" 4
|
||||
.IX Item "-l"
|
||||
.Ip "\f(CW\*(C`\-\-line\-numbers\*(C'\fR" 4
|
||||
.IX Item "--line-numbers"
|
||||
Label the display (using debugging information) with the filename and
|
||||
source line numbers corresponding to the object code or relocs shown.
|
||||
Only useful with \fB\-d\fR, \fB\-D\fR, or \fB\-r\fR.
|
||||
.Ip "\f(CW-m \fImachine\fR\fR" 4
|
||||
.Ip "\f(CW--architecture=\fImachine\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-m \f(CImachine\f(CW\*(C'\fR" 4
|
||||
.IX Item "-m machine"
|
||||
.Ip "\f(CW\*(C`\-\-architecture=\f(CImachine\f(CW\*(C'\fR" 4
|
||||
.IX Item "--architecture=machine"
|
||||
Specify the architecture to use when disassembling object files. This
|
||||
can be useful when disassembling object files which do not describe
|
||||
architecture information, such as S\-records. You can list the available
|
||||
architecture information, such as S-records. You can list the available
|
||||
architectures with the \fB\-i\fR option.
|
||||
.Ip "\f(CW-M \fIoptions\fR\fR" 4
|
||||
.Ip "\f(CW--disassembler-options=\fIoptions\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-M \f(CIoptions\f(CW\*(C'\fR" 4
|
||||
.IX Item "-M options"
|
||||
.Ip "\f(CW\*(C`\-\-disassembler\-options=\f(CIoptions\f(CW\*(C'\fR" 4
|
||||
.IX Item "--disassembler-options=options"
|
||||
Pass target specific information to the disassembler. Only supported on
|
||||
some targets.
|
||||
.Sp
|
||||
If the target is an \s-1ARM\s0 architecture then this switch can be used to
|
||||
select which register name set is used during disassembler. Specifying
|
||||
\fB\-M reg-name-std\fR (the default) will select the register names as
|
||||
\&\fB\-M reg-name-std\fR (the default) will select the register names as
|
||||
used in \s-1ARM\s0's instruction set documentation, but with register 13 called
|
||||
\&'sp\*(R', register 14 called \*(L'lr\*(R' and register 15 called \*(L'pc\*(R'. Specifying
|
||||
\fB\-M reg-names-apcs\fR will select the name set used by the \s-1ARM\s0
|
||||
\&'sp', register 14 called 'lr' and register 15 called 'pc'. Specifying
|
||||
\&\fB\-M reg-names-apcs\fR will select the name set used by the \s-1ARM\s0
|
||||
Procedure Call Standard, whilst specifying \fB\-M reg-names-raw\fR will
|
||||
just use \fBr\fR followed by the register number.
|
||||
.Sp
|
||||
There are also two variants on the \s-1APCS\s0 register naming scheme enabled
|
||||
by \fB\-M reg-names-atpcs\fR and \fB\-M reg-names-special-atpcs\fR which
|
||||
use the \s-1ARM/\s0Thumb Procedure Call Standard naming conventions. (Eiuther
|
||||
use the ARM/Thumb Procedure Call Standard naming conventions. (Eiuther
|
||||
with the normal register name sor the special register names).
|
||||
.Sp
|
||||
This option can also be used for \s-1ARM\s0 architectures to force the
|
||||
disassembler to interpret all instructions as \s-1THUMB\s0 instructions by
|
||||
using the switch \fB--disassembler-options=force-thumb\fR. This can be
|
||||
using the switch \fB\*(--disassembler-options=force-thumb\fR. This can be
|
||||
useful when attempting to disassemble thumb code produced by other
|
||||
compilers.
|
||||
.Ip "\f(CW-p\fR" 4
|
||||
.Ip "\f(CW--private-headers\fR" 4
|
||||
.Ip "\f(CW\*(C`\-p\*(C'\fR" 4
|
||||
.IX Item "-p"
|
||||
.Ip "\f(CW\*(C`\-\-private\-headers\*(C'\fR" 4
|
||||
.IX Item "--private-headers"
|
||||
Print information that is specific to the object file format. The exact
|
||||
information printed depends upon the object file format. For some
|
||||
object file formats, no additional information is printed.
|
||||
.Ip "\f(CW-r\fR" 4
|
||||
.Ip "\f(CW--reloc\fR" 4
|
||||
.Ip "\f(CW\*(C`\-r\*(C'\fR" 4
|
||||
.IX Item "-r"
|
||||
.Ip "\f(CW\*(C`\-\-reloc\*(C'\fR" 4
|
||||
.IX Item "--reloc"
|
||||
Print the relocation entries of the file. If used with \fB\-d\fR or
|
||||
\fB\-D\fR, the relocations are printed interspersed with the
|
||||
\&\fB\-D\fR, the relocations are printed interspersed with the
|
||||
disassembly.
|
||||
.Ip "\f(CW-R\fR" 4
|
||||
.Ip "\f(CW--dynamic-reloc\fR" 4
|
||||
.Ip "\f(CW\*(C`\-R\*(C'\fR" 4
|
||||
.IX Item "-R"
|
||||
.Ip "\f(CW\*(C`\-\-dynamic\-reloc\*(C'\fR" 4
|
||||
.IX Item "--dynamic-reloc"
|
||||
Print the dynamic relocation entries of the file. This is only
|
||||
meaningful for dynamic objects, such as certain types of shared
|
||||
libraries.
|
||||
.Ip "\f(CW-s\fR" 4
|
||||
.Ip "\f(CW--full-contents\fR" 4
|
||||
.Ip "\f(CW\*(C`\-s\*(C'\fR" 4
|
||||
.IX Item "-s"
|
||||
.Ip "\f(CW\*(C`\-\-full\-contents\*(C'\fR" 4
|
||||
.IX Item "--full-contents"
|
||||
Display the full contents of any sections requested.
|
||||
.Ip "\f(CW-S\fR" 4
|
||||
.Ip "\f(CW--source\fR" 4
|
||||
.Ip "\f(CW\*(C`\-S\*(C'\fR" 4
|
||||
.IX Item "-S"
|
||||
.Ip "\f(CW\*(C`\-\-source\*(C'\fR" 4
|
||||
.IX Item "--source"
|
||||
Display source code intermixed with disassembly, if possible. Implies
|
||||
\fB\-d\fR.
|
||||
.Ip "\f(CW--show-raw-insn\fR" 4
|
||||
\&\fB\-d\fR.
|
||||
.Ip "\f(CW\*(C`\-\-show\-raw\-insn\*(C'\fR" 4
|
||||
.IX Item "--show-raw-insn"
|
||||
When disassembling instructions, print the instruction in hex as well as
|
||||
in symbolic form. This is the default except when
|
||||
\f(CW--prefix-addresses\fR is used.
|
||||
.Ip "\f(CW--no-show-raw-insn\fR" 4
|
||||
\&\f(CW\*(C`\-\-prefix\-addresses\*(C'\fR is used.
|
||||
.Ip "\f(CW\*(C`\-\-no\-show\-raw\-insn\*(C'\fR" 4
|
||||
.IX Item "--no-show-raw-insn"
|
||||
When disassembling instructions, do not print the instruction bytes.
|
||||
This is the default when \f(CW--prefix-addresses\fR is used.
|
||||
.Ip "\f(CW-G\fR" 4
|
||||
.Ip "\f(CW--stabs\fR" 4
|
||||
This is the default when \f(CW\*(C`\-\-prefix\-addresses\*(C'\fR is used.
|
||||
.Ip "\f(CW\*(C`\-G\*(C'\fR" 4
|
||||
.IX Item "-G"
|
||||
.Ip "\f(CW\*(C`\-\-stabs\*(C'\fR" 4
|
||||
.IX Item "--stabs"
|
||||
Display the full contents of any sections requested. Display the
|
||||
contents of the .stab and .stab.index and .stab.excl sections from an
|
||||
\s-1ELF\s0 file. This is only useful on systems (such as Solaris 2.0) in which
|
||||
\&\f(CW.stab\fR debugging symbol-table entries are carried in an \s-1ELF\s0
|
||||
\&\s-1ELF\s0 file. This is only useful on systems (such as Solaris 2.0) in which
|
||||
\&\f(CW\*(C`.stab\*(C'\fR debugging symbol-table entries are carried in an \s-1ELF\s0
|
||||
section. In most other file formats, debugging symbol-table entries are
|
||||
interleaved with linkage symbols, and are visible in the \fB--syms\fR
|
||||
interleaved with linkage symbols, and are visible in the \fB\*(--syms\fR
|
||||
output.
|
||||
.Ip "\f(CW--start-address=\fIaddress\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-start\-address=\f(CIaddress\f(CW\*(C'\fR" 4
|
||||
.IX Item "--start-address=address"
|
||||
Start displaying data at the specified address. This affects the output
|
||||
of the \f(CW-d\fR, \f(CW-r\fR and \f(CW-s\fR options.
|
||||
.Ip "\f(CW--stop-address=\fIaddress\fR\fR" 4
|
||||
of the \f(CW\*(C`\-d\*(C'\fR, \f(CW\*(C`\-r\*(C'\fR and \f(CW\*(C`\-s\*(C'\fR options.
|
||||
.Ip "\f(CW\*(C`\-\-stop\-address=\f(CIaddress\f(CW\*(C'\fR" 4
|
||||
.IX Item "--stop-address=address"
|
||||
Stop displaying data at the specified address. This affects the output
|
||||
of the \f(CW-d\fR, \f(CW-r\fR and \f(CW-s\fR options.
|
||||
.Ip "\f(CW-t\fR" 4
|
||||
.Ip "\f(CW--syms\fR" 4
|
||||
of the \f(CW\*(C`\-d\*(C'\fR, \f(CW\*(C`\-r\*(C'\fR and \f(CW\*(C`\-s\*(C'\fR options.
|
||||
.Ip "\f(CW\*(C`\-t\*(C'\fR" 4
|
||||
.IX Item "-t"
|
||||
.Ip "\f(CW\*(C`\-\-syms\*(C'\fR" 4
|
||||
.IX Item "--syms"
|
||||
Print the symbol table entries of the file.
|
||||
This is similar to the information provided by the \fBnm\fR program.
|
||||
.Ip "\f(CW-T\fR" 4
|
||||
.Ip "\f(CW--dynamic-syms\fR" 4
|
||||
.Ip "\f(CW\*(C`\-T\*(C'\fR" 4
|
||||
.IX Item "-T"
|
||||
.Ip "\f(CW\*(C`\-\-dynamic\-syms\*(C'\fR" 4
|
||||
.IX Item "--dynamic-syms"
|
||||
Print the dynamic symbol table entries of the file. This is only
|
||||
meaningful for dynamic objects, such as certain types of shared
|
||||
libraries. This is similar to the information provided by the \fBnm\fR
|
||||
program when given the \fB\-D\fR (\fB--dynamic\fR) option.
|
||||
.Ip "\f(CW--version\fR" 4
|
||||
Print the version number of \f(CWobjdump\fR and exit.
|
||||
.Ip "\f(CW-x\fR" 4
|
||||
.Ip "\f(CW--all-header\fR" 4
|
||||
program when given the \fB\-D\fR (\fB\*(--dynamic\fR) option.
|
||||
.Ip "\f(CW\*(C`\-\-version\*(C'\fR" 4
|
||||
.IX Item "--version"
|
||||
Print the version number of \f(CW\*(C`objdump\*(C'\fR and exit.
|
||||
.Ip "\f(CW\*(C`\-x\*(C'\fR" 4
|
||||
.IX Item "-x"
|
||||
.Ip "\f(CW\*(C`\-\-all\-header\*(C'\fR" 4
|
||||
.IX Item "--all-header"
|
||||
Display all available header information, including the symbol table and
|
||||
relocation entries. Using \fB\-x\fR is equivalent to specifying all of
|
||||
\fB\-a \-f \-h \-r \-t\fR.
|
||||
.Ip "\f(CW-w\fR" 4
|
||||
.Ip "\f(CW--wide\fR" 4
|
||||
\&\fB\-a \-f \-h \-r \-t\fR.
|
||||
.Ip "\f(CW\*(C`\-w\*(C'\fR" 4
|
||||
.IX Item "-w"
|
||||
.Ip "\f(CW\*(C`\-\-wide\*(C'\fR" 4
|
||||
.IX Item "--wide"
|
||||
Format some lines for output devices that have more than 80 columns.
|
||||
.SH "SEE ALSO"
|
||||
\fInm\fR\|(1), \fIreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
|
||||
.IX Header "SEE ALSO"
|
||||
\&\fInm\fR\|(1), \fIreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
|
||||
.SH "COPYRIGHT"
|
||||
.IX Header "COPYRIGHT"
|
||||
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
|
||||
.PP
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||||
Back-Cover Texts. A copy of the license is included in the
|
||||
section entitled \*(L"GNU Free Documentation License\*(R".
|
||||
|
||||
.rn }` ''
|
||||
.IX Title "OBJDUMP.1 1"
|
||||
.IX Name "objdump - display information from object files."
|
||||
|
||||
.IX Header "NAME"
|
||||
|
||||
.IX Header "SYNOPSIS"
|
||||
|
||||
.IX Header "DESCRIPTION"
|
||||
|
||||
.IX Header "OPTIONS"
|
||||
|
||||
.IX Item "\f(CW-a\fR"
|
||||
|
||||
.IX Item "\f(CW--archive-header\fR"
|
||||
|
||||
.IX Item "\f(CW--adjust-vma=\fIoffset\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-b \fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--target=\fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-C\fR"
|
||||
|
||||
.IX Item "\f(CW--demangle[=\fIstyle\fR]\fR"
|
||||
|
||||
.IX Item "\f(CW-G\fR"
|
||||
|
||||
.IX Item "\f(CW--debugging\fR"
|
||||
|
||||
.IX Item "\f(CW-d\fR"
|
||||
|
||||
.IX Item "\f(CW--disassemble\fR"
|
||||
|
||||
.IX Item "\f(CW-D\fR"
|
||||
|
||||
.IX Item "\f(CW--disassemble-all\fR"
|
||||
|
||||
.IX Item "\f(CW--prefix-addresses\fR"
|
||||
|
||||
.IX Item "\f(CW--disassemble-zeroes\fR"
|
||||
|
||||
.IX Item "\f(CW-EB\fR"
|
||||
|
||||
.IX Item "\f(CW-EL\fR"
|
||||
|
||||
.IX Item "\f(CW--endian={big|little}\fR"
|
||||
|
||||
.IX Item "\f(CW-f\fR"
|
||||
|
||||
.IX Item "\f(CW--file-header\fR"
|
||||
|
||||
.IX Item "\f(CW--file-start-context\fR"
|
||||
|
||||
.IX Item "\f(CW-h\fR"
|
||||
|
||||
.IX Item "\f(CW--section-header\fR"
|
||||
|
||||
.IX Item "\f(CW--header\fR"
|
||||
|
||||
.IX Item "\f(CW--help\fR"
|
||||
|
||||
.IX Item "\f(CW-i\fR"
|
||||
|
||||
.IX Item "\f(CW--info\fR"
|
||||
|
||||
.IX Item "\f(CW-j \fIname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--section=\fIname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-l\fR"
|
||||
|
||||
.IX Item "\f(CW--line-numbers\fR"
|
||||
|
||||
.IX Item "\f(CW-m \fImachine\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--architecture=\fImachine\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-M \fIoptions\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--disassembler-options=\fIoptions\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-p\fR"
|
||||
|
||||
.IX Item "\f(CW--private-headers\fR"
|
||||
|
||||
.IX Item "\f(CW-r\fR"
|
||||
|
||||
.IX Item "\f(CW--reloc\fR"
|
||||
|
||||
.IX Item "\f(CW-R\fR"
|
||||
|
||||
.IX Item "\f(CW--dynamic-reloc\fR"
|
||||
|
||||
.IX Item "\f(CW-s\fR"
|
||||
|
||||
.IX Item "\f(CW--full-contents\fR"
|
||||
|
||||
.IX Item "\f(CW-S\fR"
|
||||
|
||||
.IX Item "\f(CW--source\fR"
|
||||
|
||||
.IX Item "\f(CW--show-raw-insn\fR"
|
||||
|
||||
.IX Item "\f(CW--no-show-raw-insn\fR"
|
||||
|
||||
.IX Item "\f(CW-G\fR"
|
||||
|
||||
.IX Item "\f(CW--stabs\fR"
|
||||
|
||||
.IX Item "\f(CW--start-address=\fIaddress\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--stop-address=\fIaddress\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-t\fR"
|
||||
|
||||
.IX Item "\f(CW--syms\fR"
|
||||
|
||||
.IX Item "\f(CW-T\fR"
|
||||
|
||||
.IX Item "\f(CW--dynamic-syms\fR"
|
||||
|
||||
.IX Item "\f(CW--version\fR"
|
||||
|
||||
.IX Item "\f(CW-x\fR"
|
||||
|
||||
.IX Item "\f(CW--all-header\fR"
|
||||
|
||||
.IX Item "\f(CW-w\fR"
|
||||
|
||||
.IX Item "\f(CW--wide\fR"
|
||||
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
.IX Header "COPYRIGHT"
|
||||
|
||||
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -1,12 +1,9 @@
|
||||
.rn '' }`
|
||||
''' $RCSfile$$Revision$$Date$
|
||||
'''
|
||||
''' $Log$
|
||||
''' Revision 1.5 2001/03/25 20:32:25 nickc
|
||||
''' Automate generate on man pages
|
||||
'''
|
||||
'''
|
||||
.de Sh
|
||||
.\" Automatically generated by Pod::Man version 1.02
|
||||
.\" Wed May 30 12:24:28 2001
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ======================================================================
|
||||
.de Sh \" Subsection heading
|
||||
.br
|
||||
.if t .Sp
|
||||
.ne 5
|
||||
@ -14,149 +11,105 @@
|
||||
\fB\\$1\fR
|
||||
.PP
|
||||
..
|
||||
.de Sp
|
||||
.de Sp \" Vertical space (when we can't use .PP)
|
||||
.if t .sp .5v
|
||||
.if n .sp
|
||||
..
|
||||
.de Ip
|
||||
.de Ip \" List item
|
||||
.br
|
||||
.ie \\n(.$>=3 .ne \\$3
|
||||
.el .ne 3
|
||||
.IP "\\$1" \\$2
|
||||
..
|
||||
.de Vb
|
||||
.de Vb \" Begin verbatim text
|
||||
.ft CW
|
||||
.nf
|
||||
.ne \\$1
|
||||
..
|
||||
.de Ve
|
||||
.de Ve \" End verbatim text
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
'''
|
||||
'''
|
||||
''' Set up \*(-- to give an unbreakable dash;
|
||||
''' string Tr holds user defined translation string.
|
||||
''' Bell System Logo is used as a dummy character.
|
||||
'''
|
||||
.\" Set up some character translations and predefined strings. \*(-- will
|
||||
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
||||
.\" double quote, and \*(R" will give a right double quote. | will give a
|
||||
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
|
||||
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
|
||||
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
|
||||
.tr \(*W-|\(bv\*(Tr
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.ie n \{\
|
||||
.ds -- \(*W-
|
||||
.ds PI pi
|
||||
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
.ds L" ""
|
||||
.ds R" ""
|
||||
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
|
||||
''' \*(L" and \*(R", except that they are used on ".xx" lines,
|
||||
''' such as .IP and .SH, which do another additional levels of
|
||||
''' double-quote interpretation
|
||||
.ds M" """
|
||||
.ds S" """
|
||||
.ds N" """""
|
||||
.ds T" """""
|
||||
.ds L' '
|
||||
.ds R' '
|
||||
.ds M' '
|
||||
.ds S' '
|
||||
.ds N' '
|
||||
.ds T' '
|
||||
. ds -- \(*W-
|
||||
. ds PI pi
|
||||
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
. ds L" ""
|
||||
. ds R" ""
|
||||
. ds C` `
|
||||
. ds C' '
|
||||
'br\}
|
||||
.el\{\
|
||||
.ds -- \(em\|
|
||||
.tr \*(Tr
|
||||
.ds L" ``
|
||||
.ds R" ''
|
||||
.ds M" ``
|
||||
.ds S" ''
|
||||
.ds N" ``
|
||||
.ds T" ''
|
||||
.ds L' `
|
||||
.ds R' '
|
||||
.ds M' `
|
||||
.ds S' '
|
||||
.ds N' `
|
||||
.ds T' '
|
||||
.ds PI \(*p
|
||||
. ds -- \|\(em\|
|
||||
. ds PI \(*p
|
||||
. ds L" ``
|
||||
. ds R" ''
|
||||
'br\}
|
||||
.\" If the F register is turned on, we'll generate
|
||||
.\" index entries out stderr for the following things:
|
||||
.\" TH Title
|
||||
.\" SH Header
|
||||
.\" Sh Subsection
|
||||
.\" Ip Item
|
||||
.\" X<> Xref (embedded
|
||||
.\" Of course, you have to process the output yourself
|
||||
.\" in some meaninful fashion.
|
||||
.if \nF \{
|
||||
.de IX
|
||||
.tm Index:\\$1\t\\n%\t"\\$2"
|
||||
..
|
||||
.nr % 0
|
||||
.rr F
|
||||
.\"
|
||||
.\" If the F register is turned on, we'll generate index entries on stderr
|
||||
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
|
||||
.\" index entries marked with X<> in POD. Of course, you'll have to process
|
||||
.\" the output yourself in some meaningful fashion.
|
||||
.if \nF \{\
|
||||
. de IX
|
||||
. tm Index:\\$1\t\\n%\t"\\$2"
|
||||
. .
|
||||
. nr % 0
|
||||
. rr F
|
||||
.\}
|
||||
.TH RANLIB.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
|
||||
.UC
|
||||
.if n .hy 0
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.de CQ \" put $1 in typewriter font
|
||||
.ft CW
|
||||
'if n "\c
|
||||
'if t \\&\\$1\c
|
||||
'if n \\&\\$1\c
|
||||
'if n \&"
|
||||
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
|
||||
'.ft R
|
||||
..
|
||||
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
|
||||
. \" AM - accent mark definitions
|
||||
.\"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it
|
||||
.\" makes way too many mistakes in technical documents.
|
||||
.hy 0
|
||||
.\"
|
||||
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
||||
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
||||
.bd B 3
|
||||
. \" fudge factors for nroff and troff
|
||||
. \" fudge factors for nroff and troff
|
||||
.if n \{\
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
.\}
|
||||
. \" simple accents for nroff and troff
|
||||
. \" simple accents for nroff and troff
|
||||
.if n \{\
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds ? ?
|
||||
. ds ! !
|
||||
. ds /
|
||||
. ds q
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds /
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
|
||||
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
.\}
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
||||
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
||||
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
|
||||
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
|
||||
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
|
||||
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
|
||||
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
||||
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
||||
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
||||
@ -164,84 +117,66 @@
|
||||
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
||||
.ds ae a\h'-(\w'a'u*4/10)'e
|
||||
.ds Ae A\h'-(\w'A'u*4/10)'E
|
||||
.ds oe o\h'-(\w'o'u*4/10)'e
|
||||
.ds Oe O\h'-(\w'O'u*4/10)'E
|
||||
. \" corrections for vroff
|
||||
. \" corrections for vroff
|
||||
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
||||
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
.if \n(.H>23 .if \n(.V>19 \
|
||||
\{\
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds v \h'-1'\o'\(aa\(ga'
|
||||
. ds _ \h'-1'^
|
||||
. ds . \h'-1'.
|
||||
. ds 3 3
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
. ds oe oe
|
||||
. ds Oe OE
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
.\}
|
||||
.rm #[ #] #H #V #F C
|
||||
.\" ======================================================================
|
||||
.\"
|
||||
.IX Title "RANLIB.1 1"
|
||||
.TH RANLIB.1 1 "binutils-2.11.90" "2001-05-30" "GNU"
|
||||
.UC
|
||||
.SH "NAME"
|
||||
ranlib \- generate index to archive.
|
||||
.SH "SYNOPSIS"
|
||||
.IX Header "SYNOPSIS"
|
||||
ranlib [\-vV] \fIarchive\fR
|
||||
.SH "DESCRIPTION"
|
||||
\f(CWranlib\fR generates an index to the contents of an archive and
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\f(CW\*(C`ranlib\*(C'\fR generates an index to the contents of an archive and
|
||||
stores it in the archive. The index lists each symbol defined by a
|
||||
member of an archive that is a relocatable object file.
|
||||
.PP
|
||||
You may use \fBnm \-s\fR or \fBnm --print-armap\fR to list this index.
|
||||
You may use \fBnm \-s\fR or \fBnm \-\-print-armap\fR to list this index.
|
||||
.PP
|
||||
An archive with such an index speeds up linking to the library and
|
||||
allows routines in the library to call each other without regard to
|
||||
their placement in the archive.
|
||||
.PP
|
||||
The GNU \f(CWranlib\fR program is another form of GNU \f(CWar\fR; running
|
||||
\f(CWranlib\fR is completely equivalent to executing \fBar \-s\fR.
|
||||
The \s-1GNU\s0 \f(CW\*(C`ranlib\*(C'\fR program is another form of \s-1GNU\s0 \f(CW\*(C`ar\*(C'\fR; running
|
||||
\&\f(CW\*(C`ranlib\*(C'\fR is completely equivalent to executing \fBar \-s\fR.
|
||||
.SH "OPTIONS"
|
||||
.Ip "\f(CW-v\fR" 4
|
||||
.Ip "\f(CW-V\fR" 4
|
||||
.Ip "\f(CW--version\fR" 4
|
||||
Show the version number of \f(CWranlib\fR.
|
||||
.IX Header "OPTIONS"
|
||||
.Ip "\f(CW\*(C`\-v\*(C'\fR" 4
|
||||
.IX Item "-v"
|
||||
.Ip "\f(CW\*(C`\-V\*(C'\fR" 4
|
||||
.IX Item "-V"
|
||||
.Ip "\f(CW\*(C`\-\-version\*(C'\fR" 4
|
||||
.IX Item "--version"
|
||||
Show the version number of \f(CW\*(C`ranlib\*(C'\fR.
|
||||
.SH "SEE ALSO"
|
||||
\fIar\fR\|(1), \fInm\fR\|(1), and the Info entries for \fIbinutils\fR.
|
||||
.IX Header "SEE ALSO"
|
||||
\&\fIar\fR\|(1), \fInm\fR\|(1), and the Info entries for \fIbinutils\fR.
|
||||
.SH "COPYRIGHT"
|
||||
.IX Header "COPYRIGHT"
|
||||
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
|
||||
.PP
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||||
Back-Cover Texts. A copy of the license is included in the
|
||||
section entitled \*(L"GNU Free Documentation License\*(R".
|
||||
|
||||
.rn }` ''
|
||||
.IX Title "RANLIB.1 1"
|
||||
.IX Name "ranlib - generate index to archive."
|
||||
|
||||
.IX Header "NAME"
|
||||
|
||||
.IX Header "SYNOPSIS"
|
||||
|
||||
.IX Header "DESCRIPTION"
|
||||
|
||||
.IX Header "OPTIONS"
|
||||
|
||||
.IX Item "\f(CW-v\fR"
|
||||
|
||||
.IX Item "\f(CW-V\fR"
|
||||
|
||||
.IX Item "\f(CW--version\fR"
|
||||
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
.IX Header "COPYRIGHT"
|
||||
|
||||
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
|
||||
|
||||
@ -1,12 +1,9 @@
|
||||
.rn '' }`
|
||||
''' $RCSfile$$Revision$$Date$
|
||||
'''
|
||||
''' $Log$
|
||||
''' Revision 1.1 2001/03/25 20:32:25 nickc
|
||||
''' Automate generate on man pages
|
||||
'''
|
||||
'''
|
||||
.de Sh
|
||||
.\" Automatically generated by Pod::Man version 1.02
|
||||
.\" Wed May 30 12:24:29 2001
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ======================================================================
|
||||
.de Sh \" Subsection heading
|
||||
.br
|
||||
.if t .Sp
|
||||
.ne 5
|
||||
@ -14,149 +11,105 @@
|
||||
\fB\\$1\fR
|
||||
.PP
|
||||
..
|
||||
.de Sp
|
||||
.de Sp \" Vertical space (when we can't use .PP)
|
||||
.if t .sp .5v
|
||||
.if n .sp
|
||||
..
|
||||
.de Ip
|
||||
.de Ip \" List item
|
||||
.br
|
||||
.ie \\n(.$>=3 .ne \\$3
|
||||
.el .ne 3
|
||||
.IP "\\$1" \\$2
|
||||
..
|
||||
.de Vb
|
||||
.de Vb \" Begin verbatim text
|
||||
.ft CW
|
||||
.nf
|
||||
.ne \\$1
|
||||
..
|
||||
.de Ve
|
||||
.de Ve \" End verbatim text
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
'''
|
||||
'''
|
||||
''' Set up \*(-- to give an unbreakable dash;
|
||||
''' string Tr holds user defined translation string.
|
||||
''' Bell System Logo is used as a dummy character.
|
||||
'''
|
||||
.\" Set up some character translations and predefined strings. \*(-- will
|
||||
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
||||
.\" double quote, and \*(R" will give a right double quote. | will give a
|
||||
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
|
||||
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
|
||||
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
|
||||
.tr \(*W-|\(bv\*(Tr
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.ie n \{\
|
||||
.ds -- \(*W-
|
||||
.ds PI pi
|
||||
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
.ds L" ""
|
||||
.ds R" ""
|
||||
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
|
||||
''' \*(L" and \*(R", except that they are used on ".xx" lines,
|
||||
''' such as .IP and .SH, which do another additional levels of
|
||||
''' double-quote interpretation
|
||||
.ds M" """
|
||||
.ds S" """
|
||||
.ds N" """""
|
||||
.ds T" """""
|
||||
.ds L' '
|
||||
.ds R' '
|
||||
.ds M' '
|
||||
.ds S' '
|
||||
.ds N' '
|
||||
.ds T' '
|
||||
. ds -- \(*W-
|
||||
. ds PI pi
|
||||
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
. ds L" ""
|
||||
. ds R" ""
|
||||
. ds C` `
|
||||
. ds C' '
|
||||
'br\}
|
||||
.el\{\
|
||||
.ds -- \(em\|
|
||||
.tr \*(Tr
|
||||
.ds L" ``
|
||||
.ds R" ''
|
||||
.ds M" ``
|
||||
.ds S" ''
|
||||
.ds N" ``
|
||||
.ds T" ''
|
||||
.ds L' `
|
||||
.ds R' '
|
||||
.ds M' `
|
||||
.ds S' '
|
||||
.ds N' `
|
||||
.ds T' '
|
||||
.ds PI \(*p
|
||||
. ds -- \|\(em\|
|
||||
. ds PI \(*p
|
||||
. ds L" ``
|
||||
. ds R" ''
|
||||
'br\}
|
||||
.\" If the F register is turned on, we'll generate
|
||||
.\" index entries out stderr for the following things:
|
||||
.\" TH Title
|
||||
.\" SH Header
|
||||
.\" Sh Subsection
|
||||
.\" Ip Item
|
||||
.\" X<> Xref (embedded
|
||||
.\" Of course, you have to process the output yourself
|
||||
.\" in some meaninful fashion.
|
||||
.if \nF \{
|
||||
.de IX
|
||||
.tm Index:\\$1\t\\n%\t"\\$2"
|
||||
..
|
||||
.nr % 0
|
||||
.rr F
|
||||
.\"
|
||||
.\" If the F register is turned on, we'll generate index entries on stderr
|
||||
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
|
||||
.\" index entries marked with X<> in POD. Of course, you'll have to process
|
||||
.\" the output yourself in some meaningful fashion.
|
||||
.if \nF \{\
|
||||
. de IX
|
||||
. tm Index:\\$1\t\\n%\t"\\$2"
|
||||
. .
|
||||
. nr % 0
|
||||
. rr F
|
||||
.\}
|
||||
.TH READELF.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
|
||||
.UC
|
||||
.if n .hy 0
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.de CQ \" put $1 in typewriter font
|
||||
.ft CW
|
||||
'if n "\c
|
||||
'if t \\&\\$1\c
|
||||
'if n \\&\\$1\c
|
||||
'if n \&"
|
||||
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
|
||||
'.ft R
|
||||
..
|
||||
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
|
||||
. \" AM - accent mark definitions
|
||||
.\"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it
|
||||
.\" makes way too many mistakes in technical documents.
|
||||
.hy 0
|
||||
.\"
|
||||
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
||||
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
||||
.bd B 3
|
||||
. \" fudge factors for nroff and troff
|
||||
. \" fudge factors for nroff and troff
|
||||
.if n \{\
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
.\}
|
||||
. \" simple accents for nroff and troff
|
||||
. \" simple accents for nroff and troff
|
||||
.if n \{\
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds ? ?
|
||||
. ds ! !
|
||||
. ds /
|
||||
. ds q
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds /
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
|
||||
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
.\}
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
||||
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
||||
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
|
||||
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
|
||||
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
|
||||
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
|
||||
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
||||
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
||||
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
||||
@ -164,226 +117,175 @@
|
||||
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
||||
.ds ae a\h'-(\w'a'u*4/10)'e
|
||||
.ds Ae A\h'-(\w'A'u*4/10)'E
|
||||
.ds oe o\h'-(\w'o'u*4/10)'e
|
||||
.ds Oe O\h'-(\w'O'u*4/10)'E
|
||||
. \" corrections for vroff
|
||||
. \" corrections for vroff
|
||||
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
||||
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
.if \n(.H>23 .if \n(.V>19 \
|
||||
\{\
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds v \h'-1'\o'\(aa\(ga'
|
||||
. ds _ \h'-1'^
|
||||
. ds . \h'-1'.
|
||||
. ds 3 3
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
. ds oe oe
|
||||
. ds Oe OE
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
.\}
|
||||
.rm #[ #] #H #V #F C
|
||||
.\" ======================================================================
|
||||
.\"
|
||||
.IX Title "READELF.1 1"
|
||||
.TH READELF.1 1 "binutils-2.11.90" "2001-05-30" "GNU"
|
||||
.UC
|
||||
.SH "NAME"
|
||||
readelf \- Displays information about ELF files.
|
||||
readelf \- Displays information about \s-1ELF\s0 files.
|
||||
.SH "SYNOPSIS"
|
||||
readelf [ \-a | --all ]
|
||||
[ \-h | --file-header]
|
||||
[ \-l | --program-headers | --segments]
|
||||
[ \-S | --section-headers | --sections]
|
||||
[ \-e | --headers]
|
||||
[ \-s | --syms | --symbols]
|
||||
[ \-n | --notes]
|
||||
[ \-r | --relocs]
|
||||
[ \-u | --unwind]
|
||||
[ \-d | --dynamic]
|
||||
[ \-V | --version-info]
|
||||
[ \-D | --use-dynamic]
|
||||
[ \-x <number> | --hex-dump=<number>]
|
||||
[ \-w[liaprf] | --debug-dump[=info,=line,=abbrev,=pubnames,=ranges,=frames]]
|
||||
[ --histogram]
|
||||
[ \-v | --version]
|
||||
[ \-H | --help]
|
||||
.IX Header "SYNOPSIS"
|
||||
readelf [ \-a | \-\-all ]
|
||||
[ \-h | \-\-file-header]
|
||||
[ \-l | \-\-program-headers | \-\-segments]
|
||||
[ \-S | \-\-section-headers | \-\-sections]
|
||||
[ \-e | \-\-headers]
|
||||
[ \-s | \-\-syms | \-\-symbols]
|
||||
[ \-n | \-\-notes]
|
||||
[ \-r | \-\-relocs]
|
||||
[ \-u | \-\-unwind]
|
||||
[ \-d | \-\-dynamic]
|
||||
[ \-V | \-\-version-info]
|
||||
[ \-D | \-\-use-dynamic]
|
||||
[ \-x <number> | \-\-hex-dump=<number>]
|
||||
[ \-w[liaprf] | \-\-debug-dump[=info,=line,=abbrev,=pubnames,=ranges,=frames]]
|
||||
[ \-\-histogram]
|
||||
[ \-v | \-\-version]
|
||||
[ \-H | \-\-help]
|
||||
\fIelffile\fR...
|
||||
.SH "DESCRIPTION"
|
||||
\f(CWreadelf\fR displays information about one or more ELF format object
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\f(CW\*(C`readelf\*(C'\fR displays information about one or more \s-1ELF\s0 format object
|
||||
files. The options control what particular information to display.
|
||||
.PP
|
||||
\fIelffile\fR... are the object files to be examined. At the
|
||||
moment, \f(CWreadelf\fR does not support examining archives, nor does it
|
||||
support examing 64 bit ELF files.
|
||||
\&\fIelffile\fR... are the object files to be examined. At the
|
||||
moment, \f(CW\*(C`readelf\*(C'\fR does not support examining archives, nor does it
|
||||
support examing 64 bit \s-1ELF\s0 files.
|
||||
.SH "OPTIONS"
|
||||
.IX Header "OPTIONS"
|
||||
The long and short forms of options, shown here as alternatives, are
|
||||
equivalent. At least one option besides \fB\-v\fR or \fB\-H\fR must be
|
||||
given.
|
||||
.Ip "\f(CW-a\fR" 4
|
||||
.Ip "\f(CW--all\fR" 4
|
||||
Equivalent to specifiying \fB--file-header\fR,
|
||||
\fB--program-headers\fR, \fB--sections\fR, \fB--symbols\fR,
|
||||
\fB--relocs\fR, \fB--dynamic\fR, \fB--notes\fR and
|
||||
\fB--version-info\fR.
|
||||
.Ip "\f(CW-h\fR" 4
|
||||
.Ip "\f(CW--file-header\fR" 4
|
||||
.Ip "\f(CW\*(C`\-a\*(C'\fR" 4
|
||||
.IX Item "-a"
|
||||
.Ip "\f(CW\*(C`\-\-all\*(C'\fR" 4
|
||||
.IX Item "--all"
|
||||
Equivalent to specifiying \fB\*(--file-header\fR,
|
||||
\&\fB\*(--program-headers\fR, \fB\*(--sections\fR, \fB\*(--symbols\fR,
|
||||
\&\fB\*(--relocs\fR, \fB\*(--dynamic\fR, \fB\*(--notes\fR and
|
||||
\&\fB\*(--version-info\fR.
|
||||
.Ip "\f(CW\*(C`\-h\*(C'\fR" 4
|
||||
.IX Item "-h"
|
||||
.Ip "\f(CW\*(C`\-\-file\-header\*(C'\fR" 4
|
||||
.IX Item "--file-header"
|
||||
Displays the information contained in the \s-1ELF\s0 header at the start of the
|
||||
file.
|
||||
.Ip "\f(CW-l\fR" 4
|
||||
.Ip "\f(CW--program-headers\fR" 4
|
||||
.Ip "\f(CW--segments\fR" 4
|
||||
.Ip "\f(CW\*(C`\-l\*(C'\fR" 4
|
||||
.IX Item "-l"
|
||||
.Ip "\f(CW\*(C`\-\-program\-headers\*(C'\fR" 4
|
||||
.IX Item "--program-headers"
|
||||
.Ip "\f(CW\*(C`\-\-segments\*(C'\fR" 4
|
||||
.IX Item "--segments"
|
||||
Displays the information contained in the file's segment headers, if it
|
||||
has any.
|
||||
.Ip "\f(CW-S\fR" 4
|
||||
.Ip "\f(CW--sections\fR" 4
|
||||
.Ip "\f(CW--section-headers\fR" 4
|
||||
.Ip "\f(CW\*(C`\-S\*(C'\fR" 4
|
||||
.IX Item "-S"
|
||||
.Ip "\f(CW\*(C`\-\-sections\*(C'\fR" 4
|
||||
.IX Item "--sections"
|
||||
.Ip "\f(CW\*(C`\-\-section\-headers\*(C'\fR" 4
|
||||
.IX Item "--section-headers"
|
||||
Displays the information contained in the file's section headers, if it
|
||||
has any.
|
||||
.Ip "\f(CW-s\fR" 4
|
||||
.Ip "\f(CW--symbols\fR" 4
|
||||
.Ip "\f(CW--syms\fR" 4
|
||||
.Ip "\f(CW\*(C`\-s\*(C'\fR" 4
|
||||
.IX Item "-s"
|
||||
.Ip "\f(CW\*(C`\-\-symbols\*(C'\fR" 4
|
||||
.IX Item "--symbols"
|
||||
.Ip "\f(CW\*(C`\-\-syms\*(C'\fR" 4
|
||||
.IX Item "--syms"
|
||||
Displays the entries in symbol table section of the file, if it has one.
|
||||
.Ip "\f(CW-e\fR" 4
|
||||
.Ip "\f(CW--headers\fR" 4
|
||||
.Ip "\f(CW\*(C`\-e\*(C'\fR" 4
|
||||
.IX Item "-e"
|
||||
.Ip "\f(CW\*(C`\-\-headers\*(C'\fR" 4
|
||||
.IX Item "--headers"
|
||||
Display all the headers in the file. Equivalent to \fB\-h \-l \-S\fR.
|
||||
.Ip "\f(CW-n\fR" 4
|
||||
.Ip "\f(CW--notes\fR" 4
|
||||
.Ip "\f(CW\*(C`\-n\*(C'\fR" 4
|
||||
.IX Item "-n"
|
||||
.Ip "\f(CW\*(C`\-\-notes\*(C'\fR" 4
|
||||
.IX Item "--notes"
|
||||
Displays the contents of the \s-1NOTE\s0 segment, if it exists.
|
||||
.Ip "\f(CW-r\fR" 4
|
||||
.Ip "\f(CW--relocs\fR" 4
|
||||
.Ip "\f(CW\*(C`\-r\*(C'\fR" 4
|
||||
.IX Item "-r"
|
||||
.Ip "\f(CW\*(C`\-\-relocs\*(C'\fR" 4
|
||||
.IX Item "--relocs"
|
||||
Displays the contents of the file's relocation section, if it has one.
|
||||
.Ip "\f(CW-u\fR" 4
|
||||
.Ip "\f(CW--unwind\fR" 4
|
||||
.Ip "\f(CW\*(C`\-u\*(C'\fR" 4
|
||||
.IX Item "-u"
|
||||
.Ip "\f(CW\*(C`\-\-unwind\*(C'\fR" 4
|
||||
.IX Item "--unwind"
|
||||
Displays the contents of the file's unwind section, if it has one. Only
|
||||
the unwind sections for \s-1IA64\s0 \s-1ELF\s0 files are currently supported.
|
||||
.Ip "\f(CW-d\fR" 4
|
||||
.Ip "\f(CW--dynamic\fR" 4
|
||||
.Ip "\f(CW\*(C`\-d\*(C'\fR" 4
|
||||
.IX Item "-d"
|
||||
.Ip "\f(CW\*(C`\-\-dynamic\*(C'\fR" 4
|
||||
.IX Item "--dynamic"
|
||||
Displays the contents of the file's dynamic section, if it has one.
|
||||
.Ip "\f(CW-V\fR" 4
|
||||
.Ip "\f(CW--version-info\fR" 4
|
||||
.Ip "\f(CW\*(C`\-V\*(C'\fR" 4
|
||||
.IX Item "-V"
|
||||
.Ip "\f(CW\*(C`\-\-version\-info\*(C'\fR" 4
|
||||
.IX Item "--version-info"
|
||||
Displays the contents of the version sections in the file, it they
|
||||
exist.
|
||||
.Ip "\f(CW-D\fR" 4
|
||||
.Ip "\f(CW--use-dynamic\fR" 4
|
||||
When displaying symbols, this option makes \f(CWreadelf\fR use the
|
||||
.Ip "\f(CW\*(C`\-D\*(C'\fR" 4
|
||||
.IX Item "-D"
|
||||
.Ip "\f(CW\*(C`\-\-use\-dynamic\*(C'\fR" 4
|
||||
.IX Item "--use-dynamic"
|
||||
When displaying symbols, this option makes \f(CW\*(C`readelf\*(C'\fR use the
|
||||
symbol table in the file's dynamic section, rather than the one in the
|
||||
symbols section.
|
||||
.Ip "\f(CW-x <number>\fR" 4
|
||||
.Ip "\f(CW--hex-dump=<number>\fR" 4
|
||||
.Ip "\f(CW\*(C`\-x <number>\*(C'\fR" 4
|
||||
.IX Item "-x <number>"
|
||||
.Ip "\f(CW\*(C`\-\-hex\-dump=<number>\*(C'\fR" 4
|
||||
.IX Item "--hex-dump=<number>"
|
||||
Displays the contents of the indicated section as a hexadecimal dump.
|
||||
.Ip "\f(CW-w[liaprf]\fR" 4
|
||||
.Ip "\f(CW--debug-dump[=line,=info,=abbrev,=pubnames,=ranges,=frames]\fR" 4
|
||||
.Ip "\f(CW\*(C`\-w[liaprf]\*(C'\fR" 4
|
||||
.IX Item "-w[liaprf]"
|
||||
.Ip "\f(CW\*(C`\-\-debug\-dump[=line,=info,=abbrev,=pubnames,=ranges,=frames]\*(C'\fR" 4
|
||||
.IX Item "--debug-dump[=line,=info,=abbrev,=pubnames,=ranges,=frames]"
|
||||
Displays the contents of the debug sections in the file, if any are
|
||||
present. If one of the optional letters or words follows the switch
|
||||
then only data found in those specific sections will be dumped.
|
||||
.Ip "\f(CW--histogram\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-histogram\*(C'\fR" 4
|
||||
.IX Item "--histogram"
|
||||
Display a histogram of bucket list lengths when displaying the contents
|
||||
of the symbol tables.
|
||||
.Ip "\f(CW-v\fR" 4
|
||||
.Ip "\f(CW--version\fR" 4
|
||||
.Ip "\f(CW\*(C`\-v\*(C'\fR" 4
|
||||
.IX Item "-v"
|
||||
.Ip "\f(CW\*(C`\-\-version\*(C'\fR" 4
|
||||
.IX Item "--version"
|
||||
Display the version number of readelf.
|
||||
.Ip "\f(CW-H\fR" 4
|
||||
.Ip "\f(CW--help\fR" 4
|
||||
Display the command line options understood by \f(CWreadelf\fR.
|
||||
.Ip "\f(CW\*(C`\-H\*(C'\fR" 4
|
||||
.IX Item "-H"
|
||||
.Ip "\f(CW\*(C`\-\-help\*(C'\fR" 4
|
||||
.IX Item "--help"
|
||||
Display the command line options understood by \f(CW\*(C`readelf\*(C'\fR.
|
||||
.SH "SEE ALSO"
|
||||
\fIobjdump\fR\|(1), and the Info entries for \fIbinutils\fR.
|
||||
.IX Header "SEE ALSO"
|
||||
\&\fIobjdump\fR\|(1), and the Info entries for \fIbinutils\fR.
|
||||
.SH "COPYRIGHT"
|
||||
.IX Header "COPYRIGHT"
|
||||
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
|
||||
.PP
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||||
Back-Cover Texts. A copy of the license is included in the
|
||||
section entitled \*(L"GNU Free Documentation License\*(R".
|
||||
|
||||
.rn }` ''
|
||||
.IX Title "READELF.1 1"
|
||||
.IX Name "readelf - Displays information about ELF files."
|
||||
|
||||
.IX Header "NAME"
|
||||
|
||||
.IX Header "SYNOPSIS"
|
||||
|
||||
.IX Header "DESCRIPTION"
|
||||
|
||||
.IX Header "OPTIONS"
|
||||
|
||||
.IX Item "\f(CW-a\fR"
|
||||
|
||||
.IX Item "\f(CW--all\fR"
|
||||
|
||||
.IX Item "\f(CW-h\fR"
|
||||
|
||||
.IX Item "\f(CW--file-header\fR"
|
||||
|
||||
.IX Item "\f(CW-l\fR"
|
||||
|
||||
.IX Item "\f(CW--program-headers\fR"
|
||||
|
||||
.IX Item "\f(CW--segments\fR"
|
||||
|
||||
.IX Item "\f(CW-S\fR"
|
||||
|
||||
.IX Item "\f(CW--sections\fR"
|
||||
|
||||
.IX Item "\f(CW--section-headers\fR"
|
||||
|
||||
.IX Item "\f(CW-s\fR"
|
||||
|
||||
.IX Item "\f(CW--symbols\fR"
|
||||
|
||||
.IX Item "\f(CW--syms\fR"
|
||||
|
||||
.IX Item "\f(CW-e\fR"
|
||||
|
||||
.IX Item "\f(CW--headers\fR"
|
||||
|
||||
.IX Item "\f(CW-n\fR"
|
||||
|
||||
.IX Item "\f(CW--notes\fR"
|
||||
|
||||
.IX Item "\f(CW-r\fR"
|
||||
|
||||
.IX Item "\f(CW--relocs\fR"
|
||||
|
||||
.IX Item "\f(CW-u\fR"
|
||||
|
||||
.IX Item "\f(CW--unwind\fR"
|
||||
|
||||
.IX Item "\f(CW-d\fR"
|
||||
|
||||
.IX Item "\f(CW--dynamic\fR"
|
||||
|
||||
.IX Item "\f(CW-V\fR"
|
||||
|
||||
.IX Item "\f(CW--version-info\fR"
|
||||
|
||||
.IX Item "\f(CW-D\fR"
|
||||
|
||||
.IX Item "\f(CW--use-dynamic\fR"
|
||||
|
||||
.IX Item "\f(CW-x <number>\fR"
|
||||
|
||||
.IX Item "\f(CW--hex-dump=<number>\fR"
|
||||
|
||||
.IX Item "\f(CW-w[liaprf]\fR"
|
||||
|
||||
.IX Item "\f(CW--debug-dump[=line,=info,=abbrev,=pubnames,=ranges,=frames]\fR"
|
||||
|
||||
.IX Item "\f(CW--histogram\fR"
|
||||
|
||||
.IX Item "\f(CW-v\fR"
|
||||
|
||||
.IX Item "\f(CW--version\fR"
|
||||
|
||||
.IX Item "\f(CW-H\fR"
|
||||
|
||||
.IX Item "\f(CW--help\fR"
|
||||
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
.IX Header "COPYRIGHT"
|
||||
|
||||
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
|
||||
|
||||
363
binutils/size.1
363
binutils/size.1
@ -1,12 +1,9 @@
|
||||
.rn '' }`
|
||||
''' $RCSfile$$Revision$$Date$
|
||||
'''
|
||||
''' $Log$
|
||||
''' Revision 1.5 2001/03/25 20:32:25 nickc
|
||||
''' Automate generate on man pages
|
||||
'''
|
||||
'''
|
||||
.de Sh
|
||||
.\" Automatically generated by Pod::Man version 1.02
|
||||
.\" Wed May 30 12:24:29 2001
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ======================================================================
|
||||
.de Sh \" Subsection heading
|
||||
.br
|
||||
.if t .Sp
|
||||
.ne 5
|
||||
@ -14,149 +11,105 @@
|
||||
\fB\\$1\fR
|
||||
.PP
|
||||
..
|
||||
.de Sp
|
||||
.de Sp \" Vertical space (when we can't use .PP)
|
||||
.if t .sp .5v
|
||||
.if n .sp
|
||||
..
|
||||
.de Ip
|
||||
.de Ip \" List item
|
||||
.br
|
||||
.ie \\n(.$>=3 .ne \\$3
|
||||
.el .ne 3
|
||||
.IP "\\$1" \\$2
|
||||
..
|
||||
.de Vb
|
||||
.de Vb \" Begin verbatim text
|
||||
.ft CW
|
||||
.nf
|
||||
.ne \\$1
|
||||
..
|
||||
.de Ve
|
||||
.de Ve \" End verbatim text
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
'''
|
||||
'''
|
||||
''' Set up \*(-- to give an unbreakable dash;
|
||||
''' string Tr holds user defined translation string.
|
||||
''' Bell System Logo is used as a dummy character.
|
||||
'''
|
||||
.\" Set up some character translations and predefined strings. \*(-- will
|
||||
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
||||
.\" double quote, and \*(R" will give a right double quote. | will give a
|
||||
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
|
||||
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
|
||||
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
|
||||
.tr \(*W-|\(bv\*(Tr
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.ie n \{\
|
||||
.ds -- \(*W-
|
||||
.ds PI pi
|
||||
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
.ds L" ""
|
||||
.ds R" ""
|
||||
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
|
||||
''' \*(L" and \*(R", except that they are used on ".xx" lines,
|
||||
''' such as .IP and .SH, which do another additional levels of
|
||||
''' double-quote interpretation
|
||||
.ds M" """
|
||||
.ds S" """
|
||||
.ds N" """""
|
||||
.ds T" """""
|
||||
.ds L' '
|
||||
.ds R' '
|
||||
.ds M' '
|
||||
.ds S' '
|
||||
.ds N' '
|
||||
.ds T' '
|
||||
. ds -- \(*W-
|
||||
. ds PI pi
|
||||
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
. ds L" ""
|
||||
. ds R" ""
|
||||
. ds C` `
|
||||
. ds C' '
|
||||
'br\}
|
||||
.el\{\
|
||||
.ds -- \(em\|
|
||||
.tr \*(Tr
|
||||
.ds L" ``
|
||||
.ds R" ''
|
||||
.ds M" ``
|
||||
.ds S" ''
|
||||
.ds N" ``
|
||||
.ds T" ''
|
||||
.ds L' `
|
||||
.ds R' '
|
||||
.ds M' `
|
||||
.ds S' '
|
||||
.ds N' `
|
||||
.ds T' '
|
||||
.ds PI \(*p
|
||||
. ds -- \|\(em\|
|
||||
. ds PI \(*p
|
||||
. ds L" ``
|
||||
. ds R" ''
|
||||
'br\}
|
||||
.\" If the F register is turned on, we'll generate
|
||||
.\" index entries out stderr for the following things:
|
||||
.\" TH Title
|
||||
.\" SH Header
|
||||
.\" Sh Subsection
|
||||
.\" Ip Item
|
||||
.\" X<> Xref (embedded
|
||||
.\" Of course, you have to process the output yourself
|
||||
.\" in some meaninful fashion.
|
||||
.if \nF \{
|
||||
.de IX
|
||||
.tm Index:\\$1\t\\n%\t"\\$2"
|
||||
..
|
||||
.nr % 0
|
||||
.rr F
|
||||
.\"
|
||||
.\" If the F register is turned on, we'll generate index entries on stderr
|
||||
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
|
||||
.\" index entries marked with X<> in POD. Of course, you'll have to process
|
||||
.\" the output yourself in some meaningful fashion.
|
||||
.if \nF \{\
|
||||
. de IX
|
||||
. tm Index:\\$1\t\\n%\t"\\$2"
|
||||
. .
|
||||
. nr % 0
|
||||
. rr F
|
||||
.\}
|
||||
.TH SIZE.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
|
||||
.UC
|
||||
.if n .hy 0
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.de CQ \" put $1 in typewriter font
|
||||
.ft CW
|
||||
'if n "\c
|
||||
'if t \\&\\$1\c
|
||||
'if n \\&\\$1\c
|
||||
'if n \&"
|
||||
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
|
||||
'.ft R
|
||||
..
|
||||
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
|
||||
. \" AM - accent mark definitions
|
||||
.\"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it
|
||||
.\" makes way too many mistakes in technical documents.
|
||||
.hy 0
|
||||
.\"
|
||||
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
||||
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
||||
.bd B 3
|
||||
. \" fudge factors for nroff and troff
|
||||
. \" fudge factors for nroff and troff
|
||||
.if n \{\
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
.\}
|
||||
. \" simple accents for nroff and troff
|
||||
. \" simple accents for nroff and troff
|
||||
.if n \{\
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds ? ?
|
||||
. ds ! !
|
||||
. ds /
|
||||
. ds q
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds /
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
|
||||
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
.\}
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
||||
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
||||
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
|
||||
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
|
||||
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
|
||||
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
|
||||
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
||||
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
||||
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
||||
@ -164,152 +117,126 @@
|
||||
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
||||
.ds ae a\h'-(\w'a'u*4/10)'e
|
||||
.ds Ae A\h'-(\w'A'u*4/10)'E
|
||||
.ds oe o\h'-(\w'o'u*4/10)'e
|
||||
.ds Oe O\h'-(\w'O'u*4/10)'E
|
||||
. \" corrections for vroff
|
||||
. \" corrections for vroff
|
||||
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
||||
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
.if \n(.H>23 .if \n(.V>19 \
|
||||
\{\
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds v \h'-1'\o'\(aa\(ga'
|
||||
. ds _ \h'-1'^
|
||||
. ds . \h'-1'.
|
||||
. ds 3 3
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
. ds oe oe
|
||||
. ds Oe OE
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
.\}
|
||||
.rm #[ #] #H #V #F C
|
||||
.\" ======================================================================
|
||||
.\"
|
||||
.IX Title "SIZE.1 1"
|
||||
.TH SIZE.1 1 "binutils-2.11.90" "2001-05-30" "GNU"
|
||||
.UC
|
||||
.SH "NAME"
|
||||
size \- list section sizes and total size.
|
||||
.SH "SYNOPSIS"
|
||||
size [ \-A | \-B | --format=\fIcompatibility\fR ]
|
||||
[ --help ] [ \-d | \-o | \-x | --radix=\fInumber\fR ]
|
||||
[ --target=\fIbfdname\fR ] [ \-V | --version ]
|
||||
.IX Header "SYNOPSIS"
|
||||
size [ \-A | \-B | \-\-format=\fIcompatibility\fR ]
|
||||
[ \-\-help ] [ \-d | \-o | \-x | \-\-radix=\fInumber\fR ]
|
||||
[ \-\-target=\fIbfdname\fR ] [ \-V | \-\-version ]
|
||||
[ \fIobjfile\fR... ]
|
||||
.SH "DESCRIPTION"
|
||||
The GNU \f(CWsize\fR utility lists the section sizes---and the total
|
||||
size---for each of the object or archive files \fIobjfile\fR in its
|
||||
.IX Header "DESCRIPTION"
|
||||
The \s-1GNU\s0 \f(CW\*(C`size\*(C'\fR utility lists the section sizes\-\-\-and the total
|
||||
size\-\-\-for each of the object or archive files \fIobjfile\fR in its
|
||||
argument list. By default, one line of output is generated for each
|
||||
object file or each module in an archive.
|
||||
.PP
|
||||
\fIobjfile\fR... are the object files to be examined.
|
||||
If none are specified, the file \f(CWa.out\fR will be used.
|
||||
\&\fIobjfile\fR... are the object files to be examined.
|
||||
If none are specified, the file \f(CW\*(C`a.out\*(C'\fR will be used.
|
||||
.SH "OPTIONS"
|
||||
.IX Header "OPTIONS"
|
||||
The command line options have the following meanings:
|
||||
.Ip "\f(CW-A\fR" 4
|
||||
.Ip "\f(CW-B\fR" 4
|
||||
.Ip "\f(CW--format=\fIcompatibility\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-A\*(C'\fR" 4
|
||||
.IX Item "-A"
|
||||
.Ip "\f(CW\*(C`\-B\*(C'\fR" 4
|
||||
.IX Item "-B"
|
||||
.Ip "\f(CW\*(C`\-\-format=\f(CIcompatibility\f(CW\*(C'\fR" 4
|
||||
.IX Item "--format=compatibility"
|
||||
Using one of these options, you can choose whether the output from \s-1GNU\s0
|
||||
\f(CWsize\fR resembles output from System V \f(CWsize\fR (using \fB\-A\fR,
|
||||
or \fB--format=sysv\fR), or Berkeley \f(CWsize\fR (using \fB\-B\fR, or
|
||||
\fB--format=berkeley\fR). The default is the one-line format similar to
|
||||
\&\f(CW\*(C`size\*(C'\fR resembles output from System V \f(CW\*(C`size\*(C'\fR (using \fB\-A\fR,
|
||||
or \fB\*(--format=sysv\fR), or Berkeley \f(CW\*(C`size\*(C'\fR (using \fB\-B\fR, or
|
||||
\&\fB\*(--format=berkeley\fR). The default is the one-line format similar to
|
||||
Berkeley's.
|
||||
.Sp
|
||||
Here is an example of the Berkeley (default) format of output from
|
||||
\f(CWsize\fR:
|
||||
|
||||
$ size --format=Berkeley ranlib size
|
||||
text data bss dec hex filename
|
||||
294880 81920 11592 388392 5ed28 ranlib
|
||||
294880 81920 11888 388688 5ee50 size
|
||||
\&\f(CW\*(C`size\*(C'\fR:
|
||||
.Sp
|
||||
.Vb 4
|
||||
\& $ size --format=Berkeley ranlib size
|
||||
\& text data bss dec hex filename
|
||||
\& 294880 81920 11592 388392 5ed28 ranlib
|
||||
\& 294880 81920 11888 388688 5ee50 size
|
||||
.Ve
|
||||
This is the same data, but displayed closer to System V conventions:
|
||||
.Sp
|
||||
.Vb 16
|
||||
\&
|
||||
.Vb 7
|
||||
\& $ size --format=SysV ranlib size
|
||||
\& ranlib :
|
||||
\& section size addr
|
||||
\& .text 294880 8192
|
||||
\& .data 81920 303104
|
||||
\& .bss 11592 385024
|
||||
\& Total 388392
|
||||
\&
|
||||
\&
|
||||
\& Total 388392
|
||||
.Ve
|
||||
.Vb 6
|
||||
\& size :
|
||||
\& section size addr
|
||||
\& .text 294880 8192
|
||||
\& .data 81920 303104
|
||||
\& .bss 11888 385024
|
||||
\& Total 388688
|
||||
\& Total 388688
|
||||
.Ve
|
||||
.Ip "\f(CW--help\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-help\*(C'\fR" 4
|
||||
.IX Item "--help"
|
||||
Show a summary of acceptable arguments and options.
|
||||
.Ip "\f(CW-d\fR" 4
|
||||
.Ip "\f(CW-o\fR" 4
|
||||
.Ip "\f(CW-x\fR" 4
|
||||
.Ip "\f(CW--radix=\fInumber\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-d\*(C'\fR" 4
|
||||
.IX Item "-d"
|
||||
.Ip "\f(CW\*(C`\-o\*(C'\fR" 4
|
||||
.IX Item "-o"
|
||||
.Ip "\f(CW\*(C`\-x\*(C'\fR" 4
|
||||
.IX Item "-x"
|
||||
.Ip "\f(CW\*(C`\-\-radix=\f(CInumber\f(CW\*(C'\fR" 4
|
||||
.IX Item "--radix=number"
|
||||
Using one of these options, you can control whether the size of each
|
||||
section is given in decimal (\fB\-d\fR, or \fB--radix=10\fR); octal
|
||||
(\fB\-o\fR, or \fB--radix=8\fR); or hexadecimal (\fB\-x\fR, or
|
||||
\fB--radix=16\fR). In \fB--radix=\fR\fInumber\fR, only the three
|
||||
section is given in decimal (\fB\-d\fR, or \fB\*(--radix=10\fR); octal
|
||||
(\fB\-o\fR, or \fB\*(--radix=8\fR); or hexadecimal (\fB\-x\fR, or
|
||||
\&\fB\*(--radix=16\fR). In \fB\*(--radix=\fR\fInumber\fR, only the three
|
||||
values (8, 10, 16) are supported. The total size is always given in two
|
||||
radices; decimal and hexadecimal for \fB\-d\fR or \fB\-x\fR output, or
|
||||
octal and hexadecimal if you're using \fB\-o\fR.
|
||||
.Ip "\f(CW--target=\fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--target=bfdname"
|
||||
Specify that the object-code format for \fIobjfile\fR is
|
||||
\fIbfdname\fR. This option may not be necessary; \f(CWsize\fR can
|
||||
\&\fIbfdname\fR. This option may not be necessary; \f(CW\*(C`size\*(C'\fR can
|
||||
automatically recognize many formats.
|
||||
.Ip "\f(CW-V\fR" 4
|
||||
.Ip "\f(CW--version\fR" 4
|
||||
Display the version number of \f(CWsize\fR.
|
||||
.Ip "\f(CW\*(C`\-V\*(C'\fR" 4
|
||||
.IX Item "-V"
|
||||
.Ip "\f(CW\*(C`\-\-version\*(C'\fR" 4
|
||||
.IX Item "--version"
|
||||
Display the version number of \f(CW\*(C`size\*(C'\fR.
|
||||
.SH "SEE ALSO"
|
||||
\fIar\fR\|(1), \fIobjdump\fR\|(1), \fIreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
|
||||
.IX Header "SEE ALSO"
|
||||
\&\fIar\fR\|(1), \fIobjdump\fR\|(1), \fIreadelf\fR\|(1), and the Info entries for \fIbinutils\fR.
|
||||
.SH "COPYRIGHT"
|
||||
.IX Header "COPYRIGHT"
|
||||
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
|
||||
.PP
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||||
Back-Cover Texts. A copy of the license is included in the
|
||||
section entitled \*(L"GNU Free Documentation License\*(R".
|
||||
|
||||
.rn }` ''
|
||||
.IX Title "SIZE.1 1"
|
||||
.IX Name "size - list section sizes and total size."
|
||||
|
||||
.IX Header "NAME"
|
||||
|
||||
.IX Header "SYNOPSIS"
|
||||
|
||||
.IX Header "DESCRIPTION"
|
||||
|
||||
.IX Header "OPTIONS"
|
||||
|
||||
.IX Item "\f(CW-A\fR"
|
||||
|
||||
.IX Item "\f(CW-B\fR"
|
||||
|
||||
.IX Item "\f(CW--format=\fIcompatibility\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--help\fR"
|
||||
|
||||
.IX Item "\f(CW-d\fR"
|
||||
|
||||
.IX Item "\f(CW-o\fR"
|
||||
|
||||
.IX Item "\f(CW-x\fR"
|
||||
|
||||
.IX Item "\f(CW--radix=\fInumber\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--target=\fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-V\fR"
|
||||
|
||||
.IX Item "\f(CW--version\fR"
|
||||
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
.IX Header "COPYRIGHT"
|
||||
|
||||
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
|
||||
|
||||
@ -1,12 +1,9 @@
|
||||
.rn '' }`
|
||||
''' $RCSfile$$Revision$$Date$
|
||||
'''
|
||||
''' $Log$
|
||||
''' Revision 1.7 2001/03/25 20:32:25 nickc
|
||||
''' Automate generate on man pages
|
||||
'''
|
||||
'''
|
||||
.de Sh
|
||||
.\" Automatically generated by Pod::Man version 1.02
|
||||
.\" Wed May 30 12:24:29 2001
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ======================================================================
|
||||
.de Sh \" Subsection heading
|
||||
.br
|
||||
.if t .Sp
|
||||
.ne 5
|
||||
@ -14,149 +11,105 @@
|
||||
\fB\\$1\fR
|
||||
.PP
|
||||
..
|
||||
.de Sp
|
||||
.de Sp \" Vertical space (when we can't use .PP)
|
||||
.if t .sp .5v
|
||||
.if n .sp
|
||||
..
|
||||
.de Ip
|
||||
.de Ip \" List item
|
||||
.br
|
||||
.ie \\n(.$>=3 .ne \\$3
|
||||
.el .ne 3
|
||||
.IP "\\$1" \\$2
|
||||
..
|
||||
.de Vb
|
||||
.de Vb \" Begin verbatim text
|
||||
.ft CW
|
||||
.nf
|
||||
.ne \\$1
|
||||
..
|
||||
.de Ve
|
||||
.de Ve \" End verbatim text
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
'''
|
||||
'''
|
||||
''' Set up \*(-- to give an unbreakable dash;
|
||||
''' string Tr holds user defined translation string.
|
||||
''' Bell System Logo is used as a dummy character.
|
||||
'''
|
||||
.\" Set up some character translations and predefined strings. \*(-- will
|
||||
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
||||
.\" double quote, and \*(R" will give a right double quote. | will give a
|
||||
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
|
||||
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
|
||||
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
|
||||
.tr \(*W-|\(bv\*(Tr
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.ie n \{\
|
||||
.ds -- \(*W-
|
||||
.ds PI pi
|
||||
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
.ds L" ""
|
||||
.ds R" ""
|
||||
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
|
||||
''' \*(L" and \*(R", except that they are used on ".xx" lines,
|
||||
''' such as .IP and .SH, which do another additional levels of
|
||||
''' double-quote interpretation
|
||||
.ds M" """
|
||||
.ds S" """
|
||||
.ds N" """""
|
||||
.ds T" """""
|
||||
.ds L' '
|
||||
.ds R' '
|
||||
.ds M' '
|
||||
.ds S' '
|
||||
.ds N' '
|
||||
.ds T' '
|
||||
. ds -- \(*W-
|
||||
. ds PI pi
|
||||
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
. ds L" ""
|
||||
. ds R" ""
|
||||
. ds C` `
|
||||
. ds C' '
|
||||
'br\}
|
||||
.el\{\
|
||||
.ds -- \(em\|
|
||||
.tr \*(Tr
|
||||
.ds L" ``
|
||||
.ds R" ''
|
||||
.ds M" ``
|
||||
.ds S" ''
|
||||
.ds N" ``
|
||||
.ds T" ''
|
||||
.ds L' `
|
||||
.ds R' '
|
||||
.ds M' `
|
||||
.ds S' '
|
||||
.ds N' `
|
||||
.ds T' '
|
||||
.ds PI \(*p
|
||||
. ds -- \|\(em\|
|
||||
. ds PI \(*p
|
||||
. ds L" ``
|
||||
. ds R" ''
|
||||
'br\}
|
||||
.\" If the F register is turned on, we'll generate
|
||||
.\" index entries out stderr for the following things:
|
||||
.\" TH Title
|
||||
.\" SH Header
|
||||
.\" Sh Subsection
|
||||
.\" Ip Item
|
||||
.\" X<> Xref (embedded
|
||||
.\" Of course, you have to process the output yourself
|
||||
.\" in some meaninful fashion.
|
||||
.if \nF \{
|
||||
.de IX
|
||||
.tm Index:\\$1\t\\n%\t"\\$2"
|
||||
..
|
||||
.nr % 0
|
||||
.rr F
|
||||
.\"
|
||||
.\" If the F register is turned on, we'll generate index entries on stderr
|
||||
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
|
||||
.\" index entries marked with X<> in POD. Of course, you'll have to process
|
||||
.\" the output yourself in some meaningful fashion.
|
||||
.if \nF \{\
|
||||
. de IX
|
||||
. tm Index:\\$1\t\\n%\t"\\$2"
|
||||
. .
|
||||
. nr % 0
|
||||
. rr F
|
||||
.\}
|
||||
.TH STRINGS.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
|
||||
.UC
|
||||
.if n .hy 0
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.de CQ \" put $1 in typewriter font
|
||||
.ft CW
|
||||
'if n "\c
|
||||
'if t \\&\\$1\c
|
||||
'if n \\&\\$1\c
|
||||
'if n \&"
|
||||
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
|
||||
'.ft R
|
||||
..
|
||||
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
|
||||
. \" AM - accent mark definitions
|
||||
.\"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it
|
||||
.\" makes way too many mistakes in technical documents.
|
||||
.hy 0
|
||||
.\"
|
||||
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
||||
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
||||
.bd B 3
|
||||
. \" fudge factors for nroff and troff
|
||||
. \" fudge factors for nroff and troff
|
||||
.if n \{\
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
.\}
|
||||
. \" simple accents for nroff and troff
|
||||
. \" simple accents for nroff and troff
|
||||
.if n \{\
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds ? ?
|
||||
. ds ! !
|
||||
. ds /
|
||||
. ds q
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds /
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
|
||||
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
.\}
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
||||
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
||||
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
|
||||
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
|
||||
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
|
||||
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
|
||||
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
||||
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
||||
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
||||
@ -164,134 +117,104 @@
|
||||
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
||||
.ds ae a\h'-(\w'a'u*4/10)'e
|
||||
.ds Ae A\h'-(\w'A'u*4/10)'E
|
||||
.ds oe o\h'-(\w'o'u*4/10)'e
|
||||
.ds Oe O\h'-(\w'O'u*4/10)'E
|
||||
. \" corrections for vroff
|
||||
. \" corrections for vroff
|
||||
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
||||
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
.if \n(.H>23 .if \n(.V>19 \
|
||||
\{\
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds v \h'-1'\o'\(aa\(ga'
|
||||
. ds _ \h'-1'^
|
||||
. ds . \h'-1'.
|
||||
. ds 3 3
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
. ds oe oe
|
||||
. ds Oe OE
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
.\}
|
||||
.rm #[ #] #H #V #F C
|
||||
.\" ======================================================================
|
||||
.\"
|
||||
.IX Title "STRINGS.1 1"
|
||||
.TH STRINGS.1 1 "binutils-2.11.90" "2001-05-30" "GNU"
|
||||
.UC
|
||||
.SH "NAME"
|
||||
strings \- print the strings of printable characters in files.
|
||||
.SH "SYNOPSIS"
|
||||
strings [\-afov] [\-\fImin-len\fR] [\-n \fImin-len\fR] [\-t \fIradix\fR] [\-]
|
||||
[--all] [--print-file-name] [--bytes=\fImin-len\fR]
|
||||
[--radix=\fIradix\fR] [--target=\fIbfdname\fR]
|
||||
[--help] [--version] \fIfile\fR...
|
||||
.IX Header "SYNOPSIS"
|
||||
strings [\-afov] [-\fImin-len\fR] [\-n \fImin-len\fR] [\-t \fIradix\fR] [\-]
|
||||
[\-\-all] [\-\-print-file-name] [\-\-bytes=\fImin-len\fR]
|
||||
[\-\-radix=\fIradix\fR] [\-\-target=\fIbfdname\fR]
|
||||
[\-\-help] [\-\-version] \fIfile\fR...
|
||||
.SH "DESCRIPTION"
|
||||
For each \fIfile\fR given, GNU \f(CWstrings\fR prints the printable
|
||||
.IX Header "DESCRIPTION"
|
||||
For each \fIfile\fR given, \s-1GNU\s0 \f(CW\*(C`strings\*(C'\fR prints the printable
|
||||
character sequences that are at least 4 characters long (or the number
|
||||
given with the options below) and are followed by an unprintable
|
||||
character. By default, it only prints the strings from the initialized
|
||||
and loaded sections of object files; for other types of files, it prints
|
||||
the strings from the whole file.
|
||||
.PP
|
||||
\f(CWstrings\fR is mainly useful for determining the contents of non-text
|
||||
\&\f(CW\*(C`strings\*(C'\fR is mainly useful for determining the contents of non-text
|
||||
files.
|
||||
.SH "OPTIONS"
|
||||
.Ip "\f(CW-a\fR" 4
|
||||
.Ip "\f(CW--all\fR" 4
|
||||
.Ip "\f(CW-\fR" 4
|
||||
.IX Header "OPTIONS"
|
||||
.Ip "\f(CW\*(C`\-a\*(C'\fR" 4
|
||||
.IX Item "-a"
|
||||
.Ip "\f(CW\*(C`\-\-all\*(C'\fR" 4
|
||||
.IX Item "--all"
|
||||
.Ip "\f(CW\*(C`\-\*(C'\fR" 4
|
||||
.IX Item "-"
|
||||
Do not scan only the initialized and loaded sections of object files;
|
||||
scan the whole files.
|
||||
.Ip "\f(CW-f\fR" 4
|
||||
.Ip "\f(CW--print-file-name\fR" 4
|
||||
.Ip "\f(CW\*(C`\-f\*(C'\fR" 4
|
||||
.IX Item "-f"
|
||||
.Ip "\f(CW\*(C`\-\-print\-file\-name\*(C'\fR" 4
|
||||
.IX Item "--print-file-name"
|
||||
Print the name of the file before each string.
|
||||
.Ip "\f(CW--help\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-help\*(C'\fR" 4
|
||||
.IX Item "--help"
|
||||
Print a summary of the program usage on the standard output and exit.
|
||||
.Ip "\f(CW-\fImin-len\fR\fR" 4
|
||||
.Ip "\f(CW-n \fImin-len\fR\fR" 4
|
||||
.Ip "\f(CW--bytes=\fImin-len\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\f(CImin\-len\f(CW\*(C'\fR" 4
|
||||
.IX Item "-min-len"
|
||||
.Ip "\f(CW\*(C`\-n \f(CImin\-len\f(CW\*(C'\fR" 4
|
||||
.IX Item "-n min-len"
|
||||
.Ip "\f(CW\*(C`\-\-bytes=\f(CImin\-len\f(CW\*(C'\fR" 4
|
||||
.IX Item "--bytes=min-len"
|
||||
Print sequences of characters that are at least \fImin-len\fR characters
|
||||
long, instead of the default 4.
|
||||
.Ip "\f(CW-o\fR" 4
|
||||
Like \fB\-t o\fR. Some other versions of \f(CWstrings\fR have \fB\-o\fR
|
||||
.Ip "\f(CW\*(C`\-o\*(C'\fR" 4
|
||||
.IX Item "-o"
|
||||
Like \fB\-t o\fR. Some other versions of \f(CW\*(C`strings\*(C'\fR have \fB\-o\fR
|
||||
act like \fB\-t d\fR instead. Since we can not be compatible with both
|
||||
ways, we simply chose one.
|
||||
.Ip "\f(CW-t \fIradix\fR\fR" 4
|
||||
.Ip "\f(CW--radix=\fIradix\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-t \f(CIradix\f(CW\*(C'\fR" 4
|
||||
.IX Item "-t radix"
|
||||
.Ip "\f(CW\*(C`\-\-radix=\f(CIradix\f(CW\*(C'\fR" 4
|
||||
.IX Item "--radix=radix"
|
||||
Print the offset within the file before each string. The single
|
||||
character argument specifies the radix of the offset---\fBo\fR for
|
||||
character argument specifies the radix of the offset\-\--\fBo\fR for
|
||||
octal, \fBx\fR for hexadecimal, or \fBd\fR for decimal.
|
||||
.Ip "\f(CW--target=\fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--target=bfdname"
|
||||
Specify an object code format other than your system's default format.
|
||||
.Ip "\f(CW-v\fR" 4
|
||||
.Ip "\f(CW--version\fR" 4
|
||||
.Ip "\f(CW\*(C`\-v\*(C'\fR" 4
|
||||
.IX Item "-v"
|
||||
.Ip "\f(CW\*(C`\-\-version\*(C'\fR" 4
|
||||
.IX Item "--version"
|
||||
Print the program version number on the standard output and exit.
|
||||
.SH "SEE ALSO"
|
||||
\fIar\fR\|(1), \fInm\fR\|(1), \fIobjdump\fR\|(1), \fIranlib\fR\|(1), \fIreadelf\fR\|(1)
|
||||
.IX Header "SEE ALSO"
|
||||
\&\fIar\fR\|(1), \fInm\fR\|(1), \fIobjdump\fR\|(1), \fIranlib\fR\|(1), \fIreadelf\fR\|(1)
|
||||
and the Info entries for \fIbinutils\fR.
|
||||
.SH "COPYRIGHT"
|
||||
.IX Header "COPYRIGHT"
|
||||
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
|
||||
.PP
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||||
Back-Cover Texts. A copy of the license is included in the
|
||||
section entitled \*(L"GNU Free Documentation License\*(R".
|
||||
|
||||
.rn }` ''
|
||||
.IX Title "STRINGS.1 1"
|
||||
.IX Name "strings - print the strings of printable characters in files."
|
||||
|
||||
.IX Header "NAME"
|
||||
|
||||
.IX Header "SYNOPSIS"
|
||||
|
||||
.IX Header "DESCRIPTION"
|
||||
|
||||
.IX Header "OPTIONS"
|
||||
|
||||
.IX Item "\f(CW-a\fR"
|
||||
|
||||
.IX Item "\f(CW--all\fR"
|
||||
|
||||
.IX Item "\f(CW-\fR"
|
||||
|
||||
.IX Item "\f(CW-f\fR"
|
||||
|
||||
.IX Item "\f(CW--print-file-name\fR"
|
||||
|
||||
.IX Item "\f(CW--help\fR"
|
||||
|
||||
.IX Item "\f(CW-\fImin-len\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-n \fImin-len\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--bytes=\fImin-len\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-o\fR"
|
||||
|
||||
.IX Item "\f(CW-t \fIradix\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--radix=\fIradix\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--target=\fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-v\fR"
|
||||
|
||||
.IX Item "\f(CW--version\fR"
|
||||
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
.IX Header "COPYRIGHT"
|
||||
|
||||
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
|
||||
|
||||
434
binutils/strip.1
434
binutils/strip.1
@ -1,12 +1,9 @@
|
||||
.rn '' }`
|
||||
''' $RCSfile$$Revision$$Date$
|
||||
'''
|
||||
''' $Log$
|
||||
''' Revision 1.6 2001/03/25 20:32:25 nickc
|
||||
''' Automate generate on man pages
|
||||
'''
|
||||
'''
|
||||
.de Sh
|
||||
.\" Automatically generated by Pod::Man version 1.02
|
||||
.\" Wed May 30 12:24:29 2001
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ======================================================================
|
||||
.de Sh \" Subsection heading
|
||||
.br
|
||||
.if t .Sp
|
||||
.ne 5
|
||||
@ -14,149 +11,105 @@
|
||||
\fB\\$1\fR
|
||||
.PP
|
||||
..
|
||||
.de Sp
|
||||
.de Sp \" Vertical space (when we can't use .PP)
|
||||
.if t .sp .5v
|
||||
.if n .sp
|
||||
..
|
||||
.de Ip
|
||||
.de Ip \" List item
|
||||
.br
|
||||
.ie \\n(.$>=3 .ne \\$3
|
||||
.el .ne 3
|
||||
.IP "\\$1" \\$2
|
||||
..
|
||||
.de Vb
|
||||
.de Vb \" Begin verbatim text
|
||||
.ft CW
|
||||
.nf
|
||||
.ne \\$1
|
||||
..
|
||||
.de Ve
|
||||
.de Ve \" End verbatim text
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
'''
|
||||
'''
|
||||
''' Set up \*(-- to give an unbreakable dash;
|
||||
''' string Tr holds user defined translation string.
|
||||
''' Bell System Logo is used as a dummy character.
|
||||
'''
|
||||
.\" Set up some character translations and predefined strings. \*(-- will
|
||||
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
||||
.\" double quote, and \*(R" will give a right double quote. | will give a
|
||||
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
|
||||
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
|
||||
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
|
||||
.tr \(*W-|\(bv\*(Tr
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.ie n \{\
|
||||
.ds -- \(*W-
|
||||
.ds PI pi
|
||||
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
.ds L" ""
|
||||
.ds R" ""
|
||||
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
|
||||
''' \*(L" and \*(R", except that they are used on ".xx" lines,
|
||||
''' such as .IP and .SH, which do another additional levels of
|
||||
''' double-quote interpretation
|
||||
.ds M" """
|
||||
.ds S" """
|
||||
.ds N" """""
|
||||
.ds T" """""
|
||||
.ds L' '
|
||||
.ds R' '
|
||||
.ds M' '
|
||||
.ds S' '
|
||||
.ds N' '
|
||||
.ds T' '
|
||||
. ds -- \(*W-
|
||||
. ds PI pi
|
||||
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
. ds L" ""
|
||||
. ds R" ""
|
||||
. ds C` `
|
||||
. ds C' '
|
||||
'br\}
|
||||
.el\{\
|
||||
.ds -- \(em\|
|
||||
.tr \*(Tr
|
||||
.ds L" ``
|
||||
.ds R" ''
|
||||
.ds M" ``
|
||||
.ds S" ''
|
||||
.ds N" ``
|
||||
.ds T" ''
|
||||
.ds L' `
|
||||
.ds R' '
|
||||
.ds M' `
|
||||
.ds S' '
|
||||
.ds N' `
|
||||
.ds T' '
|
||||
.ds PI \(*p
|
||||
. ds -- \|\(em\|
|
||||
. ds PI \(*p
|
||||
. ds L" ``
|
||||
. ds R" ''
|
||||
'br\}
|
||||
.\" If the F register is turned on, we'll generate
|
||||
.\" index entries out stderr for the following things:
|
||||
.\" TH Title
|
||||
.\" SH Header
|
||||
.\" Sh Subsection
|
||||
.\" Ip Item
|
||||
.\" X<> Xref (embedded
|
||||
.\" Of course, you have to process the output yourself
|
||||
.\" in some meaninful fashion.
|
||||
.if \nF \{
|
||||
.de IX
|
||||
.tm Index:\\$1\t\\n%\t"\\$2"
|
||||
..
|
||||
.nr % 0
|
||||
.rr F
|
||||
.\"
|
||||
.\" If the F register is turned on, we'll generate index entries on stderr
|
||||
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
|
||||
.\" index entries marked with X<> in POD. Of course, you'll have to process
|
||||
.\" the output yourself in some meaningful fashion.
|
||||
.if \nF \{\
|
||||
. de IX
|
||||
. tm Index:\\$1\t\\n%\t"\\$2"
|
||||
. .
|
||||
. nr % 0
|
||||
. rr F
|
||||
.\}
|
||||
.TH STRIP.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
|
||||
.UC
|
||||
.if n .hy 0
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.de CQ \" put $1 in typewriter font
|
||||
.ft CW
|
||||
'if n "\c
|
||||
'if t \\&\\$1\c
|
||||
'if n \\&\\$1\c
|
||||
'if n \&"
|
||||
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
|
||||
'.ft R
|
||||
..
|
||||
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
|
||||
. \" AM - accent mark definitions
|
||||
.\"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it
|
||||
.\" makes way too many mistakes in technical documents.
|
||||
.hy 0
|
||||
.\"
|
||||
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
||||
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
||||
.bd B 3
|
||||
. \" fudge factors for nroff and troff
|
||||
. \" fudge factors for nroff and troff
|
||||
.if n \{\
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
.\}
|
||||
. \" simple accents for nroff and troff
|
||||
. \" simple accents for nroff and troff
|
||||
.if n \{\
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds ? ?
|
||||
. ds ! !
|
||||
. ds /
|
||||
. ds q
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds /
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
|
||||
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
.\}
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
||||
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
||||
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
|
||||
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
|
||||
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
|
||||
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
|
||||
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
||||
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
||||
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
||||
@ -164,195 +117,150 @@
|
||||
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
||||
.ds ae a\h'-(\w'a'u*4/10)'e
|
||||
.ds Ae A\h'-(\w'A'u*4/10)'E
|
||||
.ds oe o\h'-(\w'o'u*4/10)'e
|
||||
.ds Oe O\h'-(\w'O'u*4/10)'E
|
||||
. \" corrections for vroff
|
||||
. \" corrections for vroff
|
||||
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
||||
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
.if \n(.H>23 .if \n(.V>19 \
|
||||
\{\
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds v \h'-1'\o'\(aa\(ga'
|
||||
. ds _ \h'-1'^
|
||||
. ds . \h'-1'.
|
||||
. ds 3 3
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
. ds oe oe
|
||||
. ds Oe OE
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
.\}
|
||||
.rm #[ #] #H #V #F C
|
||||
.\" ======================================================================
|
||||
.\"
|
||||
.IX Title "STRIP.1 1"
|
||||
.TH STRIP.1 1 "binutils-2.11.90" "2001-05-30" "GNU"
|
||||
.UC
|
||||
.SH "NAME"
|
||||
strip \- Discard symbols from object files.
|
||||
.SH "SYNOPSIS"
|
||||
strip [ \-F \fIbfdname\fR | --target=\fIbfdname\fR ]
|
||||
[ \-I \fIbfdname\fR | --input-target=\fIbfdname\fR ]
|
||||
[ \-O \fIbfdname\fR | --output-target=\fIbfdname\fR ]
|
||||
[ \-s | --strip-all ] [ \-S | \-g | --strip-debug ]
|
||||
[ \-K \fIsymbolname\fR | --keep-symbol=\fIsymbolname\fR ]
|
||||
[ \-N \fIsymbolname\fR | --strip-symbol=\fIsymbolname\fR ]
|
||||
[ \-x | --discard-all ] [ \-X | --discard-locals ]
|
||||
[ \-R \fIsectionname\fR | --remove-section=\fIsectionname\fR ]
|
||||
[ \-o \fIfile\fR ] [ \-p | --preserve-dates ]
|
||||
[ \-v | --verbose ] [ \-V | --version ] [ --help ]
|
||||
.IX Header "SYNOPSIS"
|
||||
strip [ \-F \fIbfdname\fR | \-\-target=\fIbfdname\fR ]
|
||||
[ \-I \fIbfdname\fR | \-\-input-target=\fIbfdname\fR ]
|
||||
[ \-O \fIbfdname\fR | \-\-output-target=\fIbfdname\fR ]
|
||||
[ \-s | \-\-strip-all ] [ \-S | \-g | \-\-strip-debug ]
|
||||
[ \-K \fIsymbolname\fR | \-\-keep-symbol=\fIsymbolname\fR ]
|
||||
[ \-N \fIsymbolname\fR | \-\-strip-symbol=\fIsymbolname\fR ]
|
||||
[ \-x | \-\-discard-all ] [ \-X | \-\-discard-locals ]
|
||||
[ \-R \fIsectionname\fR | \-\-remove-section=\fIsectionname\fR ]
|
||||
[ \-o \fIfile\fR ] [ \-p | \-\-preserve-dates ]
|
||||
[ \-v | \-\-verbose ] [ \-V | \-\-version ] [ \-\-help ]
|
||||
\fIobjfile\fR...
|
||||
.SH "DESCRIPTION"
|
||||
GNU \f(CWstrip\fR discards all symbols from object files
|
||||
\fIobjfile\fR. The list of object files may include archives.
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\s-1GNU\s0 \f(CW\*(C`strip\*(C'\fR discards all symbols from object files
|
||||
\&\fIobjfile\fR. The list of object files may include archives.
|
||||
At least one object file must be given.
|
||||
.PP
|
||||
\f(CWstrip\fR modifies the files named in its argument,
|
||||
\&\f(CW\*(C`strip\*(C'\fR modifies the files named in its argument,
|
||||
rather than writing modified copies under different names.
|
||||
.SH "OPTIONS"
|
||||
.Ip "\f(CW-F \fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW--target=\fIbfdname\fR\fR" 4
|
||||
.IX Header "OPTIONS"
|
||||
.Ip "\f(CW\*(C`\-F \f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-F bfdname"
|
||||
.Ip "\f(CW\*(C`\-\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--target=bfdname"
|
||||
Treat the original \fIobjfile\fR as a file with the object
|
||||
code format \fIbfdname\fR, and rewrite it in the same format.
|
||||
.Ip "\f(CW--help\fR" 4
|
||||
Show a summary of the options to \f(CWstrip\fR and exit.
|
||||
.Ip "\f(CW-I \fIbfdname\fR \fR" 4
|
||||
.Ip "\f(CW--input-target=\fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-help\*(C'\fR" 4
|
||||
.IX Item "--help"
|
||||
Show a summary of the options to \f(CW\*(C`strip\*(C'\fR and exit.
|
||||
.Ip "\f(CW\*(C`\-I \f(CIbfdname\f(CW \*(C'\fR" 4
|
||||
.IX Item "-I bfdname "
|
||||
.Ip "\f(CW\*(C`\-\-input\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--input-target=bfdname"
|
||||
Treat the original \fIobjfile\fR as a file with the object
|
||||
code format \fIbfdname\fR.
|
||||
.Ip "\f(CW-O \fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW--output-target=\fIbfdname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-O \f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-O bfdname"
|
||||
.Ip "\f(CW\*(C`\-\-output\-target=\f(CIbfdname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--output-target=bfdname"
|
||||
Replace \fIobjfile\fR with a file in the output format \fIbfdname\fR.
|
||||
.Ip "\f(CW-R \fIsectionname\fR\fR" 4
|
||||
.Ip "\f(CW--remove-section=\fIsectionname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-R \f(CIsectionname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-R sectionname"
|
||||
.Ip "\f(CW\*(C`\-\-remove\-section=\f(CIsectionname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--remove-section=sectionname"
|
||||
Remove any section named \fIsectionname\fR from the output file. This
|
||||
option may be given more than once. Note that using this option
|
||||
inappropriately may make the output file unusable.
|
||||
.Ip "\f(CW-s\fR" 4
|
||||
.Ip "\f(CW--strip-all\fR" 4
|
||||
.Ip "\f(CW\*(C`\-s\*(C'\fR" 4
|
||||
.IX Item "-s"
|
||||
.Ip "\f(CW\*(C`\-\-strip\-all\*(C'\fR" 4
|
||||
.IX Item "--strip-all"
|
||||
Remove all symbols.
|
||||
.Ip "\f(CW-g\fR" 4
|
||||
.Ip "\f(CW-S\fR" 4
|
||||
.Ip "\f(CW--strip-debug\fR" 4
|
||||
.Ip "\f(CW\*(C`\-g\*(C'\fR" 4
|
||||
.IX Item "-g"
|
||||
.Ip "\f(CW\*(C`\-S\*(C'\fR" 4
|
||||
.IX Item "-S"
|
||||
.Ip "\f(CW\*(C`\-\-strip\-debug\*(C'\fR" 4
|
||||
.IX Item "--strip-debug"
|
||||
Remove debugging symbols only.
|
||||
.Ip "\f(CW--strip-unneeded\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-strip\-unneeded\*(C'\fR" 4
|
||||
.IX Item "--strip-unneeded"
|
||||
Remove all symbols that are not needed for relocation processing.
|
||||
.Ip "\f(CW-K \fIsymbolname\fR\fR" 4
|
||||
.Ip "\f(CW--keep-symbol=\fIsymbolname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-K \f(CIsymbolname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-K symbolname"
|
||||
.Ip "\f(CW\*(C`\-\-keep\-symbol=\f(CIsymbolname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--keep-symbol=symbolname"
|
||||
Keep only symbol \fIsymbolname\fR from the source file. This option may
|
||||
be given more than once.
|
||||
.Ip "\f(CW-N \fIsymbolname\fR\fR" 4
|
||||
.Ip "\f(CW--strip-symbol=\fIsymbolname\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-N \f(CIsymbolname\f(CW\*(C'\fR" 4
|
||||
.IX Item "-N symbolname"
|
||||
.Ip "\f(CW\*(C`\-\-strip\-symbol=\f(CIsymbolname\f(CW\*(C'\fR" 4
|
||||
.IX Item "--strip-symbol=symbolname"
|
||||
Remove symbol \fIsymbolname\fR from the source file. This option may be
|
||||
given more than once, and may be combined with strip options other than
|
||||
\f(CW-K\fR.
|
||||
.Ip "\f(CW-o \fIfile\fR\fR" 4
|
||||
\&\f(CW\*(C`\-K\*(C'\fR.
|
||||
.Ip "\f(CW\*(C`\-o \f(CIfile\f(CW\*(C'\fR" 4
|
||||
.IX Item "-o file"
|
||||
Put the stripped output in \fIfile\fR, rather than replacing the
|
||||
existing file. When this argument is used, only one \fIobjfile\fR
|
||||
argument may be specified.
|
||||
.Ip "\f(CW-p\fR" 4
|
||||
.Ip "\f(CW--preserve-dates\fR" 4
|
||||
.Ip "\f(CW\*(C`\-p\*(C'\fR" 4
|
||||
.IX Item "-p"
|
||||
.Ip "\f(CW\*(C`\-\-preserve\-dates\*(C'\fR" 4
|
||||
.IX Item "--preserve-dates"
|
||||
Preserve the access and modification dates of the file.
|
||||
.Ip "\f(CW-x\fR" 4
|
||||
.Ip "\f(CW--discard-all\fR" 4
|
||||
.Ip "\f(CW\*(C`\-x\*(C'\fR" 4
|
||||
.IX Item "-x"
|
||||
.Ip "\f(CW\*(C`\-\-discard\-all\*(C'\fR" 4
|
||||
.IX Item "--discard-all"
|
||||
Remove non-global symbols.
|
||||
.Ip "\f(CW-X\fR" 4
|
||||
.Ip "\f(CW--discard-locals\fR" 4
|
||||
.Ip "\f(CW\*(C`\-X\*(C'\fR" 4
|
||||
.IX Item "-X"
|
||||
.Ip "\f(CW\*(C`\-\-discard\-locals\*(C'\fR" 4
|
||||
.IX Item "--discard-locals"
|
||||
Remove compiler-generated local symbols.
|
||||
(These usually start with \fBL\fR or \fB.\fR.)
|
||||
.Ip "\f(CW-V\fR" 4
|
||||
.Ip "\f(CW--version\fR" 4
|
||||
Show the version number for \f(CWstrip\fR.
|
||||
.Ip "\f(CW-v\fR" 4
|
||||
.Ip "\f(CW--verbose\fR" 4
|
||||
.Ip "\f(CW\*(C`\-V\*(C'\fR" 4
|
||||
.IX Item "-V"
|
||||
.Ip "\f(CW\*(C`\-\-version\*(C'\fR" 4
|
||||
.IX Item "--version"
|
||||
Show the version number for \f(CW\*(C`strip\*(C'\fR.
|
||||
.Ip "\f(CW\*(C`\-v\*(C'\fR" 4
|
||||
.IX Item "-v"
|
||||
.Ip "\f(CW\*(C`\-\-verbose\*(C'\fR" 4
|
||||
.IX Item "--verbose"
|
||||
Verbose output: list all object files modified. In the case of
|
||||
archives, \fBstrip \-v\fR lists all members of the archive.
|
||||
.SH "SEE ALSO"
|
||||
.IX Header "SEE ALSO"
|
||||
the Info entries for \fIbinutils\fR.
|
||||
.SH "COPYRIGHT"
|
||||
.IX Header "COPYRIGHT"
|
||||
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
|
||||
.PP
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||||
Back-Cover Texts. A copy of the license is included in the
|
||||
section entitled \*(L"GNU Free Documentation License\*(R".
|
||||
|
||||
.rn }` ''
|
||||
.IX Title "STRIP.1 1"
|
||||
.IX Name "strip - Discard symbols from object files."
|
||||
|
||||
.IX Header "NAME"
|
||||
|
||||
.IX Header "SYNOPSIS"
|
||||
|
||||
.IX Header "DESCRIPTION"
|
||||
|
||||
.IX Header "OPTIONS"
|
||||
|
||||
.IX Item "\f(CW-F \fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--target=\fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--help\fR"
|
||||
|
||||
.IX Item "\f(CW-I \fIbfdname\fR \fR"
|
||||
|
||||
.IX Item "\f(CW--input-target=\fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-O \fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--output-target=\fIbfdname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-R \fIsectionname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--remove-section=\fIsectionname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-s\fR"
|
||||
|
||||
.IX Item "\f(CW--strip-all\fR"
|
||||
|
||||
.IX Item "\f(CW-g\fR"
|
||||
|
||||
.IX Item "\f(CW-S\fR"
|
||||
|
||||
.IX Item "\f(CW--strip-debug\fR"
|
||||
|
||||
.IX Item "\f(CW--strip-unneeded\fR"
|
||||
|
||||
.IX Item "\f(CW-K \fIsymbolname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--keep-symbol=\fIsymbolname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-N \fIsymbolname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--strip-symbol=\fIsymbolname\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-o \fIfile\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-p\fR"
|
||||
|
||||
.IX Item "\f(CW--preserve-dates\fR"
|
||||
|
||||
.IX Item "\f(CW-x\fR"
|
||||
|
||||
.IX Item "\f(CW--discard-all\fR"
|
||||
|
||||
.IX Item "\f(CW-X\fR"
|
||||
|
||||
.IX Item "\f(CW--discard-locals\fR"
|
||||
|
||||
.IX Item "\f(CW-V\fR"
|
||||
|
||||
.IX Item "\f(CW--version\fR"
|
||||
|
||||
.IX Item "\f(CW-v\fR"
|
||||
|
||||
.IX Item "\f(CW--verbose\fR"
|
||||
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
.IX Header "COPYRIGHT"
|
||||
|
||||
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
|
||||
|
||||
@ -1,12 +1,9 @@
|
||||
.rn '' }`
|
||||
''' $RCSfile$$Revision$$Date$
|
||||
'''
|
||||
''' $Log$
|
||||
''' Revision 1.1 2001/03/25 20:32:25 nickc
|
||||
''' Automate generate on man pages
|
||||
'''
|
||||
'''
|
||||
.de Sh
|
||||
.\" Automatically generated by Pod::Man version 1.02
|
||||
.\" Wed May 30 12:24:30 2001
|
||||
.\"
|
||||
.\" Standard preamble:
|
||||
.\" ======================================================================
|
||||
.de Sh \" Subsection heading
|
||||
.br
|
||||
.if t .Sp
|
||||
.ne 5
|
||||
@ -14,149 +11,105 @@
|
||||
\fB\\$1\fR
|
||||
.PP
|
||||
..
|
||||
.de Sp
|
||||
.de Sp \" Vertical space (when we can't use .PP)
|
||||
.if t .sp .5v
|
||||
.if n .sp
|
||||
..
|
||||
.de Ip
|
||||
.de Ip \" List item
|
||||
.br
|
||||
.ie \\n(.$>=3 .ne \\$3
|
||||
.el .ne 3
|
||||
.IP "\\$1" \\$2
|
||||
..
|
||||
.de Vb
|
||||
.de Vb \" Begin verbatim text
|
||||
.ft CW
|
||||
.nf
|
||||
.ne \\$1
|
||||
..
|
||||
.de Ve
|
||||
.de Ve \" End verbatim text
|
||||
.ft R
|
||||
|
||||
.fi
|
||||
..
|
||||
'''
|
||||
'''
|
||||
''' Set up \*(-- to give an unbreakable dash;
|
||||
''' string Tr holds user defined translation string.
|
||||
''' Bell System Logo is used as a dummy character.
|
||||
'''
|
||||
.\" Set up some character translations and predefined strings. \*(-- will
|
||||
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
||||
.\" double quote, and \*(R" will give a right double quote. | will give a
|
||||
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
|
||||
.\" to do unbreakable dashes and therefore won't be available. \*(C` and
|
||||
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
|
||||
.tr \(*W-|\(bv\*(Tr
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.ie n \{\
|
||||
.ds -- \(*W-
|
||||
.ds PI pi
|
||||
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
.ds L" ""
|
||||
.ds R" ""
|
||||
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
|
||||
''' \*(L" and \*(R", except that they are used on ".xx" lines,
|
||||
''' such as .IP and .SH, which do another additional levels of
|
||||
''' double-quote interpretation
|
||||
.ds M" """
|
||||
.ds S" """
|
||||
.ds N" """""
|
||||
.ds T" """""
|
||||
.ds L' '
|
||||
.ds R' '
|
||||
.ds M' '
|
||||
.ds S' '
|
||||
.ds N' '
|
||||
.ds T' '
|
||||
. ds -- \(*W-
|
||||
. ds PI pi
|
||||
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
||||
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
||||
. ds L" ""
|
||||
. ds R" ""
|
||||
. ds C` `
|
||||
. ds C' '
|
||||
'br\}
|
||||
.el\{\
|
||||
.ds -- \(em\|
|
||||
.tr \*(Tr
|
||||
.ds L" ``
|
||||
.ds R" ''
|
||||
.ds M" ``
|
||||
.ds S" ''
|
||||
.ds N" ``
|
||||
.ds T" ''
|
||||
.ds L' `
|
||||
.ds R' '
|
||||
.ds M' `
|
||||
.ds S' '
|
||||
.ds N' `
|
||||
.ds T' '
|
||||
.ds PI \(*p
|
||||
. ds -- \|\(em\|
|
||||
. ds PI \(*p
|
||||
. ds L" ``
|
||||
. ds R" ''
|
||||
'br\}
|
||||
.\" If the F register is turned on, we'll generate
|
||||
.\" index entries out stderr for the following things:
|
||||
.\" TH Title
|
||||
.\" SH Header
|
||||
.\" Sh Subsection
|
||||
.\" Ip Item
|
||||
.\" X<> Xref (embedded
|
||||
.\" Of course, you have to process the output yourself
|
||||
.\" in some meaninful fashion.
|
||||
.if \nF \{
|
||||
.de IX
|
||||
.tm Index:\\$1\t\\n%\t"\\$2"
|
||||
..
|
||||
.nr % 0
|
||||
.rr F
|
||||
.\"
|
||||
.\" If the F register is turned on, we'll generate index entries on stderr
|
||||
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
|
||||
.\" index entries marked with X<> in POD. Of course, you'll have to process
|
||||
.\" the output yourself in some meaningful fashion.
|
||||
.if \nF \{\
|
||||
. de IX
|
||||
. tm Index:\\$1\t\\n%\t"\\$2"
|
||||
. .
|
||||
. nr % 0
|
||||
. rr F
|
||||
.\}
|
||||
.TH WINDRES.1 1 "binutils-2.11.90" "23/Mar/101" "GNU"
|
||||
.UC
|
||||
.if n .hy 0
|
||||
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
||||
.de CQ \" put $1 in typewriter font
|
||||
.ft CW
|
||||
'if n "\c
|
||||
'if t \\&\\$1\c
|
||||
'if n \\&\\$1\c
|
||||
'if n \&"
|
||||
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
|
||||
'.ft R
|
||||
..
|
||||
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
|
||||
. \" AM - accent mark definitions
|
||||
.\"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it
|
||||
.\" makes way too many mistakes in technical documents.
|
||||
.hy 0
|
||||
.\"
|
||||
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
||||
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
||||
.bd B 3
|
||||
. \" fudge factors for nroff and troff
|
||||
. \" fudge factors for nroff and troff
|
||||
.if n \{\
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
. ds #H 0
|
||||
. ds #V .8m
|
||||
. ds #F .3m
|
||||
. ds #[ \f1
|
||||
. ds #] \fP
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
||||
. ds #V .6m
|
||||
. ds #F 0
|
||||
. ds #[ \&
|
||||
. ds #] \&
|
||||
.\}
|
||||
. \" simple accents for nroff and troff
|
||||
. \" simple accents for nroff and troff
|
||||
.if n \{\
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds ? ?
|
||||
. ds ! !
|
||||
. ds /
|
||||
. ds q
|
||||
. ds ' \&
|
||||
. ds ` \&
|
||||
. ds ^ \&
|
||||
. ds , \&
|
||||
. ds ~ ~
|
||||
. ds /
|
||||
.\}
|
||||
.if t \{\
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
|
||||
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
|
||||
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
||||
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
||||
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
||||
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
||||
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
||||
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
||||
.\}
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
. \" troff and (daisy-wheel) nroff accents
|
||||
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
||||
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
||||
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
|
||||
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
|
||||
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
|
||||
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
|
||||
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
||||
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
||||
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
||||
@ -164,214 +117,175 @@
|
||||
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
||||
.ds ae a\h'-(\w'a'u*4/10)'e
|
||||
.ds Ae A\h'-(\w'A'u*4/10)'E
|
||||
.ds oe o\h'-(\w'o'u*4/10)'e
|
||||
.ds Oe O\h'-(\w'O'u*4/10)'E
|
||||
. \" corrections for vroff
|
||||
. \" corrections for vroff
|
||||
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
||||
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
. \" for low resolution devices (crt and lpr)
|
||||
.if \n(.H>23 .if \n(.V>19 \
|
||||
\{\
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds v \h'-1'\o'\(aa\(ga'
|
||||
. ds _ \h'-1'^
|
||||
. ds . \h'-1'.
|
||||
. ds 3 3
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
. ds oe oe
|
||||
. ds Oe OE
|
||||
. ds : e
|
||||
. ds 8 ss
|
||||
. ds o a
|
||||
. ds d- d\h'-1'\(ga
|
||||
. ds D- D\h'-1'\(hy
|
||||
. ds th \o'bp'
|
||||
. ds Th \o'LP'
|
||||
. ds ae ae
|
||||
. ds Ae AE
|
||||
.\}
|
||||
.rm #[ #] #H #V #F C
|
||||
.\" ======================================================================
|
||||
.\"
|
||||
.IX Title "WINDRES.1 1"
|
||||
.TH WINDRES.1 1 "binutils-2.11.90" "2001-05-30" "GNU"
|
||||
.UC
|
||||
.SH "NAME"
|
||||
windres \- manipulate Windows resources.
|
||||
.SH "SYNOPSIS"
|
||||
.IX Header "SYNOPSIS"
|
||||
windres [options] [input-file] [output-file]
|
||||
.SH "DESCRIPTION"
|
||||
\f(CWwindres\fR reads resources from an input file and copies them into
|
||||
.IX Header "DESCRIPTION"
|
||||
\&\f(CW\*(C`windres\*(C'\fR reads resources from an input file and copies them into
|
||||
an output file. Either file may be in one of three formats:
|
||||
.Ip "\f(CWrc\fR" 4
|
||||
.Ip "\f(CW\*(C`rc\*(C'\fR" 4
|
||||
.IX Item "rc"
|
||||
A text format read by the Resource Compiler.
|
||||
.Ip "\f(CWres\fR" 4
|
||||
.Ip "\f(CW\*(C`res\*(C'\fR" 4
|
||||
.IX Item "res"
|
||||
A binary format generated by the Resource Compiler.
|
||||
.Ip "\f(CWcoff\fR" 4
|
||||
.Ip "\f(CW\*(C`coff\*(C'\fR" 4
|
||||
.IX Item "coff"
|
||||
A \s-1COFF\s0 object or executable.
|
||||
.PP
|
||||
The exact description of these different formats is available in
|
||||
documentation from Microsoft.
|
||||
.PP
|
||||
When \f(CWwindres\fR converts from the \f(CWrc\fR format to the \f(CWres\fR
|
||||
When \f(CW\*(C`windres\*(C'\fR converts from the \f(CW\*(C`rc\*(C'\fR format to the \f(CW\*(C`res\*(C'\fR
|
||||
format, it is acting like the Windows Resource Compiler. When
|
||||
\f(CWwindres\fR converts from the \f(CWres\fR format to the \f(CWcoff\fR
|
||||
format, it is acting like the Windows \f(CWCVTRES\fR program.
|
||||
\&\f(CW\*(C`windres\*(C'\fR converts from the \f(CW\*(C`res\*(C'\fR format to the \f(CW\*(C`coff\*(C'\fR
|
||||
format, it is acting like the Windows \f(CW\*(C`CVTRES\*(C'\fR program.
|
||||
.PP
|
||||
When \f(CWwindres\fR generates an \f(CWrc\fR file, the output is similar
|
||||
When \f(CW\*(C`windres\*(C'\fR generates an \f(CW\*(C`rc\*(C'\fR file, the output is similar
|
||||
but not identical to the format expected for the input. When an input
|
||||
\f(CWrc\fR file refers to an external filename, an output \f(CWrc\fR file
|
||||
\&\f(CW\*(C`rc\*(C'\fR file refers to an external filename, an output \f(CW\*(C`rc\*(C'\fR file
|
||||
will instead include the file contents.
|
||||
.PP
|
||||
If the input or output format is not specified, \f(CWwindres\fR will
|
||||
If the input or output format is not specified, \f(CW\*(C`windres\*(C'\fR will
|
||||
guess based on the file name, or, for the input file, the file contents.
|
||||
A file with an extension of \fI.rc\fR will be treated as an \f(CWrc\fR
|
||||
A file with an extension of \fI.rc\fR will be treated as an \f(CW\*(C`rc\*(C'\fR
|
||||
file, a file with an extension of \fI.res\fR will be treated as a
|
||||
\f(CWres\fR file, and a file with an extension of \fI.o\fR or
|
||||
\&\fI.exe\fR will be treated as a \f(CWcoff\fR file.
|
||||
\&\f(CW\*(C`res\*(C'\fR file, and a file with an extension of \fI.o\fR or
|
||||
\&\fI.exe\fR will be treated as a \f(CW\*(C`coff\*(C'\fR file.
|
||||
.PP
|
||||
If no output file is specified, \f(CWwindres\fR will print the resources
|
||||
in \f(CWrc\fR format to standard output.
|
||||
If no output file is specified, \f(CW\*(C`windres\*(C'\fR will print the resources
|
||||
in \f(CW\*(C`rc\*(C'\fR format to standard output.
|
||||
.PP
|
||||
The normal use is for you to write an \f(CWrc\fR file, use \f(CWwindres\fR
|
||||
The normal use is for you to write an \f(CW\*(C`rc\*(C'\fR file, use \f(CW\*(C`windres\*(C'\fR
|
||||
to convert it to a \s-1COFF\s0 object file, and then link the \s-1COFF\s0 file into
|
||||
your application. This will make the resources described in the
|
||||
\f(CWrc\fR file available to Windows.
|
||||
\&\f(CW\*(C`rc\*(C'\fR file available to Windows.
|
||||
.SH "OPTIONS"
|
||||
.Ip "\f(CW-i \fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW--input \fIfilename\fR\fR" 4
|
||||
.IX Header "OPTIONS"
|
||||
.Ip "\f(CW\*(C`\-i \f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "-i filename"
|
||||
.Ip "\f(CW\*(C`\-\-input \f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "--input filename"
|
||||
The name of the input file. If this option is not used, then
|
||||
\f(CWwindres\fR will use the first non-option argument as the input file
|
||||
name. If there are no non-option arguments, then \f(CWwindres\fR will
|
||||
read from standard input. \f(CWwindres\fR can not read a \s-1COFF\s0 file from
|
||||
\&\f(CW\*(C`windres\*(C'\fR will use the first non-option argument as the input file
|
||||
name. If there are no non-option arguments, then \f(CW\*(C`windres\*(C'\fR will
|
||||
read from standard input. \f(CW\*(C`windres\*(C'\fR can not read a \s-1COFF\s0 file from
|
||||
standard input.
|
||||
.Ip "\f(CW-o \fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW--output \fIfilename\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-o \f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "-o filename"
|
||||
.Ip "\f(CW\*(C`\-\-output \f(CIfilename\f(CW\*(C'\fR" 4
|
||||
.IX Item "--output filename"
|
||||
The name of the output file. If this option is not used, then
|
||||
\f(CWwindres\fR will use the first non-option argument, after any used
|
||||
\&\f(CW\*(C`windres\*(C'\fR will use the first non-option argument, after any used
|
||||
for the input file name, as the output file name. If there is no
|
||||
non-option argument, then \f(CWwindres\fR will write to standard output.
|
||||
\f(CWwindres\fR can not write a \s-1COFF\s0 file to standard output.
|
||||
.Ip "\f(CW-I \fIformat\fR\fR" 4
|
||||
.Ip "\f(CW--input-format \fIformat\fR\fR" 4
|
||||
non-option argument, then \f(CW\*(C`windres\*(C'\fR will write to standard output.
|
||||
\&\f(CW\*(C`windres\*(C'\fR can not write a \s-1COFF\s0 file to standard output.
|
||||
.Ip "\f(CW\*(C`\-I \f(CIformat\f(CW\*(C'\fR" 4
|
||||
.IX Item "-I format"
|
||||
.Ip "\f(CW\*(C`\-\-input\-format \f(CIformat\f(CW\*(C'\fR" 4
|
||||
.IX Item "--input-format format"
|
||||
The input format to read. \fIformat\fR may be \fBres\fR, \fBrc\fR, or
|
||||
\fBcoff\fR. If no input format is specified, \f(CWwindres\fR will
|
||||
\&\fBcoff\fR. If no input format is specified, \f(CW\*(C`windres\*(C'\fR will
|
||||
guess, as described above.
|
||||
.Ip "\f(CW-O \fIformat\fR\fR" 4
|
||||
.Ip "\f(CW--output-format \fIformat\fR\fR" 4
|
||||
.Ip "\f(CW\*(C`\-O \f(CIformat\f(CW\*(C'\fR" 4
|
||||
.IX Item "-O format"
|
||||
.Ip "\f(CW\*(C`\-\-output\-format \f(CIformat\f(CW\*(C'\fR" 4
|
||||
.IX Item "--output-format format"
|
||||
The output format to generate. \fIformat\fR may be \fBres\fR,
|
||||
\fBrc\fR, or \fBcoff\fR. If no output format is specified,
|
||||
\f(CWwindres\fR will guess, as described above.
|
||||
.Ip "\f(CW-F \fItarget\fR\fR" 4
|
||||
.Ip "\f(CW--target \fItarget\fR\fR" 4
|
||||
\&\fBrc\fR, or \fBcoff\fR. If no output format is specified,
|
||||
\&\f(CW\*(C`windres\*(C'\fR will guess, as described above.
|
||||
.Ip "\f(CW\*(C`\-F \f(CItarget\f(CW\*(C'\fR" 4
|
||||
.IX Item "-F target"
|
||||
.Ip "\f(CW\*(C`\-\-target \f(CItarget\f(CW\*(C'\fR" 4
|
||||
.IX Item "--target target"
|
||||
Specify the \s-1BFD\s0 format to use for a \s-1COFF\s0 file as input or output. This
|
||||
is a \s-1BFD\s0 target name; you can use the \f(CW--help\fR option to see a list
|
||||
of supported targets. Normally \f(CWwindres\fR will use the default
|
||||
format, which is the first one listed by the \f(CW--help\fR option.
|
||||
\f(CW@ref\fR{Target Selection}.
|
||||
.Ip "\f(CW--preprocessor \fIprogram\fR\fR" 4
|
||||
When \f(CWwindres\fR reads an \f(CWrc\fR file, it runs it through the C
|
||||
is a \s-1BFD\s0 target name; you can use the \f(CW\*(C`\-\-help\*(C'\fR option to see a list
|
||||
of supported targets. Normally \f(CW\*(C`windres\*(C'\fR will use the default
|
||||
format, which is the first one listed by the \f(CW\*(C`\-\-help\*(C'\fR option.
|
||||
\&\f(CW@ref\fR{Target Selection}.
|
||||
.Ip "\f(CW\*(C`\-\-preprocessor \f(CIprogram\f(CW\*(C'\fR" 4
|
||||
.IX Item "--preprocessor program"
|
||||
When \f(CW\*(C`windres\*(C'\fR reads an \f(CW\*(C`rc\*(C'\fR file, it runs it through the C
|
||||
preprocessor first. This option may be used to specify the preprocessor
|
||||
to use, including any leading arguments. The default preprocessor
|
||||
argument is \f(CWgcc -E -xc-header -DRC_INVOKED\fR.
|
||||
.Ip "\f(CW--include-dir \fIdirectory\fR\fR" 4
|
||||
Specify an include directory to use when reading an \f(CWrc\fR file.
|
||||
\f(CWwindres\fR will pass this to the preprocessor as an \f(CW-I\fR
|
||||
option. \f(CWwindres\fR will also search this directory when looking for
|
||||
files named in the \f(CWrc\fR file.
|
||||
.Ip "\f(CW-D \fItarget\fR\fR" 4
|
||||
.Ip "\f(CW--define \fIsym\fR[=\fIval\fR]\fR" 4
|
||||
Specify a \f(CW-D\fR option to pass to the preprocessor when reading an
|
||||
\f(CWrc\fR file.
|
||||
.Ip "\f(CW-v\fR" 4
|
||||
argument is \f(CW\*(C`gcc \-E \-xc\-header \-DRC_INVOKED\*(C'\fR.
|
||||
.Ip "\f(CW\*(C`\-\-include\-dir \f(CIdirectory\f(CW\*(C'\fR" 4
|
||||
.IX Item "--include-dir directory"
|
||||
Specify an include directory to use when reading an \f(CW\*(C`rc\*(C'\fR file.
|
||||
\&\f(CW\*(C`windres\*(C'\fR will pass this to the preprocessor as an \f(CW\*(C`\-I\*(C'\fR
|
||||
option. \f(CW\*(C`windres\*(C'\fR will also search this directory when looking for
|
||||
files named in the \f(CW\*(C`rc\*(C'\fR file.
|
||||
.Ip "\f(CW\*(C`\-D \f(CItarget\f(CW\*(C'\fR" 4
|
||||
.IX Item "-D target"
|
||||
.Ip "\f(CW\*(C`\-\-define \f(CIsym\f(CW[=\f(CIval\f(CW]\*(C'\fR" 4
|
||||
.IX Item "--define sym[=val]"
|
||||
Specify a \f(CW\*(C`\-D\*(C'\fR option to pass to the preprocessor when reading an
|
||||
\&\f(CW\*(C`rc\*(C'\fR file.
|
||||
.Ip "\f(CW\*(C`\-v\*(C'\fR" 4
|
||||
.IX Item "-v"
|
||||
Enable verbose mode. This tells you what the preprocessor is if you
|
||||
didn't specify one.
|
||||
.Ip "\f(CW--language \fIval\fR\fR" 4
|
||||
Specify the default language to use when reading an \f(CWrc\fR file.
|
||||
\fIval\fR should be a hexadecimal language code. The low eight bits are
|
||||
.Ip "\f(CW\*(C`\-\-language \f(CIval\f(CW\*(C'\fR" 4
|
||||
.IX Item "--language val"
|
||||
Specify the default language to use when reading an \f(CW\*(C`rc\*(C'\fR file.
|
||||
\&\fIval\fR should be a hexadecimal language code. The low eight bits are
|
||||
the language, and the high eight bits are the sublanguage.
|
||||
.Ip "\f(CW--use-temp-file\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-use\-temp\-file\*(C'\fR" 4
|
||||
.IX Item "--use-temp-file"
|
||||
Use a temporary file to instead of using popen to read the output of
|
||||
the preprocessor. Use this option if the popen implementation is buggy
|
||||
on the host (eg., certain non-English language versions of Windows 95 and
|
||||
Windows 98 are known to have buggy popen where the output will instead
|
||||
go the console).
|
||||
.Ip "\f(CW--no-use-temp-file\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-no\-use\-temp\-file\*(C'\fR" 4
|
||||
.IX Item "--no-use-temp-file"
|
||||
Use popen, not a temporary file, to read the output of the preprocessor.
|
||||
This is the default behaviour.
|
||||
.Ip "\f(CW--help\fR" 4
|
||||
.Ip "\f(CW\*(C`\-\-help\*(C'\fR" 4
|
||||
.IX Item "--help"
|
||||
Prints a usage summary.
|
||||
.Ip "\f(CW--version\fR" 4
|
||||
Prints the version number for \f(CWwindres\fR.
|
||||
.Ip "\f(CW--yydebug\fR" 4
|
||||
If \f(CWwindres\fR is compiled with \f(CWYYDEBUG\fR defined as \f(CW1\fR,
|
||||
.Ip "\f(CW\*(C`\-\-version\*(C'\fR" 4
|
||||
.IX Item "--version"
|
||||
Prints the version number for \f(CW\*(C`windres\*(C'\fR.
|
||||
.Ip "\f(CW\*(C`\-\-yydebug\*(C'\fR" 4
|
||||
.IX Item "--yydebug"
|
||||
If \f(CW\*(C`windres\*(C'\fR is compiled with \f(CW\*(C`YYDEBUG\*(C'\fR defined as \f(CW\*(C`1\*(C'\fR,
|
||||
this will turn on parser debugging.
|
||||
.SH "SEE ALSO"
|
||||
.IX Header "SEE ALSO"
|
||||
the Info entries for \fIbinutils\fR.
|
||||
.SH "COPYRIGHT"
|
||||
.IX Header "COPYRIGHT"
|
||||
Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001 Free Software Foundation, Inc.
|
||||
.PP
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1
|
||||
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, with no Front-Cover Texts, and with no
|
||||
Back-Cover Texts. A copy of the license is included in the
|
||||
section entitled \*(L"GNU Free Documentation License\*(R".
|
||||
|
||||
.rn }` ''
|
||||
.IX Title "WINDRES.1 1"
|
||||
.IX Name "windres - manipulate Windows resources."
|
||||
|
||||
.IX Header "NAME"
|
||||
|
||||
.IX Header "SYNOPSIS"
|
||||
|
||||
.IX Header "DESCRIPTION"
|
||||
|
||||
.IX Item "\f(CWrc\fR"
|
||||
|
||||
.IX Item "\f(CWres\fR"
|
||||
|
||||
.IX Item "\f(CWcoff\fR"
|
||||
|
||||
.IX Header "OPTIONS"
|
||||
|
||||
.IX Item "\f(CW-i \fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--input \fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-o \fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--output \fIfilename\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-I \fIformat\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--input-format \fIformat\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-O \fIformat\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--output-format \fIformat\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-F \fItarget\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--target \fItarget\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--preprocessor \fIprogram\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--include-dir \fIdirectory\fR\fR"
|
||||
|
||||
.IX Item "\f(CW-D \fItarget\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--define \fIsym\fR[=\fIval\fR]\fR"
|
||||
|
||||
.IX Item "\f(CW-v\fR"
|
||||
|
||||
.IX Item "\f(CW--language \fIval\fR\fR"
|
||||
|
||||
.IX Item "\f(CW--use-temp-file\fR"
|
||||
|
||||
.IX Item "\f(CW--no-use-temp-file\fR"
|
||||
|
||||
.IX Item "\f(CW--help\fR"
|
||||
|
||||
.IX Item "\f(CW--version\fR"
|
||||
|
||||
.IX Item "\f(CW--yydebug\fR"
|
||||
|
||||
.IX Header "SEE ALSO"
|
||||
|
||||
.IX Header "COPYRIGHT"
|
||||
|
||||
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".
|
||||
|
||||
Loading…
Reference in New Issue
Block a user