RANLIB(1)                                                            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 recon‐
       struct the archive, so that sufficient 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.



7th Edition                       May 3, 1985                        RANLIB(1)