.\" Copyright (c) 1990 Regents of the University of California.
.\" All rights reserved.
.\"
.\" %sccs.include.redist.man%
.\"
.\"     @(#)ranlib.1	6.6 (Berkeley) 03/14/91
.\"
.Vx
.Vx
.Dd 
.Dt RANLIB 1
.BSD 4.4
.Sh NAME
.Nm ranlib
.Nd table-of-contents for archive libraries
.Sh SYNOPSIS
.Nm ranlib
.Op Fl t
.Ar file ...
.Sh DESCRIPTION
.Nm Ranlib
creates a table of external references for archive libraries,
normally used by the loader,
.Xr ld 1 .
This table is is named ``__.SYMDEF'' and is prepended to the archive.
Files in the archive which are not executable and symbols which are
uninteresting to the loader are ignored.
.Pp
The options are as follows:
.Tw 8n
.Tp Fl t
Set the modification time of the __.SYMDEF file.
This time is compared by the loader with the modification time of the
archive to verify that the table is up-to-date with respect to the
archive.
If the modification time has been changed without any change to the
archive (for example, by a
.Xr cp 1 ) ,
the
.Fl t
option can be used to ``touch'' the modification time so that it
appears that the table is up-to-date.
This is also useful after using the
.Fl t
option of
.Xr make 1 .
.Tp
.Sh FILES
/tmp/ranlib.XXXXXX	temporary file names
.Sh SEE ALSO
.Xr ar 1 ,
.Xr ld 1 ,
.Xr lorder 1 ,
.Xr nm 1 ,
.Xr ranlib 5
.Sh HISTORY
.Nm Ranlib
appeared in Version 7 AT&T UNIX.