1<html lang="en"> 2<head> 3<title>ranlib - GNU Binary Utilities</title> 4<meta http-equiv="Content-Type" content="text/html"> 5<meta name="description" content="GNU Binary Utilities"> 6<meta name="generator" content="makeinfo 4.13"> 7<link title="Top" rel="start" href="index.html#Top"> 8<link rel="prev" href="objdump.html#objdump" title="objdump"> 9<link rel="next" href="size.html#size" title="size"> 10<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> 11<!-- 12Copyright (C) 1991-2013 Free Software Foundation, Inc. 13 14Permission is granted to copy, distribute and/or modify this document 15under the terms of the GNU Free Documentation License, Version 1.3 16or any later version published by the Free Software Foundation; 17with no Invariant Sections, with no Front-Cover Texts, and with no 18Back-Cover Texts. A copy of the license is included in the 19section entitled ``GNU Free Documentation License''. 20 21--> 22<meta http-equiv="Content-Style-Type" content="text/css"> 23<style type="text/css"><!-- 24 pre.display { font-family:inherit } 25 pre.format { font-family:inherit } 26 pre.smalldisplay { font-family:inherit; font-size:smaller } 27 pre.smallformat { font-family:inherit; font-size:smaller } 28 pre.smallexample { font-size:smaller } 29 pre.smalllisp { font-size:smaller } 30 span.sc { font-variant:small-caps } 31 span.roman { font-family:serif; font-weight:normal; } 32 span.sansserif { font-family:sans-serif; font-weight:normal; } 33--></style> 34<link rel="stylesheet" type="text/css" href="../cs.css"> 35</head> 36<body> 37<div class="node"> 38<a name="ranlib"></a> 39<p> 40Next: <a rel="next" accesskey="n" href="size.html#size">size</a>, 41Previous: <a rel="previous" accesskey="p" href="objdump.html#objdump">objdump</a>, 42Up: <a rel="up" accesskey="u" href="index.html#Top">Top</a> 43<hr> 44</div> 45 46<h2 class="chapter">5 ranlib</h2> 47 48<p><a name="index-ranlib-110"></a><a name="index-archive-contents-111"></a><a name="index-symbol-index-112"></a> 49<!-- man title ranlib generate index to archive. --> 50 51<pre class="smallexample"> <!-- man begin SYNOPSIS ranlib --> 52 ranlib [<samp><span class="option">--plugin</span></samp> <var>name</var>] [<samp><span class="option">-DhHvVt</span></samp>] <var>archive</var> 53 <!-- man end --> 54</pre> 55 <!-- man begin DESCRIPTION ranlib --> 56 <p><samp><span class="command">ranlib</span></samp> generates an index to the contents of an archive and 57stores it in the archive. The index lists each symbol defined by a 58member of an archive that is a relocatable object file. 59 60 <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. 61 62 <p>An archive with such an index speeds up linking to the library and 63allows routines in the library to call each other without regard to 64their placement in the archive. 65 66 <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 67<samp><span class="command">ranlib</span></samp> is completely equivalent to executing ‘<samp><span class="samp">ar -s</span></samp>’. 68See <a href="ar.html#ar">ar</a>. 69 70<!-- man end --> 71<!-- man begin OPTIONS ranlib --> 72 <dl> 73<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>. 74 75 <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>. 76 77 <br><dt><samp><span class="env">-D</span></samp><dd><a name="index-deterministic-archives-113"></a><a name="index-g_t_002d_002denable_002ddeterministic_002darchives-114"></a>Operate in <em>deterministic</em> mode. The symbol map archive member's 78header will show zero for the UID, GID, and timestamp. When this 79option is used, multiple runs will produce identical output files. 80 81 <p>If <samp><span class="file">binutils</span></samp> was configured with 82<samp><span class="option">--enable-deterministic-archives</span></samp>, then this mode is on by 83default. It can be disabled with the ‘<samp><span class="samp">-U</span></samp>’ option, described 84below. 85 86 <br><dt><samp><span class="env">-t</span></samp><dd>Update the timestamp of the symbol map of an archive. 87 88 <br><dt><samp><span class="env">-U</span></samp><dd><a name="index-deterministic-archives-115"></a><a name="index-g_t_002d_002denable_002ddeterministic_002darchives-116"></a>Do <em>not</em> operate in <em>deterministic</em> mode. This is the 89inverse of the ‘<samp><span class="samp">-D</span></samp>’ option, above: the archive index will get 90actual UID, GID, timestamp, and file mode values. 91 92 <p>If <samp><span class="file">binutils</span></samp> was configured <em>without</em> 93<samp><span class="option">--enable-deterministic-archives</span></samp>, then this mode is on by 94default. 95 96 </dl> 97 98<!-- man end --> 99 </body></html> 100 101