summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Zeuthen <zeuthen@gmail.com>2012-06-07 11:43:20 -0400
committerDavid Zeuthen <zeuthen@gmail.com>2012-06-07 11:43:20 -0400
commit84e42887d413cba0039f92f0c56a25c70c20fe6e (patch)
tree61c78f5407def5ef5f94cf2069085e113fbeeb39
parentd81f4d16ab96c4084bf20c7174ac6fb16f69c402 (diff)
downloadpolkit-84e42887d413cba0039f92f0c56a25c70c20fe6e.tar.gz
docs: add a "make sure your app works when there's no polkitd(8)" note
Signed-off-by: David Zeuthen <zeuthen@gmail.com>
-rw-r--r--docs/polkit/overview.xml22
1 files changed, 22 insertions, 0 deletions
diff --git a/docs/polkit/overview.xml b/docs/polkit/overview.xml
index a979172..0639d30 100644
--- a/docs/polkit/overview.xml
+++ b/docs/polkit/overview.xml
@@ -103,6 +103,28 @@
</para>
</listitem>
+ <listitem>
+ <para>
+ <emphasis role='bold'>DO</emphasis> make sure
+ your application works even when the
+ <literal>org.freedesktop.PolicyKit1</literal>
+ D-Bus service is not available (this can
+ happen if
+ <link linkend="polkitd.8"><citerefentry><refentrytitle>polkitd</refentrytitle><manvolnum>8</manvolnum></citerefentry></link>
+ is not installed or if the <emphasis>polkit.service</emphasis> systemd unit/service has been
+ <ulink url="http://0pointer.de/blog/projects/three-levels-of-off.html">masked</ulink>). If you are using the
+ <link linkend="ref-api">libpolkit-gobject-1</link> library this
+ means handling
+ <link linkend="polkit-authority-get-sync">polkit_authority_get_sync()</link>
+ or
+ <link linkend="polkit-authority-get-finish">polkit_authority_get_finish()</link>
+ returning <constant>NULL</constant>.
+ An appropriate way of dealing with the polkit authority
+ not being available, could be to allow only uid 0 to
+ perform operations, forbid all operations or something
+ else.
+ </para>
+ </listitem>
<listitem>
<para>