Imported Upstream version 0.13
[platform/upstream/chrpath.git] / 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
44 .TP
45 .BR -k \ |\  --keepgoing
46 Do not fail on first error, but process all arguments before returning
47 the error.
48 .TP
49 .BR -l \ |\  --list
50 List the current rpath or runpath (default)
51 .TP
52 .BR -h \ |\  --help
53 Show usage information.
54 .SH EXIT STATUS
55 .TP
56 .BR 0
57 If all operations were successful
58 .TP
59 .BR > 0
60 if one of the operations failed.  A failing operation terminates
61 the program unless -k is specified.
62
63 .SH AUTHOR
64 The chrpath program was written by Petter Reinholdtsen
65 <pere@hungry.com>, based on works by Geoffrey Keating
66 <geoffk@ozemail.com.au> and Peeter Joot <peeterj@ca.ibm.com>.
67
68 This manual page was originally written by
69 Tollef Fog Heen <tfheen@debian.org>, for the Debian GNU/Linux
70 system (but may be used by others).