16c43ed60SSameer Arorallvm-libtool-darwin - LLVM tool for creating libraries for Darwin 26c43ed60SSameer Arora================================================================= 36c43ed60SSameer Arora 46c43ed60SSameer Arora.. program:: llvm-libtool-darwin 56c43ed60SSameer Arora 66c43ed60SSameer AroraSYNOPSIS 76c43ed60SSameer Arora-------- 86c43ed60SSameer Arora 96c43ed60SSameer Arora:program:`llvm-libtool-darwin` [*options*] *<input files>* 106c43ed60SSameer Arora 116c43ed60SSameer AroraDESCRIPTION 126c43ed60SSameer Arora----------- 136c43ed60SSameer Arora 146c43ed60SSameer Arora:program:`llvm-libtool-darwin` is a tool for creating static and dynamic 156c43ed60SSameer Aroralibraries for Darwin. 166c43ed60SSameer Arora 176c43ed60SSameer AroraFor most scenarios, it works as a drop-in replacement for cctools' 186c43ed60SSameer Arora:program:`libtool`. 196c43ed60SSameer Arora 206c43ed60SSameer AroraOPTIONS 216c43ed60SSameer Arora-------- 226c43ed60SSameer Arora:program:`llvm-libtool-darwin` supports the following options: 236c43ed60SSameer Arora 24bd2853f7SSameer Arora.. option:: -arch_only <architecture> 25bd2853f7SSameer Arora 26bd2853f7SSameer Arora Build a static library only for the specified `<architecture>` and ignore all 27bd2853f7SSameer Arora other architectures in the files. 28bd2853f7SSameer Arora 29bd2853f7SSameer Arora.. option:: -D 30bd2853f7SSameer Arora 31bd2853f7SSameer Arora Use zero for timestamps and UIDs/GIDs. This is set by default. 32bd2853f7SSameer Arora 33bd2853f7SSameer Arora.. option:: -filelist <listfile[,dirname]> 34bd2853f7SSameer Arora 35bd2853f7SSameer Arora Read input file names from `<listfile>`. File names are specified in `<listfile>` 36bd2853f7SSameer Arora one per line, separated only by newlines. Whitespace on a line is assumed 37bd2853f7SSameer Arora to be part of the filename. If the directory name, `dirname`, is also 38bd2853f7SSameer Arora specified then it is prepended to each file name in the `<listfile>`. 39bd2853f7SSameer Arora 406c43ed60SSameer Arora.. option:: -h, -help 416c43ed60SSameer Arora 426c43ed60SSameer Arora Show help and usage for this command. 436c43ed60SSameer Arora 441aed1e72SSameer Arora.. option:: -l <x> 451aed1e72SSameer Arora 461aed1e72SSameer Arora Searches for the library libx.a in the library search path. If the string `<x>` 471aed1e72SSameer Arora ends with '.o', then the library 'x' is searched for without prepending 'lib' 481aed1e72SSameer Arora or appending '.a'. If the library is found, it is added to the list of input 491aed1e72SSameer Arora files. Otherwise, an error is raised. 501aed1e72SSameer Arora 511aed1e72SSameer Arora.. option:: -L <dir> 521aed1e72SSameer Arora 531aed1e72SSameer Arora Adds `<dir>` to the list of directories in which to search for libraries. The 541aed1e72SSameer Arora directories are searched in the order in which they are specified with 551aed1e72SSameer Arora :option:`-L` and before the default search path. The default search path 561aed1e72SSameer Arora includes directories `/lib`, `/usr/lib` and `/usr/local/lib`. 571aed1e72SSameer Arora 58cdcb60a8SAlexander Shaposhnikov.. option:: -no_warning_for_no_symbols 59cdcb60a8SAlexander Shaposhnikov 60cdcb60a8SAlexander Shaposhnikov Do not warn about files that have no symbols. 61cdcb60a8SAlexander Shaposhnikov 62*4c12a75eSKeith Smiley.. option:: -warnings_as_errors 63*4c12a75eSKeith Smiley 64*4c12a75eSKeith Smiley Produce a non-zero exit status if any warnings are emitted. 65*4c12a75eSKeith Smiley 666c43ed60SSameer Arora.. option:: -o <filename> 676c43ed60SSameer Arora 686c43ed60SSameer Arora Specify the output file name. Must be specified exactly once. 696c43ed60SSameer Arora 70303a7f7aSSameer Arora.. option:: -static 71303a7f7aSSameer Arora 72303a7f7aSSameer Arora Produces a static library from the input files. 73303a7f7aSSameer Arora 74bd2853f7SSameer Arora.. option:: -U 75d9a91929SSameer Arora 76bd2853f7SSameer Arora Use actual timestamps and UIDs/GIDs. 77bd2853f7SSameer Arora 7822cd6beeSShoaib Meenai.. option:: -V 7922cd6beeSShoaib Meenai 8022cd6beeSShoaib Meenai Display the version of this program and perform any operation specified. 8122cd6beeSShoaib Meenai 82bd2853f7SSameer Arora.. option:: -version 83bd2853f7SSameer Arora 8422cd6beeSShoaib Meenai Display the version of this program and exit immediately. 85d9a91929SSameer Arora 866c43ed60SSameer AroraEXIT STATUS 876c43ed60SSameer Arora----------- 886c43ed60SSameer Arora 896c43ed60SSameer Arora:program:`llvm-libtool-darwin` exits with a non-zero exit code if there is an error. 906c43ed60SSameer AroraOtherwise, it exits with code 0. 916c43ed60SSameer Arora 926c43ed60SSameer AroraBUGS 936c43ed60SSameer Arora---- 946c43ed60SSameer Arora 95bbce75e3SChuanqi XuTo report bugs, please visit <https://github.com/llvm/llvm-project/issues/>. 966c43ed60SSameer Arora 976c43ed60SSameer AroraSEE ALSO 986c43ed60SSameer Arora-------- 996c43ed60SSameer Arora 1006c43ed60SSameer Arora:manpage:`llvm-ar(1)` 101