From 3f2b970e28bd10e8cac93673e2f250406e84ccb9 Mon Sep 17 00:00:00 2001
From: David Zeuthen <davidz@redhat.com>
Date: Sun, 20 May 2012 15:04:03 -0400
Subject: Also add an example of polkit.spawn() to polkit(8) man page

Signed-off-by: David Zeuthen <davidz@redhat.com>
---
 docs/man/polkit.xml | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/docs/man/polkit.xml b/docs/man/polkit.xml
index 7634a44..bbe44f7 100644
--- a/docs/man/polkit.xml
+++ b/docs/man/polkit.xml
@@ -679,6 +679,26 @@ polkit.addRule(function(action, subject, details) {
         }
     }
 });
+]]></programlisting>
+
+      <para>
+        Run an external helper to determine if the current user may reboot the system:
+      </para>
+      <programlisting><![CDATA[
+polkit.addRule(function(action, subject, details) {
+    if (action.indexOf("org.freedesktop.login1.reboot") == 0) {
+        try {
+            // user-may-reboot exits with succeess (exit code 0)
+            // only if the passed username is authorized
+            polkit.spawn(["/opt/company/bin/user-may-reboot",
+                          subject.user]);
+            return "yes";
+        } catch (error) {
+            // Nope, but do allow admin authentication
+            return "auth_admin";
+        }
+    }
+});
 ]]></programlisting>
 
     </refsect2>
-- 
cgit v1.2.1