1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
|
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>llvm-install-name-tool - LLVM tool for manipulating install-names and rpaths — LLVM 13 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/llvm-theme.css" type="text/css" />
<script id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script src="../_static/jquery.js"></script>
<script src="../_static/underscore.js"></script>
<script src="../_static/doctools.js"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="llvm-nm - list LLVM bitcode and object file’s symbol table" href="llvm-nm.html" />
<link rel="prev" title="llvm-cxxfilt - LLVM symbol name demangler" href="llvm-cxxfilt.html" />
<style type="text/css">
table.right { float: right; margin-left: 20px; }
table.right td { border: 1px solid #ccc; }
</style>
</head><body>
<div class="logo">
<a href="../index.html">
<img src="../_static/logo.png"
alt="LLVM Logo" width="250" height="88"/></a>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="llvm-nm.html" title="llvm-nm - list LLVM bitcode and object file’s symbol table"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="llvm-cxxfilt.html" title="llvm-cxxfilt - LLVM symbol name demangler"
accesskey="P">previous</a> |</li>
<li><a href="https://llvm.org/">LLVM Home</a> | </li>
<li><a href="../index.html">Documentation</a>»</li>
<li class="nav-item nav-item-1"><a href="../Reference.html" >Reference</a> »</li>
<li class="nav-item nav-item-2"><a href="index.html" accesskey="U">LLVM Command Guide</a> »</li>
<li class="nav-item nav-item-this"><a href="">llvm-install-name-tool - LLVM tool for manipulating install-names and rpaths</a></li>
</ul>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3>Documentation</h3>
<ul class="want-points">
<li><a href="https://llvm.org/docs/GettingStartedTutorials.html">Getting Started/Tutorials</a></li>
<li><a href="https://llvm.org/docs/UserGuides.html">User Guides</a></li>
<li><a href="https://llvm.org/docs/Reference.html">Reference</a></li>
</ul>
<h3>Getting Involved</h3>
<ul class="want-points">
<li><a href="https://llvm.org/docs/Contributing.html">Contributing to LLVM</a></li>
<li><a href="https://llvm.org/docs/HowToSubmitABug.html">Submitting Bug Reports</a></li>
<li><a href="https://llvm.org/docs/GettingInvolved.html#mailing-lists">Mailing Lists</a></li>
<li><a href="https://llvm.org/docs/GettingInvolved.html#irc">IRC</a></li>
<li><a href="https://llvm.org/docs/GettingInvolved.html#meetups-and-social-events">Meetups and Social Events</a></li>
</ul>
<h3>Additional Links</h3>
<ul class="want-points">
<li><a href="https://llvm.org/docs/FAQ.html">FAQ</a></li>
<li><a href="https://llvm.org/docs/Lexicon.html">Glossary</a></li>
<li><a href="https://llvm.org/pubs">Publications</a></li>
<li><a href="https://github.com/llvm/llvm-project//">Github Repository</a></li>
</ul>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/CommandGuide/llvm-install-name-tool.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" />
<input type="submit" value="Go" />
</form>
</div>
</div>
<script>$('#searchbox').show(0);</script>
</div>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="llvm-install-name-tool-llvm-tool-for-manipulating-install-names-and-rpaths">
<h1>llvm-install-name-tool - LLVM tool for manipulating install-names and rpaths<a class="headerlink" href="#llvm-install-name-tool-llvm-tool-for-manipulating-install-names-and-rpaths" title="Permalink to this headline">¶</a></h1>
<div class="section" id="synopsis">
<h2>SYNOPSIS<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2>
<p><strong class="program">llvm-install-name-tool</strong> [<em>options</em>] <em>input</em></p>
</div>
<div class="section" id="description">
<h2>DESCRIPTION<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
<p><strong class="program">llvm-install-name-tool</strong> is a tool to manipulate dynamic shared library
install names and rpaths listed in a Mach-O binary.</p>
<p>For most scenarios, it works as a drop-in replacement for Apple’s
<strong class="program">install_name_tool</strong>.</p>
</div>
<div class="section" id="options">
<h2>OPTIONS<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h2>
<p>At least one of the following options are required, and some options can be
combined with other options. Options <a class="reference internal" href="#cmdoption-llvm-install-name-tool-add_rpath"><code class="xref std std-option docutils literal notranslate"><span class="pre">-add_rpath</span></code></a>, <a class="reference internal" href="#cmdoption-llvm-install-name-tool-delete_rpath"><code class="xref std std-option docutils literal notranslate"><span class="pre">-delete_rpath</span></code></a>,
and <a class="reference internal" href="#cmdoption-llvm-install-name-tool-rpath"><code class="xref std std-option docutils literal notranslate"><span class="pre">-rpath</span></code></a> can be combined in an invocation only if they do not share
the same <cite><rpath></cite> value.</p>
<dl class="std option">
<dt id="cmdoption-llvm-install-name-tool-add_rpath">
<span id="cmdoption-llvm-install-name-tool-add-rpath"></span><code class="sig-name descname"><span class="pre">-add_rpath</span></code><code class="sig-prename descclassname"> <span class="pre"><rpath></span></code><a class="headerlink" href="#cmdoption-llvm-install-name-tool-add_rpath" title="Permalink to this definition">¶</a></dt>
<dd><p>Add an rpath named <code class="docutils literal notranslate"><span class="pre"><rpath></span></code> to the specified binary. Can be specified multiple
times to add multiple rpaths. Throws an error if <code class="docutils literal notranslate"><span class="pre"><rpath></span></code> is already listed in
the binary.</p>
</dd></dl>
<dl class="std option">
<dt id="cmdoption-llvm-install-name-tool-change">
<code class="sig-name descname"><span class="pre">-change</span></code><code class="sig-prename descclassname"> <span class="pre"><old_install_name></span> <span class="pre"><new_install_name></span></code><a class="headerlink" href="#cmdoption-llvm-install-name-tool-change" title="Permalink to this definition">¶</a></dt>
<dd><p>Change an install name <code class="docutils literal notranslate"><span class="pre"><old_install_name></span></code> to <code class="docutils literal notranslate"><span class="pre"><new_install_name></span></code> in the
specified binary. Can be specified multiple times to change multiple dependent shared
library install names. Option is ignored if <code class="docutils literal notranslate"><span class="pre"><old_install_name></span></code> is not listed
in the specified binary.</p>
</dd></dl>
<dl class="std option">
<dt id="cmdoption-llvm-install-name-tool-delete_rpath">
<span id="cmdoption-llvm-install-name-tool-delete-rpath"></span><code class="sig-name descname"><span class="pre">-delete_rpath</span></code><code class="sig-prename descclassname"> <span class="pre"><rpath></span></code><a class="headerlink" href="#cmdoption-llvm-install-name-tool-delete_rpath" title="Permalink to this definition">¶</a></dt>
<dd><p>Delete an rpath named <code class="docutils literal notranslate"><span class="pre"><rpath></span></code> from the specified binary. Can be specified multiple
times to delete multiple rpaths. Throws an error if <code class="docutils literal notranslate"><span class="pre"><rpath></span></code> is not listed in
the binary.</p>
</dd></dl>
<dl class="std option">
<dt id="cmdoption-llvm-install-name-tool-delete_all_rpaths">
<span id="cmdoption-llvm-install-name-tool-delete-all-rpaths"></span><code class="sig-name descname"><span class="pre">-delete_all_rpaths</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-llvm-install-name-tool-delete_all_rpaths" title="Permalink to this definition">¶</a></dt>
<dd><p>Deletes all rpaths from the binary.</p>
</dd></dl>
<dl class="std option">
<dt id="cmdoption-llvm-install-name-tool-help">
<span id="cmdoption-llvm-install-name-tool-h"></span><code class="sig-name descname"><span class="pre">--help</span></code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname"><span class="pre">,</span> </code><code class="sig-name descname"><span class="pre">-h</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-llvm-install-name-tool-help" title="Permalink to this definition">¶</a></dt>
<dd><p>Print a summary of command line options.</p>
</dd></dl>
<dl class="std option">
<dt id="cmdoption-llvm-install-name-tool-id">
<code class="sig-name descname"><span class="pre">-id</span></code><code class="sig-prename descclassname"> <span class="pre"><name></span></code><a class="headerlink" href="#cmdoption-llvm-install-name-tool-id" title="Permalink to this definition">¶</a></dt>
<dd><p>Change shared library’s identification name under LC_ID_DYLIB to <code class="docutils literal notranslate"><span class="pre"><name></span></code> in the
specified binary. If specified multiple times, only the last <a class="reference internal" href="#cmdoption-llvm-install-name-tool-id"><code class="xref std std-option docutils literal notranslate"><span class="pre">-id</span></code></a> option is
selected. Option is ignored if the specified Mach-O binary is not a dynamic shared library.</p>
</dd></dl>
<dl class="std option">
<dt id="cmdoption-llvm-install-name-tool-rpath">
<code class="sig-name descname"><span class="pre">-rpath</span></code><code class="sig-prename descclassname"> <span class="pre"><old_rpath></span> <span class="pre"><new_rpath></span></code><a class="headerlink" href="#cmdoption-llvm-install-name-tool-rpath" title="Permalink to this definition">¶</a></dt>
<dd><p>Change an rpath named <code class="docutils literal notranslate"><span class="pre"><old_rpath></span></code> to <code class="docutils literal notranslate"><span class="pre"><new_rpath></span></code> in the specified binary. Can be specified
multiple times to change multiple rpaths. Throws an error if <code class="docutils literal notranslate"><span class="pre"><old_rpath></span></code> is not listed
in the binary or <code class="docutils literal notranslate"><span class="pre"><new_rpath></span></code> is already listed in the binary.</p>
</dd></dl>
<dl class="std option">
<dt id="cmdoption-llvm-install-name-tool-version">
<span id="cmdoption-llvm-install-name-tool-V"></span><span id="cmdoption-llvm-install-name-tool-v"></span><code class="sig-name descname"><span class="pre">--version</span></code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname"><span class="pre">,</span> </code><code class="sig-name descname"><span class="pre">-V</span></code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-llvm-install-name-tool-version" title="Permalink to this definition">¶</a></dt>
<dd><p>Display the version of the <strong class="program">llvm-install-name-tool</strong> executable.</p>
</dd></dl>
</div>
<div class="section" id="exit-status">
<h2>EXIT STATUS<a class="headerlink" href="#exit-status" title="Permalink to this headline">¶</a></h2>
<p><strong class="program">llvm-install-name-tool</strong> exits with a non-zero exit code if there is an error.
Otherwise, it exits with code 0.</p>
</div>
<div class="section" id="bugs">
<h2>BUGS<a class="headerlink" href="#bugs" title="Permalink to this headline">¶</a></h2>
<p>To report bugs, please visit <<a class="reference external" href="https://bugs.llvm.org/">https://bugs.llvm.org/</a>>.</p>
</div>
<div class="section" id="see-also">
<h2>SEE ALSO<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2>
<p><em class="manpage"><a class="manpage reference external" href="https://llvm.org/docs/CommandGuide/llvm-objcopy.html">llvm-objcopy(1)</a></em></p>
</div>
</div>
<div class="clearer"></div>
</div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="../genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="llvm-nm.html" title="llvm-nm - list LLVM bitcode and object file’s symbol table"
>next</a> |</li>
<li class="right" >
<a href="llvm-cxxfilt.html" title="llvm-cxxfilt - LLVM symbol name demangler"
>previous</a> |</li>
<li><a href="https://llvm.org/">LLVM Home</a> | </li>
<li><a href="../index.html">Documentation</a>»</li>
<li class="nav-item nav-item-1"><a href="../Reference.html" >Reference</a> »</li>
<li class="nav-item nav-item-2"><a href="index.html" >LLVM Command Guide</a> »</li>
<li class="nav-item nav-item-this"><a href="">llvm-install-name-tool - LLVM tool for manipulating install-names and rpaths</a></li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2003-2021, LLVM Project.
Last updated on 2021-09-18.
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 3.5.4.
</div>
</body>
</html>
|
