diff options
| author | David Zeuthen <zeuthen@gmail.com> | 2012-06-07 11:43:20 -0400 |
|---|---|---|
| committer | David Zeuthen <zeuthen@gmail.com> | 2012-06-07 11:43:20 -0400 |
| commit | 84e42887d413cba0039f92f0c56a25c70c20fe6e (patch) | |
| tree | 61c78f5407def5ef5f94cf2069085e113fbeeb39 | |
| parent | d81f4d16ab96c4084bf20c7174ac6fb16f69c402 (diff) | |
| download | polkit-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.xml | 22 |
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> |