ranlib(1)             GNU Development Tools             ranlib(1)


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
       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 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 permission notice are preserved on all copies.

       Permission is granted to copy and distribute modified ver-
       sions of this manual under  the  conditions  for  verbatim
       copying,  provided  that the entire resulting derived work
       is distributed 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 con-
       ditions for modified versions, except that this permission
       notice may be included in  translations  approved  by  the
       Free  Software  Foundation  instead of in the original En-
       glish.




cygnus support           5 November 1991                        1