xref: /csrg-svn/usr.bin/ranlib/ranlib.1 (revision 62197)
1*62197Sbostic.\" Copyright (c) 1990, 1993
2*62197Sbostic.\"	The Regents of the University of California.  All rights reserved.
319451Smckusick.\"
449515Scael.\" %sccs.include.redist.roff%
544281Scael.\"
6*62197Sbostic.\"     @(#)ranlib.1	8.1 (Berkeley) 06/06/93
744957Scael.\"
844957Scael.Dd
944281Scael.Dt RANLIB 1
1049515Scael.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:
2849515Scael.Bl -tag -width indent
2949515Scael.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 .
4549515Scael.El
4646011Sbostic.Sh FILES
4749515Scael.Bl -tag -width /tmp/ranlib.XXXXXX -compact
4849515Scael.It Pa /tmp/ranlib.XXXXXX
4949515ScaelTemporary file names.
5049515Scael.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
5849515ScaelA
5949515Scael.Nm ranlib
6049515Scaelcommand appeared in
6149515Scael.At v7 .
62