1*44281Scael.\" Copyright (c) 1990 Regents of the University of California. 2*44281Scael.\" All rights reserved. The Berkeley software License Agreement 3*44281Scael.\" specifies the terms and conditions for redistribution. 419451Smckusick.\" 5*44281Scael.\" @(#)ranlib.1 6.3 (Berkeley) 06/26/90 6*44281Scael.\" 7*44281Scael.Dt RANLIB 1 8*44281Scael.Os ATT 7th 9*44281Scael.Sh NAME 10*44281Scael.Nm ranlib 11*44281Scael.Nd convert archives to random libraries 12*44281Scael.Sh SYNOPSIS 13*44281Scael.Nm ranlib 14*44281Scael.Op Fl t 15*44281Scael.Ar archive ... 16*44281Scael.Sh DESCRIPTION 17*44281Scael.Nm Ranlib 1819451Smckusickconverts each 19*44281Scael.Ar archive 2019452Smckusickto a form which the loader can load more rapidly. 21*44281Scael.Nm Ranlib 22*44281Scaeldoes this by adding a table of contents called 23*44281Scael.Sy \&__.SYMDEF 2419451Smckusickto the beginning of the archive. 25*44281Scael.Nm Ranlib 26*44281Scaeluses 27*44281Scael.Xr ar 1 2819452Smckusickto reconstruct the archive, so that sufficient temporary file space must 2919452Smckusickbe available in the file system which contains the current directory. 30*44281Scael.Pp 31*44281Scael.Tp Fl t 32*44281ScaelRanlib only "touches" the archives and does not modify them. 3319931SmckusickThis is useful after copying an archive 3419931Smckusickor using the 35*44281Scael.Fl t 3619931Smckusickoption of 37*44281Scael.Xr make 1 3819931Smckusickin order to avoid having 39*44281Scael.Xr ld 1 4019931Smckusickcomplain about 41*44281Scaelan 42*44281Scael.Dq out of date 43*44281Scaelsymbol table. 44*44281Scael.Tp 45*44281Scael.Sh SEE ALSO 46*44281Scael.Xr ld 1 , 47*44281Scael.Xr ar 1 , 48*44281Scael.Xr lorder 1 , 49*44281Scael.Xr make 1 50*44281Scael.Sh HISTORY 51*44281Scael.Nm Ranlib 52*44281Scaelappeared in Version 7 AT&T UNIX. 53*44281Scael.Sh BUGS 5419451SmckusickBecause generation of a library by 55*44281Scael.Xr ar 5619452Smckusickand randomization of the library by 57*44281Scael.Nm ranlib 5819452Smckusickare separate processes, phase errors are possible. The loader, 59*44281Scael.Xr ld , 6019452Smckusickwarns when the modification date of a library is more recent than the 6119452Smckusickcreation date of its dictionary; but this means that you get the 6219452Smckusickwarning even if you only copy the library. 63