1LLVM-INSTALL-NAME-TOOL(1)            LLVM            LLVM-INSTALL-NAME-TOOL(1)
2
3
4

NAME

6       llvm-install-name-tool  -  LLVM tool for manipulating install-names and
7       rpaths
8

SYNOPSIS

10       llvm-install-name-tool [options] input
11

DESCRIPTION

13       llvm-install-name-tool is a tool to manipulate dynamic  shared  library
14       install names and rpaths listed in a Mach-O binary.
15
16       For  most  scenarios, it works as a drop-in replacement for Apple's in‐
17       stall_name_tool.
18

OPTIONS

20       At least one of the following options are required,  and  some  options
21       can  be combined with other options. Options -add_rpath, -delete_rpath,
22       and -rpath can be combined in an invocation only if they do  not  share
23       the same <rpath> value.
24
25       -add_rpath <rpath>
26              Add an rpath named <rpath> to the specified binary. Can be spec‐
27              ified multiple times to add multiple rpaths. Throws an error  if
28              <rpath> is already listed in the binary.
29
30       -change <old_install_name> <new_install_name>
31              Change  an install name <old_install_name> to <new_install_name>
32              in the specified binary. Can  be  specified  multiple  times  to
33              change  multiple  dependent shared library install names. Option
34              is ignored if <old_install_name> is not listed in the  specified
35              binary.
36
37       -delete_rpath <rpath>
38              Delete  an rpath named <rpath> from the specified binary. Can be
39              specified multiple times to delete multiple  rpaths.  Throws  an
40              error if <rpath> is not listed in the binary.
41
42       -delete_all_rpaths
43              Deletes all rpaths from the binary.
44
45       --help, -h
46              Print a summary of command line options.
47
48       -id <name>
49              Change shared library's identification name under LC_ID_DYLIB to
50              <name> in the specified binary.  If  specified  multiple  times,
51              only  the  last -id option is selected. Option is ignored if the
52              specified Mach-O binary is not a dynamic shared library.
53
54       -rpath <old_rpath> <new_rpath>
55              Change an rpath named <old_rpath> to <new_rpath> in  the  speci‐
56              fied  binary. Can be specified multiple times to change multiple
57              rpaths. Throws an error if <old_rpath> is not listed in the  bi‐
58              nary or <new_rpath> is already listed in the binary.
59
60       --version, -V
61              Display the version of the llvm-install-name-tool executable.
62

EXIT STATUS

64       llvm-install-name-tool  exits  with a non-zero exit code if there is an
65       error.  Otherwise, it exits with code 0.
66

BUGS

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

SEE ALSO

72       llvm-objcopy(1)
73

AUTHOR

75       Maintained by the LLVM Team (https://llvm.org/).
76
78       2003-2023, LLVM Project
79
80
81
82
8317                                2023-11-28         LLVM-INSTALL-NAME-TOOL(1)
Impressum