LLVM-LIBTOOL-DARWIN(1)

💅 LLVM-LIBTOOL-DARWIN — the manual page, but make it make sense ✨

okay so bestie, welcome to the glow-up of the LLVM-LIBTOOL-DARWIN(1) page 💖 this is the LLVM manual, and it's literally about a tool that builds libraries for Darwin, so let's get into it 🎀

---

🌸 NAME 🌸

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

---

✨ SYNOPSIS ✨

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

you give it options, you give it input files, she gives you a library. iconic behavior 👑

---

💜 DESCRIPTION 💜

llvm-libtool-darwin is a tool for creating static and dynamic libraries for Darwin. no cap, that's her whole job 💅

and for most scenarios, she works as a drop-in replacement for cctools' libtool. so if you're migrating, she's lowkey a plug-and-play queen 🫶

---

🎀 OPTIONS 🎀

llvm-libtool-darwin supports the following options, and yes we're listing every single one because we don't skip 💖

• -arch_only <architecture> — build a static library only for the specified <architecture> and ignore all the other architectures hanging out in the files. she's focused, she's selective, she's not entertaining the rest 🙈
• -color — use colors in output 🌈 because plain text is giving sad beige energy
• -D — use zero for timestamps and UIDs/GIDs. this one is set by default, so she's already doing it bestie ✨
• -filelist <listfile[,dirname]> — read input file names from <listfile>. file names are specified in <listfile> one per line, separated only by newlines — so any whitespace on a line is assumed to be part of the filename, fr fr, do not add spaces 🙅‍♀️. and if the 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 🫶
• -help-list — show help and usage for this command without grouping the options into categories. the raw, unfiltered list, iykyk 💀
• -l <x> — searches for the library libx.a in the library search path. 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's added to the list of input files. otherwise, an error is raised — she does not do silent failure, bestie 😭
• -L <dir> — adds <dir> to the list of directories to search for libraries. directories are searched in the order in which they are specified with -L, and before the default search path. the default search path includes the directories /lib, /usr/lib and /usr/local/lib 🌸
• -no_warning_for_no_symbols — do not warn about files that have no symbols 🤐
• -warnings_as_errors — produce a non-zero exit status if any warnings are emitted. warnings get promoted to full-blown errors, she's strict like that 💀
• -o <filename> — specify the output file name. must be specified exactly once — once, bestie, not twice, not zero times 🙏
• -static — produces a static library from the input files 🎀
• -U — use actual timestamps and UIDs/GIDs (the opposite energy of -D ⭐)
• -V — display the version of this program and perform any operation specified — so she multitask-slays 💅
• -version — display the version of this program and exit immediately — she's out, periodt 🦋

---

🔥 EXIT STATUS 🔥

llvm-libtool-darwin exits with a non-zero exit code if there is an error. otherwise, she exits with code 0 ✨ simple as that 🫶

---

💀 BUGS 💀

to report bugs, please visit <https://github.com/llvm/llvm-project/issues/> — the link in the original page is hyphenated across lines, so just know it's that URL 🐛

---

🌈 SEE ALSO 🌈

llvm-ar(1) — go read that one too, bestie 👑

---

👑 AUTHOR 👑

maintained by the LLVM Team (https://llvm.org/) 💜 they're the main characters here, honestly.

---

🎀 COPYRIGHT 🎀

2003-2023, LLVM Project 🌸

---

and that's the whole page, bestie 💖 this manual is version 15 from 2023-07-14, brought to you by the LLVM girlies — now go build some libraries and slay ✨🦋🎀