1.\" Copyright (c) 2007,2009-2012 Joseph Koshy. All rights reserved. 2.\" 3.\" Redistribution and use in source and binary forms, with or without 4.\" modification, are permitted provided that the following conditions 5.\" are met: 6.\" 1. Redistributions of source code must retain the above copyright 7.\" notice, this list of conditions and the following disclaimer. 8.\" 2. Redistributions in binary form must reproduce the above copyright 9.\" notice, this list of conditions and the following disclaimer in the 10.\" documentation and/or other materials provided with the distribution. 11.\" 12.\" This software is provided by Joseph Koshy ``as is'' and 13.\" any express or implied warranties, including, but not limited to, the 14.\" implied warranties of merchantability and fitness for a particular purpose 15.\" are disclaimed. in no event shall Joseph Koshy be liable 16.\" for any direct, indirect, incidental, special, exemplary, or consequential 17.\" damages (including, but not limited to, procurement of substitute goods 18.\" or services; loss of use, data, or profits; or business interruption) 19.\" however caused and on any theory of liability, whether in contract, strict 20.\" liability, or tort (including negligence or otherwise) arising in any way 21.\" out of the use of this software, even if advised of the possibility of 22.\" such damage. 23.\" 24.\" $Id: ranlib.1 3642 2018-10-14 14:24:28Z jkoshy $ 25.\" 26.Dd December 9, 2012 27.Dt RANLIB 1 28.Os 29.Sh NAME 30.Nm ranlib 31.Nd update archive symbol tables 32.Sh SYNOPSIS 33.Nm 34.Op Fl D 35.Op Fl t 36.Ar archive Ns ... 37.Nm 38.Fl V 39.Sh DESCRIPTION 40The 41.Nm ranlib 42utility is used to update an existing archive symbol table in an 43.Xr ar 1 44archive, or to add an archive symbol table to an archive lacking one. 45.Sh OPTIONS 46The 47.Nm 48utility supports the following options: 49.Bl -tag -width indent 50.It Fl D 51Use zeros for the mtime, uid and gid fields, and use mode 0644 for the 52file mode field for all archive member headers. 53This ensures that checksums on the resulting archives are reproducible 54when member contents are identical. 55.It Fl t 56This option is accepted, but is ignored. 57.It Fl V 58Print a version identifier and exit. 59.El 60.Sh EXAMPLES 61To update the archive symbol table for an archive 62.Pa lib.a , 63use: 64.Dl "ranlib lib.a" 65.Sh DIAGNOSTICS 66.Ex -std 67.Sh SEE ALSO 68.Xr ar 1 , 69.Xr ld 1 , 70.Xr archive 3 , 71.Xr elf 3 , 72.Xr ar 5 73.Sh HISTORY 74The 75.Nm 76command first appeared in AT&T UNIX Version 7. 77.Pp 78In 79.Fx 8.0 , 80.An Kai Wang Aq Mt kaiw@FreeBSD.org 81reimplemented 82.Nm 83using the 84.Lb libarchive 85and the 86.Lb libelf . 87