Update the gcov version used slightly, to make it stop causing modern gcov's to
[llvm/stm8.git] / docs / CommandGuide / llvm-ranlib.pod
blob431bc551048a222b723898b9e19d1351f223d805
1 =pod
3 =head1 NAME
5 llvm-ranlib - Generate index for LLVM archive
7 =head1 SYNOPSIS
9 B<llvm-ranlib> [--version] [-help] <archive-file>
11 =head1 DESCRIPTION
13 The B<llvm-ranlib> command is similar to the common Unix utility, C<ranlib>. It
14 adds or updates the symbol table in an LLVM archive file. Note that using the
15 B<llvm-ar> modifier F<s> is usually more efficient than running B<llvm-ranlib>
16 which is only provided only for completness and compatibility. Unlike other 
17 implementations of C<ranlib>, B<llvm-ranlib> indexes LLVM bitcode files, not
18 native object modules. You can list the contents of the symbol table with the
19 C<llvm-nm -s> command.
21 =head1 OPTIONS
23 =over
25 =item F<archive-file>
27 Specifies the archive-file to which the symbol table is added or updated.
29 =item F<--version>
31 Print the version of B<llvm-ranlib> and exit without building a symbol table.
33 =item F<-help>
35 Print usage help for B<llvm-ranlib> and exit without building a symbol table.
37 =back
39 =head1 EXIT STATUS
41 If B<llvm-ranlib> succeeds, it will exit with 0.  If an error occurs, a non-zero
42 exit code will be returned.
44 =head1 SEE ALSO
46 L<llvm-ar|llvm-ar>, ranlib(1)
48 =head1 AUTHORS
50 Maintained by the LLVM Team (L<http://llvm.org/>).
52 =cut