RANLIB(1)               COMMAND REFERENCE               RANLIB(1)



NAME
     ranlib - convert archives to random libraries

SYNOPSIS
     ranlib archive ...

DESCRIPTION
     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.
     Ranlib uses ar(1) to reconstruct the archive, so that
     sufficient temporary file space must be available in the
     file system which contains the current directory.

     Ranlib works on both long and short format archive files.

     Ranlib is automatically executed by ar when the contents of
     an archive are modified.

EXAMPLES
     A typical invocation on the archive file arch follows:



          ranlib 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
                    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



Printed 10/17/86                                                1

RANLIB(1)               COMMAND REFERENCE               RANLIB(1)



     its dictionary; but this means that it fails even if you
     only copy the library.

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


















































Printed 10/17/86                                                2

%%index%%
na:72,81;
sy:153,132;
de:285,830;
ex:1115,152;
rv:1267,792;
ca:2059,365;2568,91;
se:2659,155;
%%index%%000000000127