LLVM-INSTALL-NAME-TOOL(1)

📦
version 14.0.6 · 8 versions
, in ubuntu questing

💖 LLVM-INSTALL-NAME-TOOL 💖

okay bestie, welcome to the LLVM manual page for llvm-install-name-tool — section 1, the "user commands" section, iykyk. this is the girlboss tool that rearranges install-names and rpaths in Mach-O binaries, and she is that girl. let's get into it ✨

🌸 NAME 🌸

llvm-install-name-tool — the LLVM tool for manipulating install-names and rpaths. no cap, that's literally her whole job description.

🎀 SYNOPSIS 🎀

llvm-install-name-tool [options] input

🦋 DESCRIPTION 🦋

so llvm-install-name-tool is a tool to manipulate dynamic shared library install names and rpaths listed in a Mach-O binary. that's the vibe. that's the whole thing. 💅

and for most scenarios, it works as a drop-in replacement for Apple's install_name_tool. the way that it just slots right in?? iconic. no notes. 🫶

✨ OPTIONS ✨

okay so here's the thing: at least one of the following options are required, and some options can be combined with other options. specifically — -add_rpath, -delete_rpath, and -rpath can be combined in an invocation only if they do not share the same <rpath> value. that's the rule, bestie, don't fight it. 😌

  • -add_rpath <rpath> — adds an rpath named <rpath> to the specified binary. you can specify this multiple times to add multiple rpaths, go off 👑. it throws an error if <rpath> is already listed in the binary. (rude, but fair.)
  • -change <old_install_name> <new_install_name> — changes an install name from <old_install_name> to <new_install_name> in the specified binary. specify it multiple times to change multiple dependent shared library install names, the more the merrier 🌈. this option is ignored if <old_install_name> is not listed in the specified binary — so it just kinda... shrugs and moves on 🙈.
  • -delete_rpath <rpath> — deletes an rpath named <rpath> from the specified binary. can be specified multiple times to delete multiple rpaths, purge era 💀. throws an error if <rpath> is not listed in the binary.
  • -delete_all_rpaths — deletes all rpaths from the binary. total wipeout. no survivors. 🧹✨
  • --help, -h — prints a summary of command line options. your little cheat sheet, bestie 📝
  • -id <name> — changes the shared library's identification name under LC_ID_DYLIB to <name> in the specified binary. if you specify it multiple times, only the last -id option is selected — so, like, the final answer wins, periodt. this option is ignored if the specified Mach-O binary is not a dynamic shared library (she said not my department 💅).
  • -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 <new_rpath> is already listed in the binary — double the drama, double the error 😭.
  • --version, -V — displays the version of the llvm-install-name-tool executable. slay, know your queen's birthday 🎂

💀 EXIT STATUS 💀

llvm-install-name-tool exits with a non-zero exit code if there is an error. otherwise? she exits with code 0, flawless victory, main character energy. ⭐

🐛 BUGS 🐛

found a bug? to report bugs, please visit:

https://github.com/llvm/llvm-project/labels/tools:llvm-objcopy/strip/

(the original page shows this URL broken across lines with a soft hyphen at the end of the first line — just paste it as one link, bestie, she's fine 🫶)

👀 SEE ALSO 👀

👑 AUTHOR 👑

maintained by the LLVM Team (https://llvm.org/). the whole squad, holding it down. 💜

2003-2025, LLVM Project

that's the whole page, bestie! every flag, every default, every error condition, every exit code — all present and accounted for. now go forth and manipulate those install names. you got this. 🦋✨

LLVM-INSTALL-NAME-TOOL, page 14, dated 2025-05-22, brought to you by the LLVM Project — mwah, take care of her, she's precious 💖🎀🌸

📦 where this page comes from