1llvm-install-name-tool - LLVM tool for manipulating install-names and rpaths
2============================================================================
3
4.. program:: llvm-install-name-tool
5
6SYNOPSIS
7--------
8
9:program:`llvm-install-name-tool` [*options*] *input*
10
11DESCRIPTION
12-----------
13
14:program:`llvm-install-name-tool` is a tool to manipulate dynamic shared library
15install names and rpaths listed in a Mach-O binary.
16
17For most scenarios, it works as a drop-in replacement for Apple's
18:program:`install_name_tool`.
19
20OPTIONS
21--------
22At least one of the following options are required, and some options can be
23combined with other options. Options :option:`-add_rpath`, :option:`-delete_rpath`,
24and :option:`-rpath` can be combined in an invocation only if they do not share
25the same `<rpath>` value.
26
27.. option:: -add_rpath <rpath>
28
29 Add an rpath named ``<rpath>`` to the specified binary. Can be specified multiple
30 times to add multiple rpaths. Throws an error if ``<rpath>`` is already listed in
31 the binary.
32
33.. option:: -change <old_install_name> <new_install_name>
34
35 Change an install name ``<old_install_name>`` to ``<new_install_name>`` in the
36 specified binary. Can be specified multiple times to change multiple dependent shared
37 library install names. Option is ignored if ``<old_install_name>`` is not listed
38 in the specfied binary.
39
40.. option:: -delete_rpath <rpath>
41
42 Delete an rpath named ``<rpath>`` from the specified binary. Can be specified multiple
43 times to delete multiple rpaths. Throws an error if ``<rpath>`` is not listed in
44 the binary.
45
46.. option:: -id <name>
47
48 Change shared library's identification name under LC_ID_DYLIB to ``<name>`` in the
49 specfied binary. If specified multiple times, only the last :option:`-id` option is
50 selected. Option is ignored if the specified Mach-O binary is not a dynamic shared library.
51
52.. option:: -rpath <old_rpath> <new_rpath>
53
54 Change an rpath named ``<old_rpath>`` to ``<new_rpath>`` in the specified binary. Can be specified
55 multiple times to change multiple rpaths. Throws an error if ``<old_rpath>`` is not listed
56 in the binary or ``<new_rpath>`` is already listed in the binary.
57
58EXIT STATUS
59-----------
60
61:program:`llvm-install-name-tool` exits with a non-zero exit code if there is an error.
62Otherwise, it exits with code 0.
63
64BUGS
65----
66
67To report bugs, please visit <https://bugs.llvm.org/>.
68
69SEE ALSO
70--------
71
72:manpage:`llvm-objcopy(1)`
73