| Line 8... |
Line 8... |
@include bfdver.texi
|
@include bfdver.texi
|
@c man end
|
@c man end
|
|
|
@copying
|
@copying
|
@c man begin COPYRIGHT
|
@c man begin COPYRIGHT
|
Copyright @copyright{} 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
|
Copyright @copyright{} 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998,
|
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011
|
1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
|
|
2010, 2011, 2012
|
Free Software Foundation, Inc.
|
Free Software Foundation, Inc.
|
|
|
Permission is granted to copy, distribute and/or modify this document
|
Permission is granted to copy, distribute and/or modify this document
|
under the terms of the GNU Free Documentation License, Version 1.3
|
under the terms of the GNU Free Documentation License, Version 1.3
|
or any later version published by the Free Software Foundation;
|
or any later version published by the Free Software Foundation;
|
| Line 416... |
Line 417... |
issued unless you specify in advance that you expect to create it, by
|
issued unless you specify in advance that you expect to create it, by
|
using this modifier.
|
using this modifier.
|
|
|
@item D
|
@item D
|
@cindex deterministic archives
|
@cindex deterministic archives
|
|
@kindex --enable-deterministic-archives
|
Operate in @emph{deterministic} mode. When adding files and the archive
|
Operate in @emph{deterministic} mode. When adding files and the archive
|
index use zero for UIDs, GIDs, timestamps, and use consistent file modes
|
index use zero for UIDs, GIDs, timestamps, and use consistent file modes
|
for all files. When this option is used, if @command{ar} is used with
|
for all files. When this option is used, if @command{ar} is used with
|
identical options and identical input files, multiple runs will create
|
identical options and identical input files, multiple runs will create
|
identical output files regardless of the input files' owners, groups,
|
identical output files regardless of the input files' owners, groups,
|
file modes, or modification times.
|
file modes, or modification times.
|
|
|
|
If @file{binutils} was configured with
|
|
@option{--enable-deterministic-archives}, then this mode is on by default.
|
|
It can be disabled with the @samp{U} modifier, below.
|
|
|
@item f
|
@item f
|
Truncate names in the archive. @sc{gnu} @command{ar} will normally permit file
|
Truncate names in the archive. @sc{gnu} @command{ar} will normally permit file
|
names of any length. This will cause it to create archives which are
|
names of any length. This will cause it to create archives which are
|
not compatible with the native @command{ar} program on some systems. If
|
not compatible with the native @command{ar} program on some systems. If
|
this is a concern, the @samp{f} modifier may be used to truncate file
|
this is a concern, the @samp{f} modifier may be used to truncate file
|
| Line 491... |
Line 497... |
names, use this modifier. The @samp{u} modifier is allowed only for the
|
names, use this modifier. The @samp{u} modifier is allowed only for the
|
operation @samp{r} (replace). In particular, the combination @samp{qu} is
|
operation @samp{r} (replace). In particular, the combination @samp{qu} is
|
not allowed, since checking the timestamps would lose any speed
|
not allowed, since checking the timestamps would lose any speed
|
advantage from the operation @samp{q}.
|
advantage from the operation @samp{q}.
|
|
|
|
@item U
|
|
@cindex deterministic archives
|
|
@kindex --enable-deterministic-archives
|
|
Do @emph{not} operate in @emph{deterministic} mode. This is the inverse
|
|
of the @samp{D} modifier, above: added files and the archive index will
|
|
get their actual UID, GID, timestamp, and file mode values.
|
|
|
|
This is the default unless @file{binutils} was configured with
|
|
@option{--enable-deterministic-archives}.
|
|
|
@item v
|
@item v
|
This modifier requests the @emph{verbose} version of an operation. Many
|
This modifier requests the @emph{verbose} version of an operation. Many
|
operations display additional information, such as filenames processed,
|
operations display additional information, such as filenames processed,
|
when the modifier @samp{v} is appended.
|
when the modifier @samp{v} is appended.
|
|
|
| Line 2347... |
Line 2363... |
|
|
@c man title ranlib generate index to archive.
|
@c man title ranlib generate index to archive.
|
|
|
@smallexample
|
@smallexample
|
@c man begin SYNOPSIS ranlib
|
@c man begin SYNOPSIS ranlib
|
ranlib [@option{-vVt}] @var{archive}
|
ranlib [@option{--plugin} @var{name}] [@option{-DhHvVt}] @var{archive}
|
@c man end
|
@c man end
|
@end smallexample
|
@end smallexample
|
|
|
@c man begin DESCRIPTION ranlib
|
@c man begin DESCRIPTION ranlib
|
|
|
| Line 2372... |
Line 2388... |
@c man end
|
@c man end
|
|
|
@c man begin OPTIONS ranlib
|
@c man begin OPTIONS ranlib
|
|
|
@table @env
|
@table @env
|
|
@item -h
|
|
@itemx -H
|
|
@itemx --help
|
|
Show usage information for @command{ranlib}.
|
|
|
@item -v
|
@item -v
|
@itemx -V
|
@itemx -V
|
@itemx --version
|
@itemx --version
|
Show the version number of @command{ranlib}.
|
Show the version number of @command{ranlib}.
|
|
|
|
@item -D
|
|
@cindex deterministic archives
|
|
@kindex --enable-deterministic-archives
|
|
Operate in @emph{deterministic} mode. The symbol map archive member's
|
|
header will show zero for the UID, GID, and timestamp. When this
|
|
option is used, multiple runs will produce identical output files.
|
|
|
|
This is the default unless @file{binutils} was configured with
|
|
@option{--enable-deterministic-archives}.
|
|
|
@item -t
|
@item -t
|
Update the timestamp of the symbol map of an archive.
|
Update the timestamp of the symbol map of an archive.
|
|
|
|
@item -U
|
|
@cindex deterministic archives
|
|
@kindex --enable-deterministic-archives
|
|
Do @emph{not} operate in @emph{deterministic} mode. This is the
|
|
inverse of the @samp{-D} option, above: the archive index will get
|
|
actual UID, GID, timestamp, and file mode values.
|
|
|
|
This is the default unless @file{binutils} was configured with
|
|
@option{--enable-deterministic-archives}.
|
@end table
|
@end table
|
|
|
@c man end
|
@c man end
|
|
|
@ignore
|
@ignore
|
| Line 2823... |
Line 2864... |
|
|
@c man title cxxfilt Demangle C++ and Java symbols.
|
@c man title cxxfilt Demangle C++ and Java symbols.
|
|
|
@smallexample
|
@smallexample
|
@c man begin SYNOPSIS cxxfilt
|
@c man begin SYNOPSIS cxxfilt
|
c++filt [@option{-_}|@option{--strip-underscores}]
|
c++filt [@option{-_}|@option{--strip-underscore}]
|
[@option{-n}|@option{--no-strip-underscores}]
|
[@option{-n}|@option{--no-strip-underscore}]
|
[@option{-p}|@option{--no-params}]
|
[@option{-p}|@option{--no-params}]
|
[@option{-t}|@option{--types}]
|
[@option{-t}|@option{--types}]
|
[@option{-i}|@option{--no-verbose}]
|
[@option{-i}|@option{--no-verbose}]
|
[@option{-s} @var{format}|@option{--format=}@var{format}]
|
[@option{-s} @var{format}|@option{--format=}@var{format}]
|
[@option{--help}] [@option{--version}] [@var{symbol}@dots{}]
|
[@option{--help}] [@option{--version}] [@var{symbol}@dots{}]
|
| Line 2904... |
Line 2945... |
|
|
@c man begin OPTIONS cxxfilt
|
@c man begin OPTIONS cxxfilt
|
|
|
@table @env
|
@table @env
|
@item -_
|
@item -_
|
@itemx --strip-underscores
|
@itemx --strip-underscore
|
On some systems, both the C and C++ compilers put an underscore in front
|
On some systems, both the C and C++ compilers put an underscore in front
|
of every name. For example, the C name @code{foo} gets the low-level
|
of every name. For example, the C name @code{foo} gets the low-level
|
name @code{_foo}. This option removes the initial underscore. Whether
|
name @code{_foo}. This option removes the initial underscore. Whether
|
@command{c++filt} removes the underscore by default is target dependent.
|
@command{c++filt} removes the underscore by default is target dependent.
|
|
|
@item -n
|
@item -n
|
@itemx --no-strip-underscores
|
@itemx --no-strip-underscore
|
Do not remove the initial underscore.
|
Do not remove the initial underscore.
|
|
|
@item -p
|
@item -p
|
@itemx --no-params
|
@itemx --no-params
|
When demangling the name of a function, do not display the types of
|
When demangling the name of a function, do not display the types of
|
| Line 3944... |
Line 3985... |
@item @code{NAME} @var{name} @code{[ ,} @var{base} @code{]}
|
@item @code{NAME} @var{name} @code{[ ,} @var{base} @code{]}
|
The result is going to be named @var{name}@code{.exe}.
|
The result is going to be named @var{name}@code{.exe}.
|
|
|
@item @code{LIBRARY} @var{name} @code{[ ,} @var{base} @code{]}
|
@item @code{LIBRARY} @var{name} @code{[ ,} @var{base} @code{]}
|
The result is going to be named @var{name}@code{.dll}.
|
The result is going to be named @var{name}@code{.dll}.
|
|
Note: If you want to use LIBRARY as name then you need to quote. Otherwise
|
|
this will fail due a necessary hack for libtool (see PR binutils/13710 for more
|
|
details).
|
|
|
@item @code{EXPORTS ( ( (} @var{name1} @code{[ = } @var{name2} @code{] ) | ( } @var{name1} @code{=} @var{module-name} @code{.} @var{external-name} @code{) ) [ == } @var{its_name} @code{]}
|
@item @code{EXPORTS ( ( (} @var{name1} @code{[ = } @var{name2} @code{] ) | ( } @var{name1} @code{=} @var{module-name} @code{.} @var{external-name} @code{) ) [ == } @var{its_name} @code{]}
|
@item @code{[} @var{integer} @code{] [ NONAME ] [ CONSTANT ] [ DATA ] [ PRIVATE ] ) *}
|
@item @code{[} @var{integer} @code{] [ NONAME ] [ CONSTANT ] [ DATA ] [ PRIVATE ] ) *}
|
Declares @var{name1} as an exported symbol from the DLL, with optional
|
Declares @var{name1} as an exported symbol from the DLL, with optional
|
ordinal number @var{integer}, or declares @var{name1} as an alias
|
ordinal number @var{integer}, or declares @var{name1} as an alias
|
(forward) of the function @var{external-name} in the DLL.
|
(forward) of the function @var{external-name} in the DLL.
|
If @var{its_name} is specified, this name is used as string in export table.
|
If @var{its_name} is specified, this name is used as string in export table.
|
@var{module-name}.
|
@var{module-name}.
|
|
Note: The @code{EXPORTS} has to be the last command in .def file, as keywords
|
|
are treated - beside @code{LIBRARY} - as simple name-identifiers.
|
|
If you want to use LIBRARY as name then you need to quote it.
|
|
|
@item @code{IMPORTS ( (} @var{internal-name} @code{=} @var{module-name} @code{.} @var{integer} @code{) | [} @var{internal-name} @code{= ]} @var{module-name} @code{.} @var{external-name} @code{) [ == ) @var{its_name} @code{]} *}
|
@item @code{IMPORTS ( (} @var{internal-name} @code{=} @var{module-name} @code{.} @var{integer} @code{) | [} @var{internal-name} @code{= ]} @var{module-name} @code{.} @var{external-name} @code{) [ == ) @var{its_name} @code{]} *}
|
Declares that @var{external-name} or the exported function whose
|
Declares that @var{external-name} or the exported function whose
|
ordinal number is @var{integer} is to be imported from the file
|
ordinal number is @var{integer} is to be imported from the file
|
@var{module-name}. If @var{internal-name} is specified then this is
|
@var{module-name}. If @var{internal-name} is specified then this is
|
the name that the imported function will be referred to in the body of
|
the name that the imported function will be referred to in the body of
|
the DLL.
|
the DLL.
|
If @var{its_name} is specified, this name is used as string in import table.
|
If @var{its_name} is specified, this name is used as string in import table.
|
|
Note: The @code{IMPORTS} has to be the last command in .def file, as keywords
|
|
are treated - beside @code{LIBRARY} - as simple name-identifiers.
|
|
If you want to use LIBRARY as name then you need to quote it.
|
|
|
@item @code{DESCRIPTION} @var{string}
|
@item @code{DESCRIPTION} @var{string}
|
Puts @var{string} into the output @file{.exp} file in the
|
Puts @var{string} into the output @file{.exp} file in the
|
@code{.rdata} section.
|
@code{.rdata} section.
|
|
|
