diff options
Diffstat (limited to 'upstream/fedora-40/man1/ranlib.1')
-rw-r--r-- | upstream/fedora-40/man1/ranlib.1 | 149 |
1 files changed, 149 insertions, 0 deletions
diff --git a/upstream/fedora-40/man1/ranlib.1 b/upstream/fedora-40/man1/ranlib.1 new file mode 100644 index 00000000..6ca31739 --- /dev/null +++ b/upstream/fedora-40/man1/ranlib.1 @@ -0,0 +1,149 @@ +.\" -*- mode: troff; coding: utf-8 -*- +.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.45) +.\" +.\" Standard preamble: +.\" ======================================================================== +.de Sp \" Vertical space (when we can't use .PP) +.if t .sp .5v +.if n .sp +.. +.de Vb \" Begin verbatim text +.ft CW +.nf +.ne \\$1 +.. +.de Ve \" End verbatim text +.ft R +.fi +.. +.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. +.ie n \{\ +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds C` +. ds C' +'br\} +.\" +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" +.\" If the F register is >0, we'll generate index entries on stderr for +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index +.\" entries marked with X<> in POD. Of course, you'll have to process the +.\" output yourself in some meaningful fashion. +.\" +.\" Avoid warning from groff about undefined register 'F'. +.de IX +.. +.nr rF 0 +.if \n(.g .if rF .nr rF 1 +.if (\n(rF:(\n(.g==0)) \{\ +. if \nF \{\ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" +.. +. if !\nF==2 \{\ +. nr % 0 +. nr F 2 +. \} +. \} +.\} +.rr rF +.\" ======================================================================== +.\" +.IX Title "RANLIB 1" +.TH RANLIB 1 2024-02-12 binutils-2.41 "GNU Development Tools" +.\" For nroff, turn off justification. Always turn off hyphenation; it makes +.\" way too many mistakes in technical documents. +.if n .ad l +.nh +.SH NAME +ranlib \- generate an index to an archive +.SH SYNOPSIS +.IX Header "SYNOPSIS" +ranlib [\fB\-\-plugin\fR \fIname\fR] [\fB\-DhHvVt\fR] \fIarchive\fR +.SH DESCRIPTION +.IX Header "DESCRIPTION" +\&\fBranlib\fR generates an index to the contents of an archive and +stores it in the archive. The index lists each symbol defined by a +member of an archive that is a relocatable object file. +.PP +You may use \fBnm \-s\fR or \fBnm \-\-print\-armap\fR to list this index. +.PP +An archive with such an index speeds up linking to the library and +allows routines in the library to call each other without regard to +their placement in the archive. +.PP +The GNU \fBranlib\fR program is another form of GNU \fBar\fR; running +\&\fBranlib\fR is completely equivalent to executing \fBar \-s\fR. +.SH OPTIONS +.IX Header "OPTIONS" +.IP \fB\-h\fR 4 +.IX Item "-h" +.PD 0 +.IP \fB\-H\fR 4 +.IX Item "-H" +.IP \fB\-\-help\fR 4 +.IX Item "--help" +.PD +Show usage information for \fBranlib\fR. +.IP \fB\-v\fR 4 +.IX Item "-v" +.PD 0 +.IP \fB\-V\fR 4 +.IX Item "-V" +.IP \fB\-\-version\fR 4 +.IX Item "--version" +.PD +Show the version number of \fBranlib\fR. +.IP \fB\-D\fR 4 +.IX Item "-D" +Operate in \fIdeterministic\fR mode. The symbol map archive member's +header will show zero for the UID, GID, and timestamp. When this +option is used, multiple runs will produce identical output files. +.Sp +If \fIbinutils\fR was configured with +\&\fB\-\-enable\-deterministic\-archives\fR, then this mode is on by +default. It can be disabled with the \fB\-U\fR option, described +below. +.IP \fB\-t\fR 4 +.IX Item "-t" +Update the timestamp of the symbol map of an archive. +.IP \fB\-U\fR 4 +.IX Item "-U" +Do \fInot\fR operate in \fIdeterministic\fR mode. This is the +inverse of the \fB\-D\fR option, above: the archive index will get +actual UID, GID, timestamp, and file mode values. +.Sp +If \fIbinutils\fR was configured \fIwithout\fR +\&\fB\-\-enable\-deterministic\-archives\fR, then this mode is on by +default. +.IP \fB@\fR\fIfile\fR 4 +.IX Item "@file" +Read command-line options from \fIfile\fR. The options read are +inserted in place of the original @\fIfile\fR option. If \fIfile\fR +does not exist, or cannot be read, then the option will be treated +literally, and not removed. +.Sp +Options in \fIfile\fR are separated by whitespace. A whitespace +character may be included in an option by surrounding the entire +option in either single or double quotes. Any character (including a +backslash) may be included by prefixing the character to be included +with a backslash. The \fIfile\fR may itself contain additional +@\fIfile\fR options; any such options will be processed recursively. +.SH "SEE ALSO" +.IX Header "SEE ALSO" +\&\fBar\fR\|(1), \fBnm\fR\|(1), and the Info entries for \fIbinutils\fR. +.SH COPYRIGHT +.IX Header "COPYRIGHT" +Copyright (c) 1991\-2023 Free Software Foundation, Inc. +.PP +Permission is granted to copy, distribute and/or modify this document +under the terms of the GNU Free Documentation License, Version 1.3 +or any later version published by the Free Software Foundation; +with no Invariant Sections, with no Front-Cover Texts, and with no +Back-Cover Texts. A copy of the license is included in the +section entitled "GNU Free Documentation License". |