xref: /original-bsd/usr.bin/ranlib/ranlib.1 (revision 27f6e8d8)
1.\" Copyright (c) 1990 Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)ranlib.1	6.6 (Berkeley) 03/14/91
7.\"
8.Vx
9.Vx
10.Dd
11.Dt RANLIB 1
12.BSD 4.4
13.Sh NAME
14.Nm ranlib
15.Nd table-of-contents for archive libraries
16.Sh SYNOPSIS
17.Nm ranlib
18.Op Fl t
19.Ar file ...
20.Sh DESCRIPTION
21.Nm Ranlib
22creates a table of external references for archive libraries,
23normally used by the loader,
24.Xr ld 1 .
25This table is is named ``__.SYMDEF'' and is prepended to the archive.
26Files in the archive which are not executable and symbols which are
27uninteresting to the loader are ignored.
28.Pp
29The options are as follows:
30.Tw 8n
31.Tp Fl t
32Set the modification time of the __.SYMDEF file.
33This time is compared by the loader with the modification time of the
34archive to verify that the table is up-to-date with respect to the
35archive.
36If the modification time has been changed without any change to the
37archive (for example, by a
38.Xr cp 1 ) ,
39the
40.Fl t
41option can be used to ``touch'' the modification time so that it
42appears that the table is up-to-date.
43This is also useful after using the
44.Fl t
45option of
46.Xr make 1 .
47.Tp
48.Sh FILES
49/tmp/ranlib.XXXXXX	temporary file names
50.Sh SEE ALSO
51.Xr ar 1 ,
52.Xr ld 1 ,
53.Xr lorder 1 ,
54.Xr nm 1 ,
55.Xr ranlib 5
56.Sh HISTORY
57.Nm Ranlib
58appeared in Version 7 AT&T UNIX.
59