ranlib


     NAME
          ranlib - generate index to archive.


     SYNOPSIS
          ranlib [-v|-V] archive

     DESCRIPTION
          ranlib generates an index to the contents of an archive, and
          stores  it  in the archive.  The index lists each symbol de-
          fined by a member of an archive that is a relocatable object
          file.

          You may use `nm -s' or `nm --print-armap' to list  this  in-
          dex.

          An archive with such an index speeds up linking to  the  li-
          brary, 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'.


     OPTIONS
          -v   Print the version number of ranlib and exit.


     SEE ALSO
          `binutils' entry in info; The GNU Binary  Utilities,  Roland
          H. Pesch (October 1991); ar(1), nm(1).



     COPYING
          Copyright (c) 1991 Free Software Foundation, Inc.

          Permission is granted to make and distribute verbatim copies
          of  this  manual provided the copyright notice and this per-
          mission notice are preserved on all copies.

          Permission is granted to copy and distribute  modified  ver-
          sions of this manual under the conditions for verbatim copy-
          ing, provided that the entire resulting derived work is dis-
          tributed under the terms of a permission notice identical to
          this one.

          Permission is granted to copy and distribute translations of
          this  manual  into  another language, under the above condi-
          tions for modified versions, except that this permission no-
          tice  may  be  included in translations approved by the Free
          Software Foundation instead of in the original English.