man pages section 1: User Commands

Exit Print View

Updated: July 2014

ranlib (1g)


ranlib - generate index to archive.


ranlib [--plugin name] [-DhHvVt] archive


GNU Development Tools                                   RANLIB(1)

     ranlib - generate index to archive.

     ranlib [--plugin name] [-DhHvVt] archive

     ranlib 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.

     You may use nm -s or nm --print-armap to list this index.

     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.

     The GNU ranlib program is another form of GNU ar; running
     ranlib is completely equivalent to executing ar -s.

         Show usage information for ranlib.

         Show the version number of ranlib.

     -D  Operate in 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 binutils was configured with

     -t  Update the timestamp of the symbol map of an archive.

     -U  Do not operate in deterministic mode.  This is the
         inverse of the -D option, above: the archive index will
         get actual UID, GID, timestamp, and file mode values.

         This is the default unless binutils was configured with

         Read command-line options from file.  The options read
         are inserted in place of the original @file option.  If

binutils-2.23.1      Last change: 2012-11-13                    1

GNU Development Tools                                   RANLIB(1)

         file does not exist, or cannot be read, then the option
         will be treated literally, and not removed.

         Options in file 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 file may itself contain additional
         @file options; any such options will be processed

     See attributes(5) for descriptions of the following

     |Availability   | developer/gnu-binutils |
     |Stability      | Uncommitted            |
     ar(1), nm(1), and the Info entries for binutils.

     Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997,
     1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
     2008, 2009, 2010, 2011, 2012 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".

     This software was built from source available at  The original
     community source was downloaded from

     Further information about this software can be found on the
     open source community website at

binutils-2.23.1      Last change: 2012-11-13                    2