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="readelf.html#readelf" title="readelf"> 10<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> 11<!-- 12Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 132000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 14Free Software Foundation, Inc. 15 16Permission is granted to copy, distribute and/or modify this document 17under the terms of the GNU Free Documentation License, Version 1.3 18or any later version published by the Free Software Foundation; 19with no Invariant Sections, with no Front-Cover Texts, and with no 20Back-Cover Texts. A copy of the license is included in the 21section entitled ``GNU Free Documentation License''. 22 23--> 24<meta http-equiv="Content-Style-Type" content="text/css"> 25<style type="text/css"><!-- 26 pre.display { font-family:inherit } 27 pre.format { font-family:inherit } 28 pre.smalldisplay { font-family:inherit; font-size:smaller } 29 pre.smallformat { font-family:inherit; font-size:smaller } 30 pre.smallexample { font-size:smaller } 31 pre.smalllisp { font-size:smaller } 32 span.sc { font-variant:small-caps } 33 span.roman { font-family:serif; font-weight:normal; } 34 span.sansserif { font-family:sans-serif; font-weight:normal; } 35--></style> 36<link rel="stylesheet" type="text/css" href="../cs.css"> 37</head> 38<body> 39<div class="node"> 40<a name="ranlib"></a> 41<p> 42Next: <a rel="next" accesskey="n" href="readelf.html#readelf">readelf</a>, 43Previous: <a rel="previous" accesskey="p" href="objdump.html#objdump">objdump</a>, 44Up: <a rel="up" accesskey="u" href="index.html#Top">Top</a> 45<hr> 46</div> 47 48<h2 class="chapter">5 ranlib</h2> 49 50<p><a name="index-ranlib-103"></a><a name="index-archive-contents-104"></a><a name="index-symbol-index-105"></a> 51<!-- man title ranlib generate index to archive. --> 52 53<pre class="smallexample"> <!-- man begin SYNOPSIS ranlib --> 54 ranlib [<samp><span class="option">-vVt</span></samp>] <var>archive</var> 55 <!-- man end --> 56</pre> 57 <!-- man begin DESCRIPTION ranlib --> 58 <p><samp><span class="command">ranlib</span></samp> generates an index to the contents of an archive and 59stores it in the archive. The index lists each symbol defined by a 60member of an archive that is a relocatable object file. 61 62 <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. 63 64 <p>An archive with such an index speeds up linking to the library and 65allows routines in the library to call each other without regard to 66their placement in the archive. 67 68 <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 69<samp><span class="command">ranlib</span></samp> is completely equivalent to executing ‘<samp><span class="samp">ar -s</span></samp>’. 70See <a href="ar.html#ar">ar</a>. 71 72<!-- man end --> 73<!-- man begin OPTIONS ranlib --> 74 <dl> 75<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">-t</span></samp><dd>Update the timestamp of the symbol map of an archive. 78</dl> 79 80<!-- man end --> 81 </body></html> 82 83