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
|
PatchELF is a simple utility for modifing existing ELF executables and
libraries. In particular, it can do the following:
* Change the dynamic loader ("ELF interpreter") of executables:
$ patchelf --set-interpreter /lib/my-ld-linux.so.2 my-program
* Change the RPATH of executables and libraries:
$ patchelf --set-rpath /opt/my-libs/lib:/other-libs my-program
* Shrink the RPATH of executables and libraries:
$ patchelf --shrink-rpath my-program
This removes from the RPATH all directories that do not contain a
library referenced by DT_NEEDED fields of the executable or library.
For instance, if an executable references one library libfoo.so, has
an RPATH "/lib:/usr/lib:/foo/lib", and libfoo.so can only be found
in /foo/lib, then the new RPATH will be "/foo/lib".
* Remove declared dependencies on dynamic libraries (DT_NEEDED
entries):
$ patchelf --remove-needed libfoo.so.1 my-program
This option can be given multiple times.
AUTHOR
Copyright 2004-2013 Eelco Dolstra <eelco.dolstra@logicblox.com>.
LICENSE
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or (at
your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
HOMEPAGE
http://nixos.org/patchelf.html
BUGS
The `strip' command from binutils generated broken executables when
applied to the output of patchelf (if `--set-rpath' or
`--set-interpreter' with a larger path than the original is used).
This appears to be a bug in binutils
(http://bugs.strategoxt.org/browse/NIXPKGS-85).
RELEASE HISTORY
0.7 (TBA):
* Rewrite section indices in symbol tables. This for instance allows
gdb to show proper backtraces.
* Added `--remove-needed' option.
0.6 (November 7, 2011):
* Hacky support for executables created by the Gold linker.
* Support segments with an alignment of 0 (contributed by Zack
Weinberg).
* Added a manual page (contributed by Jeremy Sanders
<jeremy@jeremysanders.net>).
0.5 (November 4, 2009):
* Various bugfixes.
* `--force-rpath' now deletes the DT_RUNPATH if it is present.
0.4 (June 4, 2008):
* Support for growing the RPATH on dynamic libraries.
* IA-64 support (not tested) and related 64-bit fixes.
* FreeBSD support.
* `--set-rpath', `--shrink-rpath' and `--print-rpath' now prefer
DT_RUNPATH over DT_RPATH, which is obsolete. When updating, if both
are present, both are updated. If only DT_RPATH is present, it is
converted to DT_RUNPATH unless `--force-rpath' is specified. If
neither is present, a DT_RUNPATH is added unless `--force-rpath' is
specified, in which case a DT_RPATH is added.
0.3 (May 24, 2007):
* Support for 64-bit ELF binaries (such as on x86_64-linux).
* Support for big-endian ELF binaries (such as on powerpc-linux).
* Various bugfixes.
0.2 (January 15, 2007):
* Provides a hack to get certain programs (such as the
Belastingaangifte 2005) to work.
0.1 (October 11, 2005):
* Initial release.
|
