Return to ranlib.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1

Annotation of 43BSDTahoe/man/man1/ranlib.1, revision 1.1.1.1

1.1       root        1: .\"    @(#)ranlib.1    6.2 (Berkeley) 5/3/85
                      2: .\"
                      3: .TH RANLIB 1 "May 3, 1985"
                      4: .AT 3
                      5: .SH NAME
                      6: ranlib \- convert archives to random libraries
                      7: .SH SYNOPSIS
                      8: .B ranlib
                      9: [
                     10: .B \-t
                     11: ] archive ...
                     12: .SH DESCRIPTION
                     13: .I Ranlib
                     14: converts each
                     15: .I archive
                     16: to a form which the loader can load more rapidly.
                     17: .I Ranlib
                     18: does this by adding a table of contents called 
                     19: .B __.SYMDEF
                     20: to the beginning of the archive.
                     21: .I Ranlib
                     22: uses 
                     23: .IR ar (1)
                     24: to reconstruct the archive, so that sufficient temporary file space must
                     25: be available in the file system which contains the current directory.
                     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.
                     40: .SH "SEE ALSO"
                     41: ld(1), ar(1), lorder(1), make(1)
                     42: .SH BUGS
                     43: Because generation of a library by
                     44: .I ar
                     45: and randomization of the library by
                     46: .I ranlib
                     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.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.