ranlib(XNX)                    6 January 1993                    ranlib(XNX)


 Name

    ranlib - converts archives to random libraries.

 Syntax

    ranlib archive...

 Description

    ranlib converts each archive to a form which can be loaded more rapidly
    by the loader, by adding a table of contents named .SYMDEF to the
    beginning of the archive.  It uses ar(XNX) to reconstruct the archive, so
    sufficient temporary file space must be available in the file system con-
    taining the current directory.

 Notes

    ranlib should only be used on libraries containing OMF binaries created
    with ar(XNX).  If ranlib is used on a library containing COFF binaries,
    it will generate an error message.

    Failure to process a library with ranlib, or failure to reprocess a
    library with ranlib, will cause ld to fail.  Because generation of a
    library by ar and randomization by ranlib are separate, phase errors are
    possible.  The loader ld warns when the modification date of a library is
    more recent than the creation of its dictionary; but this means you get
    the warning even if you only copy the library.

 See also

    ld(XNX), ar(XNX), copy(C), settime(ADM)

 Standards conformance

    ranlib is an extension of AT&T System V provided by the Santa Cruz Opera-
    tion.