Gecko [ v99win.today ]

Name	Size	Permission
CREDITS	3.66 KB	-rw-r--r--
NEWS.Debian.gz	686 B	-rw-r--r--
README	603 B	-rw-r--r--
README.Debian	1.19 KB	-rw-r--r--
arch_dependencies.md.gz	2.23 KB	-rw-r--r--
autosetup.md.gz	1.82 KB	-rw-r--r--
boolean_dependencies.md	3.67 KB	-rw-r--r--
buildprocess.md	1.09 KB	-rw-r--r--
buildroot.md	3.54 KB	-rw-r--r--
changelog.Debian.gz	2.49 KB	-rw-r--r--
conditionalbuilds.md	1.69 KB	-rw-r--r--
copyright	1.86 KB	-rw-r--r--
dependencies.md.gz	3.73 KB	-rw-r--r--
dependency_generators.md.gz	3.49 KB	-rw-r--r--
file_triggers.md	3.97 KB	-rw-r--r--
format.md.gz	3.95 KB	-rw-r--r--
hregions.md	2.8 KB	-rw-r--r--
index.md	1.29 KB	-rw-r--r--
large_files.md	2.58 KB	-rw-r--r--
lua.md.gz	3.68 KB	-rw-r--r--
macros.md.gz	4.79 KB	-rw-r--r--
more_dependencies.md.gz	2.84 KB	-rw-r--r--
multiplebuilds.md	1.83 KB	-rw-r--r--
plugins.md.gz	1.7 KB	-rw-r--r--
queryformat.md.gz	2.34 KB	-rw-r--r--
relocatable.md	1.92 KB	-rw-r--r--
scriptlet_expansion.md.gz	2.05 KB	-rw-r--r--
signatures.md	2.46 KB	-rw-r--r--
signatures_digests.md	1.48 KB	-rw-r--r--
spec.md.gz	6.98 KB	-rw-r--r--
tags.md.gz	4.79 KB	-rw-r--r--
triggers.md.gz	1.94 KB	-rw-r--r--
tsort.md.gz	2.17 KB	-rw-r--r--

Code Editor : relocatable.md

---
layout: default
title: rpm.org - Relocatable packages
---
# Relocatable packages

Relocatable packages are a way to give the user a little control
over the installation location of a package.  For example, a vendor
may distribute their software to install in "/opt" but you'd like
it to install in "/usr/opt".  If the vendor were distributing a
relocatable RPM package, it would be easy.

## Building a Relocatable Package

Not all software can be "relocatable".  Before continuing you should
think about how the program works, what files it accesses, what other
programs access *it* (and expect it to be in a certain place), etc.
If you determine that the location of the package doesn't matter,
then it can probably be built as "relocatable".

All you need to do to build a relocatable package is put one or more:

```
  Prefix: <dir>
```

in your spec file.  The "<dir>" will usually be something like "/usr",
"/usr/local", or "/opt".  Every file in your %files list must start
with that prefix.  For example, if you have "Prefix: /usr" and your
%files list contains "/etc/foo.conf", the build will fail. The fix for
this is to put

```
  Prefix: /usr
  Prefix: /etc
```

into the spec file so that the /usr and /etc directories may be
relocated separately when this package is installed.

## Installing Relocatable Packages

By default, RPM will install a relocatable package in the prefix
directory listed in the spec file.  You can override this on the
RPM install command line with "--prefix <dir>".  For example, if
the package in question were going to be installed in "/opt" but
you don't have enough disk space there (and it is a relocatable
package), you could install it "--prefix /usr/opt".

If there is more then one Prefix you may relocate each prefix
separately by using syntax like:

```
  rpm ... --relocate /opt=/usr/opt --relocate /etc=/usr/etc ...
```

If any of the Prefixes is not being relocated they can be skipped on
the command line

${this.title}

Code Editor : relocatable.md