xref: /csrg-svn/usr.bin/ranlib/ranlib.1 (revision 44281)
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