llvm/docs/CommandGuide/llvm-libtool-darwin.rst

   1 llvm-libtool-darwin - LLVM tool for creating libraries for Darwin
   2 =================================================================
   3
   4 .. program:: llvm-libtool-darwin
   5
   6 SYNOPSIS
   7 --------
   8
   9 :program:`llvm-libtool-darwin` [*options*] *<input files>*
  10
  11 DESCRIPTION
  12 -----------
  13
  14 :program:`llvm-libtool-darwin` is a tool for creating static and dynamic
  15 libraries for Darwin.
  16
  17 For most scenarios, it works as a drop-in replacement for cctools'
  18 :program:`libtool`.
  19
  20 OPTIONS
  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
  91 EXIT STATUS
  92 -----------
  93
  94 :program:`llvm-libtool-darwin` exits with a non-zero exit code if there is an error.
  95 Otherwise, it exits with code 0.
  96
  97 BUGS
  98 ----
  99
 100 To report bugs, please visit <https://bugs.llvm.org/>.
 101
 102 SEE ALSO
 103 --------
 104
 105 :manpage:`llvm-ar(1)`