summaryrefslogtreecommitdiff
path: root/policy
diff options
context:
space:
mode:
authorSean Whitton <spwhitton@spwhitton.name>2018-11-10 20:35:43 -0700
committerSean Whitton <spwhitton@spwhitton.name>2018-11-10 20:35:43 -0700
commit36e5d7b95370ce85c20478154aff777ad7ac5c96 (patch)
tree29681a6c8c85269a5343d24dbe03067206bab0b5 /policy
parent433030796e5a8d284c89602568658b71f69e02ac (diff)
permit source packages to output .debs to the parent directory
Diffstat (limited to 'policy')
-rw-r--r--policy/ch-source.rst15
1 files changed, 9 insertions, 6 deletions
diff --git a/policy/ch-source.rst b/policy/ch-source.rst
index 8087988..3c6c9d5 100644
--- a/policy/ch-source.rst
+++ b/policy/ch-source.rst
@@ -292,15 +292,18 @@ network access, except, via the loopback interface, to services on the
build host that have been started by the build.
Required targets must not attempt to write outside of the unpacked
-source package tree. As an exception, required targets may write to
+source package tree. There are two exceptions. Firstly, the binary
+targets may write the binary packages to the parent directory of the
+unpacked source package tree. Secondly, required targets may write to
the directory specified by the ``TMPDIR`` environment variable (or
``/tmp`` if that is not set), provided that files created in that
directory are deleted before the target completes and are not reused
-by subsequent executions of the target. This restriction is intended
-to prevent source package builds creating and depending on state
-outside of themselves, thus affecting multiple independent rebuilds.
-In particular, the required targets must not attempt to write into
-``HOME``.
+by subsequent executions of the target.
+
+This restriction is intended to prevent source package builds creating
+and depending on state outside of themselves, thus affecting multiple
+independent rebuilds. In particular, the required targets must not
+attempt to write into ``HOME``.
The targets are as follows: