projects / unix-history / blame
| 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. |