INSTALL_NAME_TOOL(1)

🌸 NAME 🌸

okay so bestie, you're reading the install_name_tool page from the General Commands Manual, and she has main character energy — her whole job is to change dynamic shared library install names. That's the NAME section, periodt. ✨

🦋 SYNOPSIS 🦋

install_name_tool [-change old new ] ... [-rpath old new ] ...
[-add_rpath new ] ... [-delete_rpath new ] ... [-id name] file

💅 DESCRIPTION 💅

So install_name_tool changes the dynamic shared library install names and/or adds, changes or deletes the rpaths recorded in a Mach-O binary. It's giving Mach-O binary energy, but make it cute. 💖

🌈 heads up, bestie: for this tool to work when the install names or rpaths are larger, the binary should be built with the ld(1) -headerpad_max_install_names option. That's the exact caveat, no cap.

Now the options, one by one — and yes, some of these can be stacked, iykyk:

• -change old new — changes the dependent shared library install name old to new in the specified Mach-O binary. More than one of these options can be specified. If the Mach-O binary does not contain the old install name in a specified -change option, the option is ignored — she just lowkey moves on. 🫶
• -id name — changes the shared library identification name of a dynamic shared library to name. If the Mach-O binary is not a dynamic shared library and the -id option is specified, it is ignored. 🎀
• -rpath old new — changes the rpath path name old to new in the specified Mach-O binary. More than one of these options can be specified. If the Mach-O binary does not contain the old rpath path name in a specified -rpath, it is an error. 🚨
• -add_rpath new — adds the rpath path name new in the specified Mach-O binary. More than one of these options can be specified. If the Mach-O binary already contains the new rpath path name specified in -add_rpath, it is an error. 🔥
• -delete_rpath old — deletes the rpath path name old in the specified Mach-O binary. More than one of these options can be specified. If the Mach-O binary does not contain the old rpath path name specified in -delete_rpath, it is an error. 💀

🌈 SEE ALSO 🌈

• ld(1) — go say hi, that's the whole see-also list, fr fr. 👑

mwah 💋 this page is brought to you by Apple, Inc., dated March 4, 2009 — that's the source/version and date sign-off, bestie, and we are so out. 🎀✨