100 lines
5.1 KiB
HTML
100 lines
5.1 KiB
HTML
<html lang="en">
|
|
<head>
|
|
<title>ranlib - GNU Binary Utilities</title>
|
|
<meta http-equiv="Content-Type" content="text/html">
|
|
<meta name="description" content="GNU Binary Utilities">
|
|
<meta name="generator" content="makeinfo 4.13">
|
|
<link title="Top" rel="start" href="index.html#Top">
|
|
<link rel="prev" href="objdump.html#objdump" title="objdump">
|
|
<link rel="next" href="size.html#size" title="size">
|
|
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
|
|
<!--
|
|
Copyright (C) 1991-2019 Free Software Foundation, Inc.
|
|
|
|
Permission is granted to copy, distribute and/or modify this document
|
|
under the terms of the GNU 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 ``GNU Free Documentation License''.
|
|
|
|
-->
|
|
<meta http-equiv="Content-Style-Type" content="text/css">
|
|
<style type="text/css"><!--
|
|
pre.display { font-family:inherit }
|
|
pre.format { font-family:inherit }
|
|
pre.smalldisplay { font-family:inherit; font-size:smaller }
|
|
pre.smallformat { font-family:inherit; font-size:smaller }
|
|
pre.smallexample { font-size:smaller }
|
|
pre.smalllisp { font-size:smaller }
|
|
span.sc { font-variant:small-caps }
|
|
span.roman { font-family:serif; font-weight:normal; }
|
|
span.sansserif { font-family:sans-serif; font-weight:normal; }
|
|
--></style>
|
|
</head>
|
|
<body>
|
|
<div class="node">
|
|
<a name="ranlib"></a>
|
|
<p>
|
|
Next: <a rel="next" accesskey="n" href="size.html#size">size</a>,
|
|
Previous: <a rel="previous" accesskey="p" href="objdump.html#objdump">objdump</a>,
|
|
Up: <a rel="up" accesskey="u" href="index.html#Top">Top</a>
|
|
<hr>
|
|
</div>
|
|
|
|
<h2 class="chapter">5 ranlib</h2>
|
|
|
|
<p><a name="index-ranlib-115"></a><a name="index-archive-contents-116"></a><a name="index-symbol-index-117"></a>
|
|
<!-- man title ranlib generate an index to an archive -->
|
|
|
|
<pre class="smallexample"> <!-- man begin SYNOPSIS ranlib -->
|
|
ranlib [<samp><span class="option">--plugin</span></samp> <var>name</var>] [<samp><span class="option">-DhHvVt</span></samp>] <var>archive</var>
|
|
<!-- man end -->
|
|
</pre>
|
|
<!-- man begin DESCRIPTION ranlib -->
|
|
<p><samp><span class="command">ranlib</span></samp> 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 ‘<samp><span class="samp">nm -s</span></samp>’ or ‘<samp><span class="samp">nm --print-armap</span></samp>’ 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 <span class="sc">gnu</span> <samp><span class="command">ranlib</span></samp> program is another form of <span class="sc">gnu</span> <samp><span class="command">ar</span></samp>; running
|
|
<samp><span class="command">ranlib</span></samp> is completely equivalent to executing ‘<samp><span class="samp">ar -s</span></samp>’.
|
|
See <a href="ar.html#ar">ar</a>.
|
|
|
|
<!-- man end -->
|
|
<!-- man begin OPTIONS ranlib -->
|
|
<dl>
|
|
<dt><samp><span class="env">-h</span></samp><dt><samp><span class="env">-H</span></samp><dt><samp><span class="env">--help</span></samp><dd>Show usage information for <samp><span class="command">ranlib</span></samp>.
|
|
|
|
<br><dt><samp><span class="env">-v</span></samp><dt><samp><span class="env">-V</span></samp><dt><samp><span class="env">--version</span></samp><dd>Show the version number of <samp><span class="command">ranlib</span></samp>.
|
|
|
|
<br><dt><samp><span class="env">-D</span></samp><dd><a name="index-deterministic-archives-118"></a><a name="index-g_t_002d_002denable_002ddeterministic_002darchives-119"></a>Operate in <em>deterministic</em> 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.
|
|
|
|
<p>If <samp><span class="file">binutils</span></samp> was configured with
|
|
<samp><span class="option">--enable-deterministic-archives</span></samp>, then this mode is on by
|
|
default. It can be disabled with the ‘<samp><span class="samp">-U</span></samp>’ option, described
|
|
below.
|
|
|
|
<br><dt><samp><span class="env">-t</span></samp><dd>Update the timestamp of the symbol map of an archive.
|
|
|
|
<br><dt><samp><span class="env">-U</span></samp><dd><a name="index-deterministic-archives-120"></a><a name="index-g_t_002d_002denable_002ddeterministic_002darchives-121"></a>Do <em>not</em> operate in <em>deterministic</em> mode. This is the
|
|
inverse of the ‘<samp><span class="samp">-D</span></samp>’ option, above: the archive index will get
|
|
actual UID, GID, timestamp, and file mode values.
|
|
|
|
<p>If <samp><span class="file">binutils</span></samp> was configured <em>without</em>
|
|
<samp><span class="option">--enable-deterministic-archives</span></samp>, then this mode is on by
|
|
default.
|
|
|
|
</dl>
|
|
|
|
<!-- man end -->
|
|
</body></html>
|
|
|