LLVM-LIBTOOL-DARWIN(1)

📦
version 20.1.8 · 8 versions
, in fedora 43, fedora 44

💖 LLVM-LIBTOOL-DARWIN 💖

okay bestie, gather round, because this is llvm-libtool-darwin — the LLVM tool for creating libraries for Darwin, and it's lowkey the moment. this is LLVM-LIBTOOL-DARWIN(1), section 1 of the manual, and it's about to be your new hyperfixation. 🦋

✨ SYNOPSIS ✨

llvm-libtool-darwin [options] <input files>

🌸 DESCRIPTION 🌸

so like, llvm-libtool-darwin is a tool for creating static and dynamic libraries for Darwin. that's the whole vibe. 💅

and here's the tea: for most scenarios, it works as a drop-in replacement for cctools' libtool. no cap. just swap it in and go. 🔥

🎀 OPTIONS 🎀

llvm-libtool-darwin supports the following options, and yes we're going through every single one, because details are the whole point:

  • -arch_only <architecture> — build a static library only for the specified <architecture>, and just straight-up ignore all the other architectures chillin' in the files. one arch only, babe. 💅
  • -D — use zero for timestamps and UIDs/GIDs. this one is set by default, so it's already the moment unless you say otherwise. ✨
  • -filelist <listfile[,dirname]> — read the input file names from <listfile>. the file names go in <listfile> one per line, separated only by newlines, okay? so any whitespace on a line? assumed to be part of the filename. yes, literally. and if a directory name, dirname, is also specified, then it gets prepended to each file name in the <listfile>. 💖
  • -h, -help — show help and usage for this command. the classic. 🫶
  • -l <x> — searches for the library libx.a in the library search path. but here's the plot twist: if the string <x> ends with '.o', then the library 'x' is searched for without prepending 'lib' or appending '.a'. and if the library is found, it gets added to the list of input files. if it's not found? an error is raised. no library, no vibes. 😭
  • -L <dir> — adds <dir> to the list of directories in which to search for libraries. the directories get searched in the order in which they are specified with -L, and that happens before the default search path. the default search path includes directories /lib, /usr/lib and /usr/local/lib. 🌈
  • -no_warning_for_no_symbols — do not warn about files that have no symbols. we're keeping it chill about the symbol-less files. 🙈
  • -warnings_as_errors — produce a non-zero exit status if any warnings are emitted. warnings said "main character energy only" and now they're errors. 😤
  • -o <filename> — specify the output file name. must be specified exactly once. not twice, not zero times. exactly once. periodt. 👑
  • -static — produces a static library from the input files. 🎀
  • -U — use actual timestamps and UIDs/GIDs. (this is the opposite of -D, iykyk.) ⭐
  • -V — display the version of this program and perform any operation specified. so it's multitasking. iconic. ✨
  • -version — display the version of this program and exit immediately. no further operations, we're out. 💨

💀 EXIT STATUS 💀

llvm-libtool-darwin exits with a non-zero exit code if there is an error. otherwise? it exits with code 0. so a 0 is the slay outcome, bestie. ✅

🐛 BUGS 🐛

to report bugs, please visit <https://github.com/llvm/llvm-project/issues/>. tell them everything. they wanna know. 🫶

👀 SEE ALSO 👀

  • llvm-ar(1) — the sibling, the bestie, the other one in the group chat. 💜

🧚 AUTHOR 🧚

maintained by the LLVM Team (https://llvm.org/). they're the ones keeping this whole thing alive fr fr. 🔥

2003-2025, LLVM Project — that's the whole run, twenty-plus years of service. respect. 👑

and that's the page!! mwah 💋 this was LLVM-LIBTOOL-DARWIN(1) from LLVM, dated 2025-09-03, page 20 — ty for reading my little infodump, go build something iconic with it bestie 🎀💖✨

📦 where this page comes from