dpkg: Parse and set new DPKG_FORCE environment variable for subprocesses

This will make it possible for third-party tools, and also for other
dpkg tools to have access to the force options specified for dpkg.

Closes: #666147

1 files changed, 9 insertions, 0 deletions

diff --git a/man/dpkg.man b/man/dpkg.man
index 5e4bc6946..bf56510ed 100644
--- a/man/dpkg.man
+++ b/man/dpkg.man
@@ -911,6 +911,11 @@ Sets the color mode (since dpkg 1.18.5).
 The currently accepted values are: \fBauto\fP (default), \fBalways\fP and
 \fBnever\fP.
 .TP
+.B DPKG_FORCE
+Sets the force flags (since dpkg 1.19.5).
+When this variable is present, no built-in force defaults will be applied.
+If the variable is present but empty, all force flags will be disabled.
+.TP
 .B DPKG_FRONTEND_LOCKED
 Set by a package manager frontend to notify dpkg that it should not acquire
 the frontend lock (since dpkg 1.19.1).
@@ -941,6 +946,10 @@ Defined by \fBdpkg\fP on the maintainer script environment to indicate
 the \fBdpkg\fP administrative directory to use (since dpkg 1.16.0).
 This variable is always set to the current \fB\-\-admindir\fP value.
 .TP
+.B DPKG_FORCE
+Defined by \fBdpkg\fP on the subprocesses environment to all the currently
+enabled force option names separated by commas (since dpkg 1.19.5).
+.TP
 .B DPKG_SHELL_REASON
 Defined by \fBdpkg\fP on the shell spawned on the conffile prompt to
 examine the situation (since dpkg 1.15.6).