RANLIB(1)               COMMAND REFERENCE               RANLIB(1)



NAME
     ranlib - convert archives to random libraries

SYNOPSIS
     ranlib [ -s tbl_size ] archive ...

DESCRIPTION
     The command ranlib converts each archive to a form which the
     loader can load more rapidly; ranlib does this by adding a
     table of contents called _.SYMDEF to the beginning of the
     archive, then ranlib uses ar(1) to reconstruct the archive.
     Sufficient temporary file space must be available in the
     file system which contains the current directory.

     The ranlib command works on both long and short format
     archive files and it is automatically executed by ar(1) when
     the contents of an archive are modified.

OPTIONS
     The following option is interpreted by ranlib:

     -stbl_size
             Set the symbol table size to be tbl_size times 1000
             entries. The string table size is also redefined to
             be twelve and a half times as large as the symbol
             table. The default for tbl_size is 6 (6000 symbol
             table entries).

EXAMPLES
     A typical invocation on the archive file arch follows:

          ranlib arch

     This example sets the symbol table size to be 8000 and the
     string table size to be 100,000:

          ranlib -s 8 arch

RETURN VALUE
     [NO_ERRS]      Command completed without error.

     [USAGE]        Incorrect command line syntax. Execution
                    terminated.

     [NP_WARN]      An error warranting a warning message
                    occurred. Execution continues.

     [NP_ERR]       An error occurred that was not a system
                    error.  Execution terminated.

     [P_WARN]       A system error occurred. Execution continues.
                    See intro(2) for more information on system



Printed 4/6/89                                                  1

RANLIB(1)               COMMAND REFERENCE               RANLIB(1)



                    errors.

     [P_ERR]        A system error occurred. Execution
                    terminated.  See intro(2) for more
                    information on system errors.

CAVEATS
     Because generation of a library by ar and randomization of
     the library by ranlib are separate processes, phase errors
     are possible. The loader, ld, fails when the modification
     date of a library is more recent than the creation date of
     its dictionary; but this means that it fails even if you
     only copy the library.

SEE ALSO
     ar(1), ld(1), nm(1), and ar(5).







































Printed 4/6/89                                                  2

%%index%%
na:288,97;
sy:385,238;
de:623,949;
op:1572,555;
ex:2127,312;
rv:2439,634;3433,202;
ca:3635,492;
se:4127,176;
%%index%%000000000142