1.\" Copyright (c) 1990 Regents of the University of California. 2.\" All rights reserved. 3.\" 4.\" %sccs.include.redist.man% 5.\" 6.\" @(#)ranlib.1 6.5 (Berkeley) 01/18/91 7.\" 8.Dd 9.Dt RANLIB 1 10.BSD 4.4 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.Tw 8n 29.Tp 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.Tp 46.Sh FILES 47/tmp/ranlib.XXXXXX temporary file names 48.Sh SEE ALSO 49.Xr ar 1 , 50.Xr ld 1 , 51.Xr lorder 1 , 52.Xr nm 1 , 53.Xr ranlib 5 54.Sh HISTORY 55.Nm Ranlib 56appeared in Version 7 AT&T UNIX. 57