Commit | Line | Data |
---|---|---|
3f49374c | 1 | .\" @(#)ranlib.1 6.2 (Berkeley) %G% |
14b55ac4 | 2 | .\" |
670192ab | 3 | .TH RANLIB 1 "" |
14b55ac4 KM |
4 | .AT 3 |
5 | .SH NAME | |
6 | ranlib \- convert archives to random libraries | |
7 | .SH SYNOPSIS | |
8 | .B ranlib | |
3f49374c KM |
9 | [ |
10 | .B \-t | |
11 | ] archive ... | |
14b55ac4 KM |
12 | .SH DESCRIPTION |
13 | .I Ranlib | |
14 | converts each | |
15 | .I archive | |
06541c90 KM |
16 | to a form which the loader can load more rapidly. |
17 | .I Ranlib | |
18 | does this by adding a table of contents called | |
3f49374c | 19 | .B __.SYMDEF |
14b55ac4 | 20 | to the beginning of the archive. |
06541c90 KM |
21 | .I Ranlib |
22 | uses | |
14b55ac4 | 23 | .IR ar (1) |
06541c90 KM |
24 | to reconstruct the archive, so that sufficient temporary file space must |
25 | be available in the file system which contains the current directory. | |
3f49374c KM |
26 | .PP |
27 | If given the | |
28 | .B \-t | |
29 | option, | |
30 | ranlib only "touches" the archives and does not modify them. | |
31 | This is useful after copying an archive | |
32 | or using the | |
33 | .B \-t | |
34 | option of | |
35 | .IR make (1) | |
36 | in order to avoid having | |
37 | .IR ld (1) | |
38 | complain about | |
39 | an \*(lqout of date\*(rq symbol table. | |
06541c90 | 40 | .SH "SEE ALSO" |
3f49374c | 41 | ld(1), ar(1), lorder(1), make(1) |
14b55ac4 KM |
42 | .SH BUGS |
43 | Because generation of a library by | |
44 | .I ar | |
06541c90 | 45 | and randomization of the library by |
14b55ac4 | 46 | .I ranlib |
06541c90 KM |
47 | are separate processes, phase errors are possible. The loader, |
48 | .IR ld , | |
49 | warns when the modification date of a library is more recent than the | |
50 | creation date of its dictionary; but this means that you get the | |
51 | warning even if you only copy the library. |