LLVM-LIBTOOL-DARWIN(1)

📦
version 23.1.4 · 9 versions
, in arch rolling

💅 LLVM-LIBTOOL-DARWIN(1) — the manual page, but make it make sense

okay bestie, so this is the LLVM-LIBTOOL-DARWIN page from the LLVM manual set. Yes the title's right there in the name and then again in the header, we love a redundant queen. Anyway. Sit down, grab a strawberry 🍓, and let's get into it.

✨ NAME ✨

llvm-libtool-darwin — the LLVM tool for creating libraries for Darwin. that's it, that's the whole vibe check. 🎀

✨ SYNOPSIS ✨

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

you give it options, you give it input files, it does library things. iconic behavior honestly.

✨ DESCRIPTION ✨

So llvm-libtool-darwin is literally a tool for creating static and dynamic libraries for Darwin. building archives, making libraries, the whole main character energy. 👑

And here's the slay part: for most scenarios, it works as a drop-in replacement for cctools' libtool. like, you can just swap it in and nobody has to know. no cap. 🦋

✨ OPTIONS ✨

llvm-libtool-darwin supports the following options, and yes, we're going through every single one, because I would never do you dirty like that:

  • -arch_only <architecture> — builds a static library only for the <architecture> you specify and just straight-up ignores all the other architectures hanging out in the files. other archs? not invited to the party. 🙈
  • -D — uses zero for timestamps and UIDs/GIDs. and plot twist: this one is set by default, so it's already happening whether you asked or not. 💅
  • -filelist <listfile[,dirname]> — reads the input file names from <listfile>. the file names go in <listfile> one per line, separated only by newlines — and listen, whitespace on a line is assumed to be part of the filename, so don't go adding cute little spaces. if a directory name, dirname, is also specified, it gets prepended to each file name in the <listfile>. 🧚
  • -h, -help — shows help and usage for this command. the classic "help me help you" moment.
  • -l <x> — searches for the library libx.a in the library search path. and here's the nuance bestie: if the string <x> ends with .o, then the library x is searched for without prepending lib or appending .a. if the library is found, it gets added to the list of input files. otherwise? an error is raised. it's giving consequences. 😭
  • -L <dir> — adds <dir> to the list of directories to search for libraries. directories get searched in the order you specified them with -L, and before the default search path. that default search path is /lib, /usr/lib and /usr/local/lib. so like, your dirs cut the line. 🔥
  • -no_warning_for_no_symbols — do not warn about files that have no symbols. sometimes a file is just a little empty and we don't need to be rude about it. 🫶
  • -warnings_as_errors — produces a non-zero exit status if any warnings are emitted. warnings are now errors, strict queen behavior only. 💀
  • -o <filename> — specify the output file name. and this one must be specified exactly once. exactly once. not zero, not twice. periodt. 🌸
  • -static — produces a static library from the input files. static era. ⭐
  • -U — uses actual timestamps and UIDs/GIDs. unlike -D, this one is not doing the zero thing, it's keeping it real.
  • -V — displays the version of this program and performs any operation specified. like, it multi-tasks.
  • -version — displays the version of this program and exits immediately. no operations, no extra steps, just version and gone. bye. 👋

✨ EXIT STATUS ✨

llvm-libtool-darwin exits with a non-zero exit code if there's an error. otherwise? it exits with code 0. clean, simple, no drama. ✅

✨ BUGS ✨

to report bugs, please visit <https://github.com/llvm/llvm-project/issues/>. the link is right there, go tell them everything. 🐛

✨ SEE ALSO ✨

  • llvm-ar(1) <llvm-ar.html> — the sibling, the other archive icon, the one you should also know about. iykyk. 💜

✨ Author ✨

maintained by the LLVM Team (https://llvm.org/). they're the ones keeping this whole thing alive, show some love. 🌈

2003-2026, LLVM Project. all rights reserved, all vibes preserved. 🎀

and that's the page!! mwah 💋 — this gorgeous little document comes to you courtesy of LLVM, version 23, dated 2026-10-20. go build something iconic with it. 🦋✨

📦 where this page comes from