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:: -D 30 31 Use zero for timestamps and UIDs/GIDs. This is set by default. 32 33.. option:: -filelist <listfile[,dirname]> 34 35 Read input file names from `<listfile>`. File names are specified in `<listfile>` 36 one per line, separated only by newlines. Whitespace on a line is assumed 37 to be part of the filename. If the directory name, `dirname`, is also 38 specified then it is prepended to each file name in the `<listfile>`. 39 40.. option:: -h, -help 41 42 Show help and usage for this command. 43 44.. option:: -l <x> 45 46 Searches for the library libx.a in the library search path. If the string `<x>` 47 ends with '.o', then the library 'x' is searched for without prepending 'lib' 48 or appending '.a'. If the library is found, it is added to the list of input 49 files. Otherwise, an error is raised. 50 51.. option:: -L <dir> 52 53 Adds `<dir>` to the list of directories in which to search for libraries. The 54 directories are searched in the order in which they are specified with 55 :option:`-L` and before the default search path. The default search path 56 includes directories `/lib`, `/usr/lib` and `/usr/local/lib`. 57 58.. option:: -no_warning_for_no_symbols 59 60 Do not warn about files that have no symbols. 61 62.. option:: -warnings_as_errors 63 64 Produce a non-zero exit status if any warnings are emitted. 65 66.. option:: -o <filename> 67 68 Specify the output file name. Must be specified exactly once. 69 70.. option:: -static 71 72 Produces a static library from the input files. 73 74.. option:: -U 75 76 Use actual timestamps and UIDs/GIDs. 77 78.. option:: -V 79 80 Display the version of this program and perform any operation specified. 81 82.. option:: -version 83 84 Display the version of this program and exit immediately. 85 86EXIT STATUS 87----------- 88 89:program:`llvm-libtool-darwin` exits with a non-zero exit code if there is an error. 90Otherwise, it exits with code 0. 91 92BUGS 93---- 94 95To report bugs, please visit <https://github.com/llvm/llvm-project/issues/>. 96 97SEE ALSO 98-------- 99 100:manpage:`llvm-ar(1)` 101