SWAMPy

✎ CARVE FLESH

EDITING: relocatable

/*! \page relocatable 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.

\section relocatable_building 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:

\verbatim
  Prefix: <dir>
\endverbatim

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

\verbatim
  Prefix: /usr
  Prefix: /etc
\endverbatim

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

\section relocatable_installing 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:

\verbatim
  rpm ... --relocate /opt=/usr/opt --relocate /etc=/usr/etc ...
\endverbatim

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

CANCEL

Name	Type	Size	Modified	Actions
↩ ..	DIR	—	—
📄 builddependencies	?	6.3 KB	2020-05-28 10:04	EDIT
📄 buildroot	?	3.7 KB	2020-05-28 10:04	EDIT
📄 conditionalbuilds	?	4 KB	2020-05-28 10:04	EDIT
📄 CREDITS	?	3.7 KB	2021-03-22 10:05	EDIT
📄 dependencies	?	13.3 KB	2020-05-28 10:04	EDIT
📄 format	?	10.2 KB	2020-05-28 10:04	EDIT
📄 hregions	?	2.9 KB	2020-05-28 10:04	EDIT
📄 macros	?	12.7 KB	2025-10-01 07:57	EDIT
📄 multiplebuilds	?	1.8 KB	2020-05-28 10:04	EDIT
📄 queryformat	?	5.5 KB	2020-05-28 10:04	EDIT
📄 relocatable	?	2 KB	2020-05-28 10:04	EDIT
📄 signatures	?	2.6 KB	2020-05-28 10:04	EDIT
📄 spec	?	9.6 KB	2020-05-28 10:04	EDIT
📄 triggers	?	5.5 KB	2020-05-28 10:04	EDIT
📄 tsort	?	5.3 KB	2020-05-28 10:04	EDIT