4.3BSD-UWisc/man/cat1/ranlib.1

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



NAME
     ranlib - convert archives to random libraries

SYNOPSIS
     ranlib [ -t ] archive ...

DESCRIPTION
     _R_a_n_l_i_b converts each _a_r_c_h_i_v_e to a form which the loader can
     load more rapidly.  _R_a_n_l_i_b does this by adding a table of
     contents called __.SYMDEF to the beginning of the archive.
     _R_a_n_l_i_b uses _a_r(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 -t option, ranlib only "touches" the archives
     and does not modify them.  This is useful after copying an
     archive or using the -t option of _m_a_k_e(1) in order to avoid
     having _l_d(1) complain about an "out of date" symbol table.

SEE ALSO
     ld(1), ar(1), lorder(1), make(1)

BUGS
     Because generation of a library by _a_r and randomization of
     the library by _r_a_n_l_i_b are separate processes, phase errors
     are possible.  The loader, _l_d, 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 12/27/86           May 3, 1985                          1