1.\" Copyright (c) 1990, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" %sccs.include.redist.roff% 5.\" 6.\" @(#)ranlib.1 8.1 (Berkeley) 06/06/93 7.\" 8.Dd 9.Dt RANLIB 1 10.Os 11.Sh NAME 12.Nm ranlib 13.Nd table-of-contents for archive libraries 14.Sh SYNOPSIS 15.Nm ranlib 16.Op Fl t 17.Ar file ... 18.Sh DESCRIPTION 19.Nm Ranlib 20creates a table of external references for archive libraries, 21normally used by the loader, 22.Xr ld 1 . 23This table is is named ``__.SYMDEF'' and is prepended to the archive. 24Files in the archive which are not executable and symbols which are 25uninteresting to the loader are ignored. 26.Pp 27The options are as follows: 28.Bl -tag -width indent 29.It Fl t 30Set the modification time of the __.SYMDEF file. 31This time is compared by the loader with the modification time of the 32archive to verify that the table is up-to-date with respect to the 33archive. 34If the modification time has been changed without any change to the 35archive (for example, by a 36.Xr cp 1 ) , 37the 38.Fl t 39option can be used to ``touch'' the modification time so that it 40appears that the table is up-to-date. 41This is also useful after using the 42.Fl t 43option of 44.Xr make 1 . 45.El 46.Sh FILES 47.Bl -tag -width /tmp/ranlib.XXXXXX -compact 48.It Pa /tmp/ranlib.XXXXXX 49Temporary file names. 50.El 51.Sh SEE ALSO 52.Xr ar 1 , 53.Xr ld 1 , 54.Xr lorder 1 , 55.Xr nm 1 , 56.Xr ranlib 5 57.Sh HISTORY 58A 59.Nm ranlib 60command appeared in 61.At v7 . 62