xref: /csrg-svn/usr.bin/ranlib/ranlib.1 (revision 49515)
144281Scael.\" Copyright (c) 1990 Regents of the University of California.
244957Scael.\" All rights reserved.
319451Smckusick.\"
4*49515Scael.\" %sccs.include.redist.roff%
544281Scael.\"
6*49515Scael.\"     @(#)ranlib.1	6.7 (Berkeley) 05/09/91
744957Scael.\"
844957Scael.Dd
944281Scael.Dt RANLIB 1
10*49515Scael.Os
1144281Scael.Sh NAME
1244281Scael.Nm ranlib
1346011Sbostic.Nd table-of-contents for archive libraries
1444281Scael.Sh SYNOPSIS
1544281Scael.Nm ranlib
1644281Scael.Op Fl t
1746011Sbostic.Ar file ...
1844281Scael.Sh DESCRIPTION
1944281Scael.Nm Ranlib
2046011Sbosticcreates a table of external references for archive libraries,
2146011Sbosticnormally used by the loader,
2244957Scael.Xr ld 1 .
2346011SbosticThis table is is named ``__.SYMDEF'' and is prepended to the archive.
2446011SbosticFiles in the archive which are not executable and symbols which are
2546011Sbosticuninteresting to the loader are ignored.
2646011Sbostic.Pp
2746011SbosticThe options are as follows:
28*49515Scael.Bl -tag -width indent
29*49515Scael.It Fl t
3046011SbosticSet the modification time of the __.SYMDEF file.
3146011SbosticThis time is compared by the loader with the modification time of the
3246011Sbosticarchive to verify that the table is up-to-date with respect to the
3346011Sbosticarchive.
3446011SbosticIf the modification time has been changed without any change to the
3546011Sbosticarchive (for example, by a
3646011Sbostic.Xr cp 1 ) ,
3746011Sbosticthe
3844281Scael.Fl t
3946011Sbosticoption can be used to ``touch'' the modification time so that it
4046011Sbosticappears that the table is up-to-date.
4146011SbosticThis is also useful after using the
4246011Sbostic.Fl t
4319931Smckusickoption of
4446011Sbostic.Xr make 1 .
45*49515Scael.El
4646011Sbostic.Sh FILES
47*49515Scael.Bl -tag -width /tmp/ranlib.XXXXXX -compact
48*49515Scael.It Pa /tmp/ranlib.XXXXXX
49*49515ScaelTemporary file names.
50*49515Scael.El
5144281Scael.Sh SEE ALSO
5244957Scael.Xr ar 1 ,
5344281Scael.Xr ld 1 ,
5444281Scael.Xr lorder 1 ,
5546011Sbostic.Xr nm 1 ,
5646011Sbostic.Xr ranlib 5
5744281Scael.Sh HISTORY
58*49515ScaelA
59*49515Scael.Nm ranlib
60*49515Scaelcommand appeared in
61*49515Scael.At v7 .
62