projects / unix-history / blame
| Commit | Line | Data |
|---|---|---|
| dd9e2e8d CL |
1 | .\" Copyright (c) 1990 Regents of the University of California. |
| 2 | .\" All rights reserved. The Berkeley software License Agreement | |
| 3 | .\" specifies the terms and conditions for redistribution. | |
| 14b55ac4 | 4 | .\" |
| dd9e2e8d CL |
5 | .\" @(#)ranlib.1 6.3 (Berkeley) %G% |
| 6 | .\" | |
| 7 | .Dt RANLIB 1 | |
| 8 | .Os ATT 7th | |
| 9 | .Sh NAME | |
| 10 | .Nm ranlib | |
| 11 | .Nd convert archives to random libraries | |
| 12 | .Sh SYNOPSIS | |
| 13 | .Nm ranlib | |
| 14 | .Op Fl t | |
| 15 | .Ar archive ... | |
| 16 | .Sh DESCRIPTION | |
| 17 | .Nm Ranlib | |
| 14b55ac4 | 18 | converts each |
| dd9e2e8d | 19 | .Ar archive |
| 06541c90 | 20 | to a form which the loader can load more rapidly. |
| dd9e2e8d CL |
21 | .Nm Ranlib |
| 22 | does this by adding a table of contents called | |
| 23 | .Sy \&__.SYMDEF | |
| 14b55ac4 | 24 | to the beginning of the archive. |
| dd9e2e8d CL |
25 | .Nm Ranlib |
| 26 | uses | |
| 27 | .Xr ar 1 | |
| 06541c90 KM |
28 | to reconstruct the archive, so that sufficient temporary file space must |
| 29 | be available in the file system which contains the current directory. | |
| dd9e2e8d CL |
30 | .Pp |
| 31 | .Tp Fl t | |
| 32 | Ranlib only "touches" the archives and does not modify them. | |
| 3f49374c KM |
33 | This is useful after copying an archive |
| 34 | or using the | |
| dd9e2e8d | 35 | .Fl t |
| 3f49374c | 36 | option of |
| dd9e2e8d | 37 | .Xr make 1 |
| 3f49374c | 38 | in order to avoid having |
| dd9e2e8d | 39 | .Xr ld 1 |
| 3f49374c | 40 | complain about |
| dd9e2e8d CL |
41 | an |
| 42 | .Dq out of date | |
| 43 | symbol table. | |
| 44 | .Tp | |
| 45 | .Sh SEE ALSO | |
| 46 | .Xr ld 1 , | |
| 47 | .Xr ar 1 , | |
| 48 | .Xr lorder 1 , | |
| 49 | .Xr make 1 | |
| 50 | .Sh HISTORY | |
| 51 | .Nm Ranlib | |
| 52 | appeared in Version 7 AT&T UNIX. | |
| 53 | .Sh BUGS | |
| 14b55ac4 | 54 | Because generation of a library by |
| dd9e2e8d | 55 | .Xr ar |
| 06541c90 | 56 | and randomization of the library by |
| dd9e2e8d | 57 | .Nm ranlib |
| 06541c90 | 58 | are separate processes, phase errors are possible. The loader, |
| dd9e2e8d | 59 | .Xr ld , |
| 06541c90 KM |
60 | warns when the modification date of a library is more recent than the |
| 61 | creation date of its dictionary; but this means that you get the | |
| 62 | warning even if you only copy the library. |