summaryrefslogtreecommitdiffstats
path: root/patchelf.1
diff options
context:
space:
mode:
authorEelco Dolstra <e.dolstra@tudelft.nl>2010-06-10 08:55:30 (GMT)
committerEelco Dolstra <e.dolstra@tudelft.nl>2010-06-10 08:55:30 (GMT)
commit86d142dfa0ee23682757cb3d02ffc350e36d51da (patch)
tree3bcc8019bc267a409237e6fcc67ab60759be5a15 /patchelf.1
parentdeb109a10516a9e95563a334c8ab7c3062afbdde (diff)
downloadpatchelf-86d142dfa0ee23682757cb3d02ffc350e36d51da.zip
patchelf-86d142dfa0ee23682757cb3d02ffc350e36d51da.tar.gz
patchelf-86d142dfa0ee23682757cb3d02ffc350e36d51da.tar.bz2
* Added a manual page contributed by Jeremy Sanders
<jeremy@jeremysanders.net>.
Diffstat (limited to 'patchelf.1')
-rw-r--r--patchelf.163
1 files changed, 63 insertions, 0 deletions
diff --git a/patchelf.1 b/patchelf.1
new file mode 100644
index 0000000..4865256
--- /dev/null
+++ b/patchelf.1
@@ -0,0 +1,63 @@
+.\" Process this file with
+.\" groff -man -Tascii foo.1
+.\"
+.TH PATCHELF 1 "JUNE 2010" PATCHELF "User Manuals"
+.SH NAME
+patchelf - Modify ELF files
+
+.SH SYNOPSIS
+.B patchelf
+.I OPTION
+.B
+.I FILE
+.B
+
+.SH DESCRIPTION
+
+PatchELF is a simple utility for modifying existing ELF executables
+and libraries. It can change the dynamic loader ("ELF interpreter")
+of executables and change the RPATH of executables and libraries.
+
+.SH OPTIONS
+
+The single option given operates on a given FILE, editing in place.
+
+.IP "--set-interpreter INTERPRETER"
+Change the dynamic loader ("ELF interpreter") of executable given to
+INTERPRETER.
+
+.IP --print-intepreter
+Prints the ELF interpreter of the executable.
+
+.IP "--set-rpath RPATH"
+Change the RPATH of the executable or library to RPATH.
+
+.IP --shrink-rpath
+Remove 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".
+
+.IP --print-rpath
+Prints the RPATH for an executable or library.
+
+.IP --force-rpath
+Forces the use of the obsolete DT_RPATH in the file instead of
+DT_RUNPATH. By default DT_RPATH is converted to DT_RUNPATH.
+
+.IP --debug
+Prints details of the changes made to the input file.
+
+.IP --version
+Shows the version of patchelf.
+
+.SH AUTHOR
+Eelco Dolstra <e.dolstra@tudelft.nl>
+
+.SH "SEE ALSO"
+.BR elf (5),
+.BR ld.so (8)
+
+