docs/CommandGuide/llvm-install-name-tool.md

# llvm-install-name-tool - LLVM tool for manipulating install-names and rpaths

```{program} llvm-install-name-tool
```

## SYNOPSIS

{program}`llvm-install-name-tool` \[*options*\] *input*

## DESCRIPTION

{program}`llvm-install-name-tool` is a tool to manipulate dynamic shared library
install names and rpaths listed in a Mach-O binary.

For most scenarios, it works as a drop-in replacement for Apple's
{program}`install_name_tool`.

## OPTIONS

At least one of the following options are required, and some options can be
combined with other options. Options {option}`-add_rpath`, {option}`-delete_rpath`,
and {option}`-rpath` can be combined in an invocation only if they do not share
the same `<rpath>` value.

:::{option} -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.
:::

:::{option} -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.
:::

:::{option} -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.
:::

:::{option} -delete_all_rpaths
Deletes all rpaths from the binary.
:::

:::{option} --help, -h
Print a summary of command line options.
:::

:::{option} -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 {option}`-id` option is
selected. Option is ignored if the specified Mach-O binary is not a dynamic shared library.
:::

:::{option} -o <file>, --output <file>
Write the modified binary to `<file>` instead of updating the input file in place.
:::

:::{option} -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.
:::

:::{option} --version, -V
Display the version of the {program}`llvm-install-name-tool` executable.
:::

## EXIT STATUS

{program}`llvm-install-name-tool` exits with a non-zero exit code if there is an error.
Otherwise, it exits with code 0.

## BUGS

To report bugs, please visit \<<https://github.com/llvm/llvm-project/labels/tools:llvm-objcopy/strip/>>.

## SEE ALSO

{manpage}`llvm-objcopy(1)`