Return to ranlib.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / pgrm / ranlib

Annotation of 43BSDReno/pgrm/ranlib/ranlib.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1990 Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted provided
                      5: .\" that: (1) source distributions retain this entire copyright notice and
                      6: .\" comment, and (2) distributions including binaries display the following
                      7: .\" acknowledgement:  ``This product includes software developed by the
                      8: .\" University of California, Berkeley and its contributors'' in the
                      9: .\" documentation or other materials provided with the distribution and in
                     10: .\" all advertising materials mentioning features or use of this software.
                     11: .\" Neither the name of the University nor the names of its contributors may
                     12: .\" be used to endorse or promote products derived from this software without
                     13: .\" specific prior written permission.
                     14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
                     15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
                     16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     17: .\"
                     18: .\"     @(#)ranlib.1   6.4 (Berkeley) 7/24/90
                     19: .\"
                     20: .Dd July 24, 1990
                     21: .Dt RANLIB 1
                     22: .BSD 4.4
                     23: .Sh NAME
                     24: .Nm ranlib
                     25: .Nd preprocess archives for efficient linking
                     26: .Sh SYNOPSIS
                     27: .Nm ranlib
                     28: .Op Fl t
                     29: .Ar archive_file ...
                     30: .Sh DESCRIPTION
                     31: .Nm Ranlib
                     32: is a preprocessor for the loading utility
                     33: .Xr ld 1 .
                     34: .Nm Ranlib
                     35: creates a randomized library from the given
                     36: .Ar archive_file
                     37: with
                     38: the file entry named
                     39: .Sy \&__.SYMDEF
                     40: prepended.
                     41: The
                     42: .Sy \&__.SYMDEF
                     43: file entry is a dictionary the loader can detect and interpret
                     44: to resolve external references at link time.
                     45: To generate the library, the
                     46: .Xr ar 1
                     47: utility is used.
                     48: .Tw 8n
                     49: .Tp Fl t
                     50: Ranlib only "touches" the archives and does not modify them.
                     51: This is useful after copying an archive
                     52: or using the
                     53: .Fl t
                     54: option of
                     55: .Xr make  1
                     56: in order to avoid having
                     57: .Xr ld  1
                     58: complain about
                     59: an
                     60: .Dq out of date
                     61: symbol table.
                     62: .Tp
                     63: .Sh SEE ALSO
                     64: .Xr ar 1 ,
                     65: .Xr ld 1 ,
                     66: .Xr lorder 1 ,
                     67: .Xr make 1 ,
                     68: .Xr nm 1
                     69: .Sh HISTORY
                     70: .Nm Ranlib
                     71: appeared in Version 7 AT&T UNIX.
                     72: .Sh BUGS
                     73: The archiving is a separate process and phase
                     74: errors may occur (see the
                     75: .Fl t
                     76: option above).

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