[unix-history] / usr / man / man1 / ranlib.1

.TH RANLIB 1 "8 February 1983"
.SH NAME
ranlib \- convert archives to random libraries
.SH SYNOPSIS
.B ranlib
archive ...
.SH DESCRIPTION
.I Ranlib
converts each
.I archive
to a form which the loader can load more rapidly.
.I Ranlib
does this by adding a table of contents called 
.B _.SYMDEF
to the beginning of the archive.
.I Ranlib
uses 
.IR ar (1)
to reconstruct the archive, so that sufficient temporary file space must
be available in the file system which contains the current directory.
.SH "SEE ALSO"
ld(1), ar(1), lorder(1)
.SH BUGS
Because generation of a library by
.I ar
and randomization of the library by
.I ranlib
are separate processes, phase errors are possible.  The loader,
.IR ld ,
warns when the modification date of a library is more recent than the
creation date of its dictionary;  but this means that you get the
warning even if you only copy the library.
Commit	Line	Data
d8649de5 C	1	.TH RANLIB 1 "8 February 1983"
	2	.SH NAME
	3	ranlib \- convert archives to random libraries
	4	.SH SYNOPSIS
	5	.B ranlib
	6	archive ...
	7	.SH DESCRIPTION
	8	.I Ranlib
	9	converts each
	10	.I archive
	11	to a form which the loader can load more rapidly.
	12	.I Ranlib
	13	does this by adding a table of contents called
	14	.B _.SYMDEF
	15	to the beginning of the archive.
	16	.I Ranlib
	17	uses
	18	.IR ar (1)
	19	to reconstruct the archive, so that sufficient temporary file space must
	20	be available in the file system which contains the current directory.
	21	.SH "SEE ALSO"
	22	ld(1), ar(1), lorder(1)
	23	.SH BUGS
	24	Because generation of a library by
	25	.I ar
	26	and randomization of the library by
	27	.I ranlib
	28	are separate processes, phase errors are possible. The loader,
	29	.IR ld ,
	30	warns when the modification date of a library is more recent than the
	31	creation date of its dictionary; but this means that you get the
	32	warning even if you only copy the library.