Commit | Line | Data |
---|---|---|
80baa34f KB |
1 | .\" Copyright (c) 1990, 1993 |
2 | .\" The Regents of the University of California. All rights reserved. | |
14b55ac4 | 3 | .\" |
091a7ad4 | 4 | .\" %sccs.include.redist.roff% |
dd9e2e8d | 5 | .\" |
80baa34f | 6 | .\" @(#)ranlib.1 8.1 (Berkeley) %G% |
5325ced3 CL |
7 | .\" |
8 | .Dd | |
dd9e2e8d | 9 | .Dt RANLIB 1 |
091a7ad4 | 10 | .Os |
dd9e2e8d CL |
11 | .Sh NAME |
12 | .Nm ranlib | |
6999d532 | 13 | .Nd table-of-contents for archive libraries |
dd9e2e8d CL |
14 | .Sh SYNOPSIS |
15 | .Nm ranlib | |
16 | .Op Fl t | |
6999d532 | 17 | .Ar file ... |
dd9e2e8d CL |
18 | .Sh DESCRIPTION |
19 | .Nm Ranlib | |
6999d532 KB |
20 | creates a table of external references for archive libraries, |
21 | normally used by the loader, | |
5325ced3 | 22 | .Xr ld 1 . |
6999d532 KB |
23 | This table is is named ``__.SYMDEF'' and is prepended to the archive. |
24 | Files in the archive which are not executable and symbols which are | |
25 | uninteresting to the loader are ignored. | |
26 | .Pp | |
27 | The options are as follows: | |
091a7ad4 CL |
28 | .Bl -tag -width indent |
29 | .It Fl t | |
6999d532 KB |
30 | Set the modification time of the __.SYMDEF file. |
31 | This time is compared by the loader with the modification time of the | |
32 | archive to verify that the table is up-to-date with respect to the | |
33 | archive. | |
34 | If the modification time has been changed without any change to the | |
35 | archive (for example, by a | |
36 | .Xr cp 1 ) , | |
37 | the | |
38 | .Fl t | |
39 | option can be used to ``touch'' the modification time so that it | |
40 | appears that the table is up-to-date. | |
41 | This is also useful after using the | |
dd9e2e8d | 42 | .Fl t |
3f49374c | 43 | option of |
6999d532 | 44 | .Xr make 1 . |
091a7ad4 | 45 | .El |
6999d532 | 46 | .Sh FILES |
091a7ad4 CL |
47 | .Bl -tag -width /tmp/ranlib.XXXXXX -compact |
48 | .It Pa /tmp/ranlib.XXXXXX | |
49 | Temporary file names. | |
50 | .El | |
dd9e2e8d | 51 | .Sh SEE ALSO |
dd9e2e8d | 52 | .Xr ar 1 , |
5325ced3 | 53 | .Xr ld 1 , |
dd9e2e8d | 54 | .Xr lorder 1 , |
6999d532 KB |
55 | .Xr nm 1 , |
56 | .Xr ranlib 5 | |
dd9e2e8d | 57 | .Sh HISTORY |
091a7ad4 CL |
58 | A |
59 | .Nm ranlib | |
60 | command appeared in | |
61 | .At v7 . |