165 lines
4.2 KiB
HTML
165 lines
4.2 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of RANLIB</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>RANLIB</H1>
|
|
Section: GNU Development Tools (1)<BR>Updated: 2021-01-21<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
ranlib - generate an index to an archive
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
|
|
|
|
ranlib [<B>--plugin</B> <I>name</I>] [<B>-DhHvVt</B>] <I>archive</I>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
|
|
|
|
<B>ranlib</B> 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.
|
|
<P>
|
|
|
|
You may use <B>nm -s</B> or <B>nm --print-armap</B> to list this index.
|
|
<P>
|
|
|
|
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.
|
|
<P>
|
|
|
|
The <FONT SIZE="-1">GNU</FONT> <B>ranlib</B> program is another form of <FONT SIZE="-1">GNU</FONT> <B>ar</B>; running
|
|
<B>ranlib</B> is completely equivalent to executing <B>ar -s</B>.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-h</B><DD>
|
|
|
|
|
|
|
|
<DT id="2"><B>-H</B><DD>
|
|
|
|
|
|
<DT id="3"><B>--help</B><DD>
|
|
|
|
|
|
|
|
Show usage information for <B>ranlib</B>.
|
|
<DT id="4"><B>-v</B><DD>
|
|
|
|
|
|
|
|
<DT id="5"><B>-V</B><DD>
|
|
|
|
|
|
<DT id="6"><B>--version</B><DD>
|
|
|
|
|
|
|
|
Show the version number of <B>ranlib</B>.
|
|
<DT id="7"><B>-D</B><DD>
|
|
|
|
|
|
Operate in <I>deterministic</I> mode. The symbol map archive member's
|
|
header will show zero for the <FONT SIZE="-1">UID, GID,</FONT> and timestamp. When this
|
|
option is used, multiple runs will produce identical output files.
|
|
|
|
|
|
<P>
|
|
|
|
|
|
If <I>binutils</I> was configured with
|
|
<B>--enable-deterministic-archives</B>, then this mode is on by
|
|
default. It can be disabled with the <B>-U</B> option, described
|
|
below.
|
|
<DT id="8"><B>-t</B><DD>
|
|
|
|
|
|
Update the timestamp of the symbol map of an archive.
|
|
<DT id="9"><B>-U</B><DD>
|
|
|
|
|
|
Do <I>not</I> operate in <I>deterministic</I> mode. This is the
|
|
inverse of the <B>-D</B> option, above: the archive index will get
|
|
actual <FONT SIZE="-1">UID, GID,</FONT> timestamp, and file mode values.
|
|
|
|
|
|
<P>
|
|
|
|
|
|
If <I>binutils</I> was configured <I>without</I>
|
|
<B>--enable-deterministic-archives</B>, then this mode is on by
|
|
default.
|
|
<DT id="10"><B>@</B><I>file</I><DD>
|
|
|
|
|
|
Read command-line options from <I>file</I>. The options read are
|
|
inserted in place of the original @<I>file</I> option. If <I>file</I>
|
|
does not exist, or cannot be read, then the option will be treated
|
|
literally, and not removed.
|
|
|
|
|
|
<P>
|
|
|
|
|
|
Options in <I>file</I> are separated by whitespace. A whitespace
|
|
character may be included in an option by surrounding the entire
|
|
option in either single or double quotes. Any character (including a
|
|
backslash) may be included by prefixing the character to be included
|
|
with a backslash. The <I>file</I> may itself contain additional
|
|
@<I>file</I> options; any such options will be processed recursively.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+ar">ar</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+nm">nm</A></B>(1), and the Info entries for <I>binutils</I>.
|
|
<A NAME="lbAG"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
|
|
|
|
Copyright (c) 1991-2020 Free Software Foundation, Inc.
|
|
<P>
|
|
|
|
Permission is granted to copy, distribute and/or modify this document
|
|
under the terms of the <FONT SIZE="-1">GNU</FONT> Free Documentation License, Version 1.3
|
|
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 ``<FONT SIZE="-1">GNU</FONT> Free Documentation License''.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="11"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="12"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="13"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="14"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="15"><A HREF="#lbAF">SEE ALSO</A><DD>
|
|
<DT id="16"><A HREF="#lbAG">COPYRIGHT</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:26 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|