chrpath.1

   1 .\" This program is free software; you can redistribute it and/or modify
   2 .\" it under the terms of the GNU General Public License as published by
   3 .\" the Free Software Foundation; either version 2 of the License, or
   4 .\" (at your option) any later version.
   5 .\"
   6 .\" This program is distributed in the hope that it will be useful,
   7 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
   8 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   9 .\" GNU General Public License for more details.
  10 .\"
  11 .\" You should have received a copy of the GNU General Public License
  12 .\" along with this program; if not, write to the Free Software
  13 .\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  14 .\"
  15 .TH CHRPATH 1 "May 4, 2002" "chrpath" "change rpath/runpath in binaries"
  16 .SH NAME
  17 chrpath \- change the rpath or runpath in binaries
  18 .SH SYNOPSIS
  19 \fBchrpath\fP
  20 [ \fB-v\fP | \fB--version\fP ]
  21 [ \fB-d\fP | \fB--delete\fP ]
  22 [ \fB-r\fP \fI<path>\fP |\  \fB--replace\fP \fI<path>\fP ]
  23 [ \fB-c\fP | \fB--convert\fP ]
  24 [ \fB-l\fP | \fB--list\fP ]
  25 [ \fB-h\fP | \fB--help\fP ]
  26 \fI<program>\fP [ \fI<program>\fP ... ]
  27 .SH DESCRIPTION
  28 \fBchrpath\fP changes, lists or removes the rpath or runpath setting in a
  29 binary.  The rpath, or runpath if it is present, is where the runtime linker
  30 should look for the libraries needed for a program.
  31 .SH OPTIONS
  32 .TP
  33 .BR -v \ |\  --version
  34 Display program version number
  35 .TP
  36 .BR -d \ |\  --delete
  37 Delete current rpath or runpath setting
  38 .TP
  39 .BR -c \ |\  --convert
  40 Convert the rpath setting into a runpath setting
  41 .TP
  42 .BI -r\ \fI<path>\fP\ |\ --replace\ \fI<path>\fP
  43 Replace current rpath or runpath setting with the path given.  The new
  44 path must be shorter or the same length as the current path.
  45 .TP
  46 .BR -k \ |\  --keepgoing
  47 Do not fail on first error, but process all arguments before returning
  48 the error.
  49 .TP
  50 .BR -l \ |\  --list
  51 List the current rpath or runpath (default)
  52 .TP
  53 .BR -h \ |\  --help
  54 Show usage information.
  55 .SH EXIT STATUS
  56 .TP
  57 .BR 0
  58 If all operations were successful
  59 .TP
  60 .BR > 0
  61 if one of the operations failed.  A failing operation terminates
  62 the program unless -k is specified.
  63
  64 .SH BUGS
  65 This program cannot create an RPATH tag if the ELF does not have one,
  66 and it can only replace an RPATH with one of equal or shorter
  67 length. (Moving ELF sections following a lengthened string table would
  68 be difficult and error-prone at best, and is sometimes outright
  69 impossible due to issues like limited ranges in jump instructions.)
  70
  71 .SH AUTHOR
  72 The chrpath program was written by Petter Reinholdtsen
  73 <pere@hungry.com>, based on works by Geoffrey Keating
  74 <geoffk@ozemail.com.au> and Peeter Joot <peeterj@ca.ibm.com>.
  75
  76 This manual page was originally written by
  77 Tollef Fog Heen <tfheen@debian.org>, for the Debian GNU/Linux
  78 system (but may be used by others).