xref: /freebsd/contrib/elftoolchain/ar/ranlib.1 (revision ae500c1ff8974130f7f2692772cf288b90349e0d)
13fe401a5SEd Maste.\" Copyright (c) 2007,2009-2012 Joseph Koshy.  All rights reserved.
23fe401a5SEd Maste.\"
33fe401a5SEd Maste.\" Redistribution and use in source and binary forms, with or without
43fe401a5SEd Maste.\" modification, are permitted provided that the following conditions
53fe401a5SEd Maste.\" are met:
63fe401a5SEd Maste.\" 1. Redistributions of source code must retain the above copyright
73fe401a5SEd Maste.\"    notice, this list of conditions and the following disclaimer.
83fe401a5SEd Maste.\" 2. Redistributions in binary form must reproduce the above copyright
93fe401a5SEd Maste.\"    notice, this list of conditions and the following disclaimer in the
103fe401a5SEd Maste.\"    documentation and/or other materials provided with the distribution.
113fe401a5SEd Maste.\"
123fe401a5SEd Maste.\" This software is provided by Joseph Koshy ``as is'' and
133fe401a5SEd Maste.\" any express or implied warranties, including, but not limited to, the
143fe401a5SEd Maste.\" implied warranties of merchantability and fitness for a particular purpose
153fe401a5SEd Maste.\" are disclaimed.  in no event shall Joseph Koshy be liable
163fe401a5SEd Maste.\" for any direct, indirect, incidental, special, exemplary, or consequential
173fe401a5SEd Maste.\" damages (including, but not limited to, procurement of substitute goods
183fe401a5SEd Maste.\" or services; loss of use, data, or profits; or business interruption)
193fe401a5SEd Maste.\" however caused and on any theory of liability, whether in contract, strict
203fe401a5SEd Maste.\" liability, or tort (including negligence or otherwise) arising in any way
213fe401a5SEd Maste.\" out of the use of this software, even if advised of the possibility of
223fe401a5SEd Maste.\" such damage.
233fe401a5SEd Maste.\"
24*ae500c1fSEd Maste.\" $Id: ranlib.1 3642 2018-10-14 14:24:28Z jkoshy $
253fe401a5SEd Maste.\"
263fe401a5SEd Maste.Dd December 9, 2012
273fe401a5SEd Maste.Dt RANLIB 1
28*ae500c1fSEd Maste.Os
293fe401a5SEd Maste.Sh NAME
303fe401a5SEd Maste.Nm ranlib
313fe401a5SEd Maste.Nd update archive symbol tables
323fe401a5SEd Maste.Sh SYNOPSIS
333fe401a5SEd Maste.Nm
343fe401a5SEd Maste.Op Fl D
353fe401a5SEd Maste.Op Fl t
363fe401a5SEd Maste.Ar archive Ns ...
373fe401a5SEd Maste.Nm
383fe401a5SEd Maste.Fl V
393fe401a5SEd Maste.Sh DESCRIPTION
403fe401a5SEd MasteThe
413fe401a5SEd Maste.Nm ranlib
423fe401a5SEd Masteutility is used to update an existing archive symbol table in an
433fe401a5SEd Maste.Xr ar 1
443fe401a5SEd Mastearchive, or to add an archive symbol table to an archive lacking one.
453fe401a5SEd Maste.Sh OPTIONS
463fe401a5SEd MasteThe
473fe401a5SEd Maste.Nm
483fe401a5SEd Masteutility supports the following options:
493fe401a5SEd Maste.Bl -tag -width indent
503fe401a5SEd Maste.It Fl D
513fe401a5SEd MasteUse zeros for the mtime, uid and gid fields, and use mode 0644 for the
523fe401a5SEd Mastefile mode field for all archive member headers.
533fe401a5SEd MasteThis ensures that checksums on the resulting archives are reproducible
543fe401a5SEd Mastewhen member contents are identical.
553fe401a5SEd Maste.It Fl t
563fe401a5SEd MasteThis option is accepted, but is ignored.
573fe401a5SEd Maste.It Fl V
583fe401a5SEd MastePrint a version identifier and exit.
593fe401a5SEd Maste.El
603fe401a5SEd Maste.Sh EXAMPLES
613fe401a5SEd MasteTo update the archive symbol table for an archive
623fe401a5SEd Maste.Pa lib.a ,
633fe401a5SEd Masteuse:
643fe401a5SEd Maste.Dl "ranlib lib.a"
653fe401a5SEd Maste.Sh DIAGNOSTICS
663fe401a5SEd Maste.Ex -std
673fe401a5SEd Maste.Sh SEE ALSO
683fe401a5SEd Maste.Xr ar 1 ,
693fe401a5SEd Maste.Xr ld 1 ,
703fe401a5SEd Maste.Xr archive 3 ,
713fe401a5SEd Maste.Xr elf 3 ,
723fe401a5SEd Maste.Xr ar 5
733fe401a5SEd Maste.Sh HISTORY
743fe401a5SEd MasteThe
753fe401a5SEd Maste.Nm
763fe401a5SEd Mastecommand first appeared in AT&T UNIX Version 7.
773fe401a5SEd Maste.Pp
783fe401a5SEd MasteIn
793fe401a5SEd Maste.Fx 8.0 ,
803fe401a5SEd Maste.An Kai Wang Aq Mt kaiw@FreeBSD.org
813fe401a5SEd Mastereimplemented
823fe401a5SEd Maste.Nm
833fe401a5SEd Masteusing the
843fe401a5SEd Maste.Lb libarchive
853fe401a5SEd Masteand the
863fe401a5SEd Maste.Lb libelf .
87