LLVM-INSTALL-NAME-TOOL(1)

📦
version 12.0.1 · 4 versions
, in fedora 43, fedora 44

✨ LLVM-INSTALL-NAME-TOOL(1) ✨

okay bestie, welcome to the llvm-install-name-tool page — it lives in section 1 of the LLVM manual and it's literally the girlboss of Mach-O library metadata 💅

🎀 NAME 🎀

llvm-install-name-tool — the LLVM tool for manipulating install-names and rpaths, no cap 🦋

🌸 SYNOPSIS 🌸

llvm-install-name-tool [options] input

💖 DESCRIPTION 💖

so llvm-install-name-tool is a tool that manipulates dynamic shared library install names and rpaths listed in a Mach-O binary. it's giving surgeon but for metadata ✨

and for most scenarios?? it works as a drop-in replacement for Apple's install_name_tool. iconic behavior honestly 👑

✨ OPTIONS ✨

heads up babes: at least one of the following options is required, and some options can be combined with other options. options -add_rpath, -delete_rpath, and -rpath can be combined in an invocation only if they do not share the same <rpath> value. so like, play nice 🫶
  • -add_rpath <rpath> — adds an rpath named <rpath> to the specified binary. you can specify it multiple times to add multiple rpaths (yes queen, stacking). throws an error if <rpath> is already listed in the binary 😭
  • -change <old_install_name> <new_install_name> — changes 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. this option gets ignored if <old_install_name> is not listed in the specified binary (note: the original page says "specfied", we're just gonna move past that 💀)
  • -delete_rpath <rpath> — deletes 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 🙈
  • -delete_all_rpaths — deletes all rpaths from the binary. scorched earth, no survivors 🔥
  • --help, -h — prints a summary of command line options. the classic "what do i even do here" button 💜
  • -id <name> — changes the 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 standing, main character energy). this option is ignored if the specified Mach-O binary is not a dynamic shared library 🦋
  • -rpath <old_rpath> <new_rpath> — changes 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 if <new_rpath> is already listed in the binary 😤
  • --version, -V — displays the version of the llvm-install-name-tool executable. gotta know what era we're in ⭐

💀 EXIT STATUS 💀

llvm-install-name-tool exits with a non-zero exit code if there is an error. otherwise, it exits with code 0. simple as that, slay 🌈

🐛 BUGS 🐛

to report bugs, please visit <https://bugs.llvm.org/> — go tell them everything bestie, they wanna know 🫶

👀 SEE ALSO 👀

llvm-objcopy(1)

🌟 AUTHOR 🌟

maintained by the LLVM Team (https://llvm.org/). periodt 👑

2003-2024, LLVM Project

and that's the whole page, bestie!! this was page 12, dated 2024-07-18, from the LLVM manual — iykyk 💖✨🎀

📦 where this page comes from