summaryrefslogtreecommitdiff
path: root/docs/CommandGuide/llvm-ranlib.rst
blob: 6658818f41e5683be55b1a6d787c7c26fcdaf816 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
llvm-ranlib - Generate index for LLVM archive
=============================================


SYNOPSIS
--------


**llvm-ranlib** [--version] [-help] <archive-file>


DESCRIPTION
-----------


The **llvm-ranlib** command is similar to the common Unix utility, ``ranlib``. It
adds or updates the symbol table in an LLVM archive file. Note that using the
**llvm-ar** modifier *s* is usually more efficient than running **llvm-ranlib**
which is only provided only for completness and compatibility. Unlike other
implementations of ``ranlib``, **llvm-ranlib** indexes LLVM bitcode files, not
native object modules. You can list the contents of the symbol table with the
``llvm-nm -s`` command.


OPTIONS
-------



*archive-file*

 Specifies the archive-file to which the symbol table is added or updated.



*--version*

 Print the version of **llvm-ranlib** and exit without building a symbol table.



*-help*

 Print usage help for **llvm-ranlib** and exit without building a symbol table.




EXIT STATUS
-----------


If **llvm-ranlib** succeeds, it will exit with 0.  If an error occurs, a non-zero
exit code will be returned.


SEE ALSO
--------


llvm-ar|llvm-ar, ranlib(1)