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

.TH RANLIB 1
.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 can be loaded
more rapidly by the loader,
by adding a table of contents named
.B _\^_.SYMDEF
to the beginning of the archive.
It uses
.IR ar (1)
to reconstruct the archive,
so that sufficient temporary file space must
be available in the file system containing the
current directory.
.SH SEE ALSO
ld(1), ar(1), lorder(1)
.SH BUGS
Because generation of a library by
.I ar
and randomization by
.I ranlib
are separate,
phase errors are possible.
The loader
.I 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.
Commit	Line	Data
e3758c96 C	1	.TH RANLIB 1
	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 can be loaded
	12	more rapidly by the loader,
	13	by adding a table of contents named
	14	.B _\^_.SYMDEF
	15	to the beginning of the archive.
	16	It uses
	17	.IR ar (1)
	18	to reconstruct the archive,
	19	so that sufficient temporary file space must
	20	be available in the file system containing the
	21	current directory.
	22	.SH SEE ALSO
	23	ld(1), ar(1), lorder(1)
	24	.SH BUGS
	25	Because generation of a library by
	26	.I ar
	27	and randomization by
	28	.I ranlib
	29	are separate,
	30	phase errors are possible.
	31	The loader
	32	.I ld
	33	warns when the modification date of
	34	a library is more recent than
	35	the creation of its dictionary;
	36	but this means you get the warning even if you
	37	only copy the library.