diff options
Diffstat (limited to 'doc/rootless-builds.txt')
| -rw-r--r-- | doc/rootless-builds.txt | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/rootless-builds.txt b/doc/rootless-builds.txt index 68617d5b4..a17a5ad17 100644 --- a/doc/rootless-builds.txt +++ b/doc/rootless-builds.txt @@ -52,6 +52,15 @@ The values are defined as: a command, it MUST behave like "Rules-Requires-Root" was set to "binary-targets", i.e. run "debian/rules binary" under (fake)root. +When the builder supports this specification, it MUST notify this fact to +the rules file via the "DEB_RULES_REQUIRES_ROOT" environment variable, with +the value it has obtained from the Rules-Requires-Root field or some builder +specific override mechanism, which will denote the level of support the +builder has choosen to commit to take effect during the build. When set, +it MUST be a valid value for the Rules-Requires-Root field. If unset, +the build system SHOULD assume that the builder does not recognize the +Rules-Requires-Root field at all. + It is always permissible for a builder to ignore this field and fall back to running the binary targets under (fake)root. This is to ensure backwards compatibility when builds are performed by legacy builders or older versions |