Return to ranlib.1 CVS log

Up to [local] / src / usr.bin / ranlib

Annotation of src/usr.bin/ranlib/ranlib.1, Revision 1.1

1.1     ! deraadt     1: .\" Copyright (c) 1990 Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms, with or without
        !             5: .\" modification, are permitted provided that the following conditions
        !             6: .\" are met:
        !             7: .\" 1. Redistributions of source code must retain the above copyright
        !             8: .\"    notice, this list of conditions and the following disclaimer.
        !             9: .\" 2. Redistributions in binary form must reproduce the above copyright
        !            10: .\"    notice, this list of conditions and the following disclaimer in the
        !            11: .\"    documentation and/or other materials provided with the distribution.
        !            12: .\" 3. All advertising materials mentioning features or use of this software
        !            13: .\"    must display the following acknowledgement:
        !            14: .\"    This product includes software developed by the University of
        !            15: .\"    California, Berkeley and its contributors.
        !            16: .\" 4. Neither the name of the University nor the names of its contributors
        !            17: .\"    may be used to endorse or promote products derived from this software
        !            18: .\"    without specific prior written permission.
        !            19: .\"
        !            20: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
        !            21: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
        !            22: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
        !            23: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
        !            24: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
        !            25: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
        !            26: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
        !            27: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
        !            28: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
        !            29: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
        !            30: .\" SUCH DAMAGE.
        !            31: .\"
        !            32: .\"     from: @(#)ranlib.1     6.7 (Berkeley) 5/9/91
        !            33: .\"    $Id: ranlib.1,v 1.3 1994/01/03 19:14:21 jtc Exp $
        !            34: .\"
        !            35: .Dd May 9, 1991
        !            36: .Dt RANLIB 1
        !            37: .Os
        !            38: .Sh NAME
        !            39: .Nm ranlib
        !            40: .Nd table-of-contents for archive libraries
        !            41: .Sh SYNOPSIS
        !            42: .Nm ranlib
        !            43: .Op Fl t
        !            44: .Ar file ...
        !            45: .Sh DESCRIPTION
        !            46: .Nm Ranlib
        !            47: creates a table of external references for archive libraries,
        !            48: normally used by the loader,
        !            49: .Xr ld 1 .
        !            50: This table is is named ``__.SYMDEF'' and is prepended to the archive.
        !            51: Files in the archive which are not executable and symbols which are
        !            52: uninteresting to the loader are ignored.
        !            53: .Pp
        !            54: The options are as follows:
        !            55: .Bl -tag -width indent
        !            56: .It Fl t
        !            57: Set the modification time of the __.SYMDEF file.
        !            58: This time is compared by the loader with the modification time of the
        !            59: archive to verify that the table is up-to-date with respect to the
        !            60: archive.
        !            61: If the modification time has been changed without any change to the
        !            62: archive (for example, by a
        !            63: .Xr cp 1 ) ,
        !            64: the
        !            65: .Fl t
        !            66: option can be used to ``touch'' the modification time so that it
        !            67: appears that the table is up-to-date.
        !            68: This is also useful after using the
        !            69: .Fl t
        !            70: option of
        !            71: .Xr make 1 .
        !            72: .El
        !            73: .Sh ENVIRONMENT
        !            74: .Bl -tag -width TMPDIR -compact
        !            75: .It Ev TMPDIR
        !            76: The pathname of the directory to use when creating temporary files.
        !            77: .El
        !            78: .Sh FILES
        !            79: .Bl -tag -width /tmp/ranlib.XXXXXX -compact
        !            80: .It Pa /tmp/ranlib.XXXXXX
        !            81: Temporary file names.
        !            82: .El
        !            83: .Sh SEE ALSO
        !            84: .Xr ar 1 ,
        !            85: .Xr ld 1 ,
        !            86: .Xr lorder 1 ,
        !            87: .Xr nm 1 ,
        !            88: .Xr ranlib 5
        !            89: .Sh HISTORY
        !            90: A
        !            91: .Nm ranlib
        !            92: command appeared in
        !            93: .At v7 .