summaryrefslogtreecommitdiff
path: root/docs/man
diff options
context:
space:
mode:
authorMiloslav Trmač <mitr@redhat.com>2013-04-18 21:14:08 +0200
committerMiloslav Trmač <mitr@redhat.com>2013-05-06 19:50:18 +0200
commit6859857757d7f4b8908970f12a12eee891d87dda (patch)
tree2e10029ab6e5fc41aacfff8f5f1a7e3b7cc3f423 /docs/man
parent31b138d17f259f2d06a86dbbd31202ef43dbfa41 (diff)
downloadpolkit-6859857757d7f4b8908970f12a12eee891d87dda.tar.gz
More warnings about using auth_self*
Suggested by Colin Walters. https://bugs.freedesktop.org/show_bug.cgi?id=57284
Diffstat (limited to 'docs/man')
-rw-r--r--docs/man/polkit.xml8
1 files changed, 6 insertions, 2 deletions
diff --git a/docs/man/polkit.xml b/docs/man/polkit.xml
index f8b4849..d30ee52 100644
--- a/docs/man/polkit.xml
+++ b/docs/man/polkit.xml
@@ -356,7 +356,9 @@ System Context | |
<term><literal>auth_self</literal></term>
<listitem><para>Authentication by the owner of the
session that the client originates from is
- required.</para></listitem>
+ required. Note that this is not restrictive enough for most
+ uses on multi-user systems; <literal>auth_admin</literal>* is
+ generally recommended.</para></listitem>
</varlistentry>
<varlistentry>
<term><literal>auth_admin</literal></term>
@@ -367,7 +369,9 @@ System Context | |
<term><literal>auth_self_keep</literal></term>
<listitem><para>Like <literal>auth_self</literal> but
the authorization is kept for a brief
- period (e.g. five minutes).</para></listitem>
+ period (e.g. five minutes). The warning about
+ <literal>auth_self</literal> above applies
+ likewise.</para></listitem>
</varlistentry>
<varlistentry>
<term><literal>auth_admin_keep</literal></term>