xref: /csrg-svn/usr.bin/ranlib/ranlib.1 (revision 46011)
144281Scael.\" Copyright (c) 1990 Regents of the University of California.
244957Scael.\" All rights reserved.
319451Smckusick.\"
444957Scael.\" %sccs.include.redist.man%
544281Scael.\"
6*46011Sbostic.\"     @(#)ranlib.1	6.5 (Berkeley) 01/18/91
744957Scael.\"
844957Scael.Dd
944281Scael.Dt RANLIB 1
1044957Scael.BSD 4.4
1144281Scael.Sh NAME
1244281Scael.Nm ranlib
13*46011Sbostic.Nd table-of-contents for archive libraries
1444281Scael.Sh SYNOPSIS
1544281Scael.Nm ranlib
1644281Scael.Op Fl t
17*46011Sbostic.Ar file ...
1844281Scael.Sh DESCRIPTION
1944281Scael.Nm Ranlib
20*46011Sbosticcreates a table of external references for archive libraries,
21*46011Sbosticnormally used by the loader,
2244957Scael.Xr ld 1 .
23*46011SbosticThis table is is named ``__.SYMDEF'' and is prepended to the archive.
24*46011SbosticFiles in the archive which are not executable and symbols which are
25*46011Sbosticuninteresting to the loader are ignored.
26*46011Sbostic.Pp
27*46011SbosticThe options are as follows:
2844957Scael.Tw 8n
2944281Scael.Tp Fl t
30*46011SbosticSet the modification time of the __.SYMDEF file.
31*46011SbosticThis time is compared by the loader with the modification time of the
32*46011Sbosticarchive to verify that the table is up-to-date with respect to the
33*46011Sbosticarchive.
34*46011SbosticIf the modification time has been changed without any change to the
35*46011Sbosticarchive (for example, by a
36*46011Sbostic.Xr cp 1 ) ,
37*46011Sbosticthe
3844281Scael.Fl t
39*46011Sbosticoption can be used to ``touch'' the modification time so that it
40*46011Sbosticappears that the table is up-to-date.
41*46011SbosticThis is also useful after using the
42*46011Sbostic.Fl t
4319931Smckusickoption of
44*46011Sbostic.Xr make 1 .
4544281Scael.Tp
46*46011Sbostic.Sh FILES
47*46011Sbostic/tmp/ranlib.XXXXXX	temporary file names
4844281Scael.Sh SEE ALSO
4944957Scael.Xr ar 1 ,
5044281Scael.Xr ld 1 ,
5144281Scael.Xr lorder 1 ,
52*46011Sbostic.Xr nm 1 ,
53*46011Sbostic.Xr ranlib 5
5444281Scael.Sh HISTORY
5544281Scael.Nm Ranlib
5644281Scaelappeared in Version 7 AT&T UNIX.
57