[pacman-dev] [PATCH 3/3] makepkg: document PACMAN_AUTH in config and manual pages

[Andres P]

Signed-off-by: Andres P <aepd87 at gmail.com>
---
 doc/makepkg.conf.5.txt |    7 +++++++
 etc/makepkg.conf.in    |   11 +++++++++++
 2 files changed, 18 insertions(+), 0 deletions(-)

diff --git a/doc/makepkg.conf.5.txt b/doc/makepkg.conf.5.txt
index 753b179..b9a0c67 100644
--- a/doc/makepkg.conf.5.txt
+++ b/doc/makepkg.conf.5.txt
@@ -195,6 +195,13 @@ Options
 *PKGEXT*, *SRCEXT*::
 	Do not touch these unless you know what you are doing.
 
+*PACMAN_AUTH*::
+	If makepkg needs to run pacman as root it will use the command specified in
+	this value to call pacman when the user is not UID 0.
+	+
+	If present, `%p` will be replaced with the environmental variable PACMAN and
+	whatever arguments makepkg needs to pass to PACMAN. Otherwise, both PACMAN
+	and its arguments will be appended to the end of the command.
 
 See Also
 --------
diff --git a/etc/makepkg.conf.in b/etc/makepkg.conf.in
index f0d1c44..b8252a7 100644
--- a/etc/makepkg.conf.in
+++ b/etc/makepkg.conf.in
@@ -112,4 +112,15 @@ PURGE_TARGETS=(usr/{,share}/info/dir .packlist *.pod)
 PKGEXT='@PKGEXT@'
 SRCEXT='@SRCEXT@'
 
+#########################################################################
+# PRIVILEGE ESCALATION OPTIONS
+#########################################################################
+#
+# Default: call pacman using sudo(8)
+#
+#-- Authentication: specify a command that should enable running pacman as root
+#                   when needed
+PACMAN_AUTH="sudo %p"
+#PACMAN_AUTH="su -c '%p'"
+
 # vim: set ft=sh ts=2 sw=2 et:
-- 
1.7.1