diff options
| author |   Mark Loeser <halcy0n@gentoo.org> | 2006-02-27 15:51:45 +0000 |
|---|---|---|
| committer | Mark Loeser <halcy0n@gentoo.org> | 2006-02-27 15:51:45 +0000 |
| commit | 296c57d3e177875dea9fc69cdc21d25befabce01 (patch) | |
| tree | 1b1b77add04d0055420e297db39a41b1a8060773 /general-concepts/install-destinations/text.xml | |
| parent | Add some more of general-concepts (diff) | |
| download | devmanual-296c57d3e177875dea9fc69cdc21d25befabce01.tar.gz devmanual-296c57d3e177875dea9fc69cdc21d25befabce01.tar.bz2 devmanual-296c57d3e177875dea9fc69cdc21d25befabce01.zip | |
Add some more pages. The Makefile now generates the png's at build time, so we don't need the PNGs in the repo anymore
git-svn-id: svn+ssh://svn.gentoo.org/var/svnroot/devmanual/trunk@7 176d3534-300d-0410-8db8-84e73ed771c3
Diffstat (limited to 'general-concepts/install-destinations/text.xml')
| -rw-r--r-- | general-concepts/install-destinations/text.xml | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/general-concepts/install-destinations/text.xml b/general-concepts/install-destinations/text.xml new file mode 100644 index 0000000..dbe0492 --- /dev/null +++ b/general-concepts/install-destinations/text.xml @@ -0,0 +1,32 @@ +<?xml version="1.0"?> +<guide self="general-concepts/install-destinations/"> +<chapter> +<title>Install Destinations</title> + +<body> + +<p> +When an ebuild runs the <c>src_install</c> phase, it installs an image of the +package in question from <c>${S}</c> into <c>${D}</c>. Ebuilds must <i>not</i> attempt to +perform any operation upon the live filesystem at this stage -- this will break +binaries, and will (often) cause a sandbox violation notice. +</p> + +<p> +When installing, portage will install the image in <c>${D}</c> into <c>${ROOT}</c>. By +default, <c>${ROOT}</c> points to <c>/</c>, although the user can alter this -- for +example, the user may be building a minimal image for another system in a +different location. If your package must operate on the live filesystem (for +example, to create some cache files during <c>pkg_postinst</c>), you must ensure +that you prefix any paths with <c>${ROOT}</c>. +</p> + +<p> +When inside <c>pkg_preinst</c>, the image to be installed can be accessed under +<c>"${IMAGE}"</c>. +</p> + +</body> +</chapter> +</guide> + |