144281Scael.\" Copyright (c) 1990 Regents of the University of California. 2*44957Scael.\" All rights reserved. 319451Smckusick.\" 4*44957Scael.\" %sccs.include.redist.man% 544281Scael.\" 6*44957Scael.\" @(#)ranlib.1 6.4 (Berkeley) 07/24/90 7*44957Scael.\" 8*44957Scael.Dd 944281Scael.Dt RANLIB 1 10*44957Scael.BSD 4.4 1144281Scael.Sh NAME 1244281Scael.Nm ranlib 13*44957Scael.Nd preprocess archives for efficient linking 1444281Scael.Sh SYNOPSIS 1544281Scael.Nm ranlib 1644281Scael.Op Fl t 17*44957Scael.Ar archive_file ... 1844281Scael.Sh DESCRIPTION 1944281Scael.Nm Ranlib 20*44957Scaelis a preprocessor for the loading utility 21*44957Scael.Xr ld 1 . 2244281Scael.Nm Ranlib 23*44957Scaelcreates a randomized library from the given 24*44957Scael.Ar archive_file 25*44957Scaelwith 26*44957Scaelthe file entry named 2744281Scael.Sy \&__.SYMDEF 28*44957Scaelprepended. 29*44957ScaelThe 30*44957Scael.Sy \&__.SYMDEF 31*44957Scaelfile entry is a dictionary the loader can detect and interpret 32*44957Scaelto resolve external references at link time. 33*44957ScaelTo generate the library, the 34*44957Scael.Xr ar 1 35*44957Scaelutility is used. 36*44957Scael.Tw 8n 3744281Scael.Tp Fl t 3844281ScaelRanlib only "touches" the archives and does not modify them. 3919931SmckusickThis is useful after copying an archive 4019931Smckusickor using the 4144281Scael.Fl t 4219931Smckusickoption of 4344281Scael.Xr make 1 4419931Smckusickin order to avoid having 4544281Scael.Xr ld 1 4619931Smckusickcomplain about 4744281Scaelan 4844281Scael.Dq out of date 4944281Scaelsymbol table. 5044281Scael.Tp 5144281Scael.Sh SEE ALSO 52*44957Scael.Xr ar 1 , 5344281Scael.Xr ld 1 , 5444281Scael.Xr lorder 1 , 55*44957Scael.Xr make 1 , 56*44957Scael.Xr nm 1 5744281Scael.Sh HISTORY 5844281Scael.Nm Ranlib 5944281Scaelappeared in Version 7 AT&T UNIX. 6044281Scael.Sh BUGS 61*44957ScaelThe archiving is a separate process and phase 62*44957Scaelerrors may occur (see the 63*44957Scael.Fl t 64*44957Scaeloption above). 65