LLVM-INSTALL-NAME-TOOL(1)

💅 LLVM-INSTALL-NAME-TOOL(1) — the LLVM manual, bestie edition 🎀

okay so real talk: this is the man page for llvm-install-name-tool, a tool from LLVM, and I'm gonna walk you through it like we're texting at 2am. no cap, it's actually not that deep once you get the vibe. 🦋

---

✨ NAME ✨

llvm-install-name-tool — the LLVM tool for manipulating install-names and rpaths. that's the whole job. iconic, honestly. 👑

---

🌸 SYNOPSIS 🌸

llvm-install-name-tool [options] input

that's it. options, then your input binary. she's lowkey simple like that. 💖

---

💫 DESCRIPTION 💫

llvm-install-name-tool is a tool to manipulate dynamic shared library install names and rpaths listed in a Mach-O binary. mach-o binaries, specifically. not vibing with anything else. 🍓

for most scenarios, it works as a drop-in replacement for Apple's install_name_tool. yes bestie, the way it just slots in — we love a seamless swap. ✨

---

👑 OPTIONS 👑

okay so here's the deal: at least one of the following options are required, and some options can be combined with other options. (not all of them though — read the fine print, i gotchu.) 📖

specifically: options -add_rpath, -delete_rpath, and -rpath can be combined in an invocation only if they do not share the same <rpath> value. like, they can hang out together, just not wearing the same outfit. 💅

• -add_rpath <rpath> — add an rpath named <rpath> to the specified binary. can be specified multiple times to add multiple rpaths. throws an error if <rpath> is already listed in the binary. (rude of it to already be there, honestly 💀)
• -change <old_install_name> <new_install_name> — change an install name <old_install_name> to <new_install_name> in the specified binary. can be specified multiple times to change multiple dependent shared library install names. option is ignored if <old_install_name> is not listed in the specified binary — she just shrugs and moves on, no drama. 🙈
• -delete_rpath <rpath> — delete an rpath named <rpath> from the specified binary. can be specified multiple times to delete multiple rpaths. throws an error if <rpath> is not listed in the binary. (can't delete what isn't there, bestie 😭)
• -delete_all_rpaths — deletes all rpaths from the binary. all of them. the whole collection. gone. 🔥
• --help, -h — print a summary of command line options. the classic. the icon. 🫶
• -id <name> — change shared library's identification name under LC_ID_DYLIB to <name> in the specified binary. if specified multiple times, only the last -id option is selected (last one wins, main character energy 👑). option is ignored if the specified Mach-O binary is not a dynamic shared library.
• -rpath <old_rpath> <new_rpath> — change an rpath named <old_rpath> to <new_rpath> in the specified binary. can be specified multiple times to change multiple rpaths. throws an error if <old_rpath> is not listed in the binary or <new_rpath> is already listed in the binary. double jeopardy, no cap. ⚠️
• --version, -V — display the version of the llvm-install-name-tool executable. say hi to her for me. 🌈

---

⭐ EXIT STATUS ⭐

llvm-install-name-tool exits with a non-zero exit code if there is an error. otherwise, it exits with code 0. so like, 0 = slay, anything else = something went sideways. 💀

---

🦋 BUGS 🦋

to report bugs, please visit <https://github.com/llvm/llvm-project/labels/tools:llvm-objcopy/strip/>. found a problem? tell the devs, don't suffer in silence bestie 🫶

---

🧚 SEE ALSO 🧚

llvm-objcopy(1) — go read that one too, iykyk 💜

---

🌸 AUTHOR 🌸

maintained by the LLVM Team (https://llvm.org/). legends, honestly. 🎀

---

💖 COPYRIGHT 💖

2003-2023, LLVM Project

---

ngl that's the whole page. every flag, every quirk, every "throws an error if". nothing skipped, nothing invented. periodt. 💅✨

okay bye bestie — this page was page 17, dated 2023-12-01, from the LLVM-INSTALL-NAME-TOOL(1) manual, and you absolutely ate that read. 🍓🦋💜