1llvm-libtool-darwin - LLVM tool for creating libraries for Darwin
2=================================================================
3
4.. program:: llvm-libtool-darwin
5
6SYNOPSIS
7--------
8
9:program:`llvm-libtool-darwin` [*options*] *<input files>*
10
11DESCRIPTION
12-----------
13
14:program:`llvm-libtool-darwin` is a tool for creating static and dynamic
15libraries for Darwin.
16
17For most scenarios, it works as a drop-in replacement for cctools'
18:program:`libtool`.
19
20OPTIONS
21--------
22:program:`llvm-libtool-darwin` supports the following options:
23
24.. option:: -arch_only <architecture>
25
26  Build a static library only for the specified `<architecture>` and ignore all
27  other architectures in the files.
28
29.. option:: -color
30
31  Use colors in output.
32
33.. option:: -D
34
35  Use zero for timestamps and UIDs/GIDs. This is set by default.
36
37.. option:: -filelist <listfile[,dirname]>
38
39  Read input file names from `<listfile>`. File names are specified in `<listfile>`
40  one per line, separated only by newlines. Whitespace on a line is assumed
41  to be part of the filename. If the directory name, `dirname`, is also
42  specified then it is prepended to each file name in the `<listfile>`.
43
44.. option:: -h, -help
45
46  Show help and usage for this command.
47
48.. option:: -help-list
49
50  Show help and usage for this command without grouping the options
51  into categories.
52
53.. option:: -l <x>
54
55  Searches for the library libx.a in the library search path. If the string `<x>`
56  ends with '.o', then the library 'x' is searched for without prepending 'lib'
57  or appending '.a'. If the library is found, it is added to the list of input
58  files. Otherwise, an error is raised.
59
60.. option:: -L <dir>
61
62  Adds `<dir>` to the list of directories in which to search for libraries. The
63  directories are searched in the order in which they are specified with
64  :option:`-L` and before the default search path. The default search path
65  includes directories `/lib`, `/usr/lib` and `/usr/local/lib`.
66
67.. option:: -no_warning_for_no_symbols
68
69   Do not warn about files that have no symbols.
70
71.. option:: -o <filename>
72
73  Specify the output file name. Must be specified exactly once.
74
75.. option:: -static
76
77  Produces a static library from the input files.
78
79.. option:: -U
80
81  Use actual timestamps and UIDs/GIDs.
82
83.. option:: -V
84
85  Display the version of this program and perform any operation specified.
86
87.. option:: -version
88
89  Display the version of this program and exit immediately.
90
91EXIT STATUS
92-----------
93
94:program:`llvm-libtool-darwin` exits with a non-zero exit code if there is an error.
95Otherwise, it exits with code 0.
96
97BUGS
98----
99
100To report bugs, please visit <https://github.com/llvm/llvm-project/issues/>.
101
102SEE ALSO
103--------
104
105:manpage:`llvm-ar(1)`
106