usr/man/cat1/ranlib.0



RANLIB(1)           UNIX Programmer's Manual            RANLIB(1)


N\bNA\bAM\bME\bE
     ranlib - convert archives to random libraries

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
     r\bra\ban\bnl\bli\bib\bb [ -\b-t\bt ] archive ...

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     _\bR_\ba_\bn_\bl_\bi_\bb converts each _\ba_\br_\bc_\bh_\bi_\bv_\be to a form which the loader can
     load more rapidly.  _\bR_\ba_\bn_\bl_\bi_\bb does this by adding a table of
     contents called _\b__\b_.\b.S\bSY\bYM\bMD\bDE\bEF\bF to the beginning of the archive.
     _\bR_\ba_\bn_\bl_\bi_\bb uses _\ba_\br(1) to reconstruct the archive, so that suffi-
     cient temporary file space must be available in the file
     system which contains the current directory.

     If given the -\b-t\bt option, ranlib only "touches" the archives
     and does not modify them.  This is useful after copying an
     archive or using the -\b-t\bt option of _\bm_\ba_\bk_\be(1) in order to avoid
     having _\bl_\bd(1) complain about an "out of date" symbol table.

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     ld(1), ar(1), lorder(1), make(1)

B\bBU\bUG\bGS\bS
     Because generation of a library by _\ba_\br and randomization of
     the library by _\br_\ba_\bn_\bl_\bi_\bb are separate processes, phase errors
     are possible.  The loader, _\bl_\bd, warns when the modification
     date of a library is more recent than the creation date of
     its dictionary;  but this means that you get the warning
     even if you only copy the library.


Printed 7/9/88             May 3, 1985                          1