summaryrefslogtreecommitdiff
path: root/docs/man/polkit.xml
diff options
context:
space:
mode:
authorDavid Zeuthen <davidz@redhat.com>2012-04-11 13:15:48 -0400
committerDavid Zeuthen <davidz@redhat.com>2012-04-11 15:45:17 -0400
commitbda0fc1de3361fc6f377d041ce2088118048fdf7 (patch)
tree382c1020b2aff311e7e9aa866130b45d692a6031 /docs/man/polkit.xml
parent4aa6dd28476e12a5265d71b6bc19c730f1036785 (diff)
downloadpolkit-bda0fc1de3361fc6f377d041ce2088118048fdf7.tar.gz
Add pkttyagent(1) helper
This came up while working on https://bugzilla.redhat.com/show_bug.cgi?id=804088 and is useful for example if it's not suitable or appropriate to link against the polkit libraries. Signed-off-by: David Zeuthen <davidz@redhat.com>
Diffstat (limited to 'docs/man/polkit.xml')
-rw-r--r--docs/man/polkit.xml15
1 files changed, 15 insertions, 0 deletions
diff --git a/docs/man/polkit.xml b/docs/man/polkit.xml
index ae67f7c..188c514 100644
--- a/docs/man/polkit.xml
+++ b/docs/man/polkit.xml
@@ -223,6 +223,18 @@ System Context | |
implemention for systems without a <literal>root</literal>
account.
</para>
+
+ <para>
+ Applications that do not run under a desktop environment (for
+ example, if launched from a
+ <citerefentry><refentrytitle>ssh</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+ login) may not have have an authentication agent associated with
+ them. Such applications may use the <link
+ linkend="PolkitAgentTextListener-struct">PolkitAgentTextListener</link>
+ type or the
+ <citerefentry><refentrytitle>pkttyagent</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+ helper so the user can authenticate using a textual interface.
+ </para>
</refsect1>
<refsect1 id="polkit-declaring-actions"><title>DECLARING ACTIONS</title>
@@ -469,6 +481,9 @@ System Context | |
<citerefentry>
<refentrytitle>pkexec</refentrytitle><manvolnum>1</manvolnum>
</citerefentry>,
+ <citerefentry>
+ <refentrytitle>pkttyagent</refentrytitle><manvolnum>1</manvolnum>
+ </citerefentry>
</para>
</refsect1>
</refentry>