summaryrefslogtreecommitdiff
path: root/docs/polkit
diff options
context:
space:
mode:
authorDavid Zeuthen <davidz@redhat.com>2010-08-03 14:10:12 -0400
committerDavid Zeuthen <davidz@redhat.com>2010-08-03 14:10:12 -0400
commit7491b69e86cf7cb813c956307a96f246b386b16c (patch)
tree35f00c585b844953e6f8598be64316d8dab9243f /docs/polkit
parentb224c80463d7408e6d410f718686d609ab16d1c7 (diff)
downloadpolkit-7491b69e86cf7cb813c956307a96f246b386b16c.tar.gz
Remove Lock Down functionality
This is better implemented as a separate set of extension to the local authority. The only current known user, PolkitLockButton, will be ported away from using these interfaces. Since polkit still hasn't reached 1.0 this removal of functionality is OK especially since the NEWS file has already wanred something like this may happen. Signed-off-by: David Zeuthen <davidz@redhat.com>
Diffstat (limited to 'docs/polkit')
-rw-r--r--docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml53
-rw-r--r--docs/polkit/polkit-1-sections.txt11
2 files changed, 2 insertions, 62 deletions
diff --git a/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml b/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml
index 8b76fa2..cb9da6b 100644
--- a/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml
+++ b/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml
@@ -42,8 +42,6 @@ Structure <link linkend="eggdbus-struct-TemporaryAuthorization">TemporaryAuth
OUT Array&lt;<link linkend="eggdbus-struct-TemporaryAuthorization">TemporaryAuthorization</link>&gt; temporary_authorizations)
<link linkend="eggdbus-method-org.freedesktop.PolicyKit1.Authority.RevokeTemporaryAuthorizations">RevokeTemporaryAuthorizations</link> (IN <link linkend="eggdbus-struct-Subject">Subject</link> subject)
<link linkend="eggdbus-method-org.freedesktop.PolicyKit1.Authority.RevokeTemporaryAuthorizationById">RevokeTemporaryAuthorizationById</link> (IN String id)
-<link linkend="eggdbus-method-org.freedesktop.PolicyKit1.Authority.AddLockdownForAction">AddLockdownForAction</link> (IN String action_id)
-<link linkend="eggdbus-method-org.freedesktop.PolicyKit1.Authority.RemoveLockdownForAction">RemoveLockdownForAction</link> (IN String action_id)
</synopsis>
</refsynopsisdiv>
<refsect1 role="signal_proto" id="eggdbus-if-signals-org.freedesktop.PolicyKit1.Authority">
@@ -232,8 +230,7 @@ The passed <parameter>cancellation_id</parameter> is already in use.
<programlisting>
{
None = 0x00000000,
- TemporaryAuthorization = 0x00000001,
- Lockdown = 0x00000002
+ TemporaryAuthorization = 0x00000001
}
</programlisting>
<para>
@@ -256,14 +253,6 @@ The authority supports temporary authorizations that can be obtained through aut
</para>
</listitem>
</varlistentry>
- <varlistentry id="eggdbus-constant-AuthorityFeatures.Lockdown" role="constant">
- <term><literal>Lockdown</literal></term>
- <listitem>
- <para>
-The authority supports the <link linkend="eggdbus-method-org.freedesktop.PolicyKit1.Authority.AddLockdownForAction">AddLockdownForAction()</link> and <link linkend="eggdbus-method-org.freedesktop.PolicyKit1.Authority.RemoveLockdownForAction">RemoveLockdownForAction()</link> methods.
- </para>
- </listitem>
- </varlistentry>
</variablelist>
</para>
</refsect2>
@@ -472,7 +461,7 @@ TRUE if the given <link linkend="eggdbus-struct-Subject">Subject</link> could be
<term><literal>Dict&lt;String,String&gt; <structfield>details</structfield></literal></term>
<listitem>
<para>
-Details for the result or empty if not authorized. Known key/value-pairs include <literal>polkit.temporary_authorization_id</literal> (if the authorization is temporary, this is set to the opaque temporary authorization id), <literal>polkit.retains_authorization_after_challenge</literal> (Set to a non-empty string if the authorization will be retained after authentication (if is_challenge is TRUE)) and <literal>polkit.lockdown</literal> (set to a non-empty string if the action is locked down).
+Details for the result or empty if not authorized. Known key/value-pairs include <literal>polkit.temporary_authorization_id</literal> (if the authorization is temporary, this is set to the opaque temporary authorization id), <literal>polkit.retains_authorization_after_challenge</literal> (Set to a non-empty string if the authorization will be retained after authentication (if is_challenge is TRUE)).
</para>
</listitem>
</varlistentry>
@@ -811,44 +800,6 @@ The opaque identifier of the temporary authorization.
</varlistentry>
</variablelist>
</refsect2>
- <refsect2 role="function" id="eggdbus-method-org.freedesktop.PolicyKit1.Authority.AddLockdownForAction">
- <title>AddLockdownForAction ()</title>
- <programlisting>
-AddLockdownForAction (IN String action_id)
- </programlisting>
- <para>
-Locks down an action so administrator authentication is always needed to obtain a temporary authorization for the action.
- </para>
-<variablelist role="params">
- <varlistentry>
- <term><literal>IN String <parameter>action_id</parameter></literal>:</term>
- <listitem>
- <para>
-Identifier for the action.
- </para>
- </listitem>
- </varlistentry>
-</variablelist>
- </refsect2>
- <refsect2 role="function" id="eggdbus-method-org.freedesktop.PolicyKit1.Authority.RemoveLockdownForAction">
- <title>RemoveLockdownForAction ()</title>
- <programlisting>
-RemoveLockdownForAction (IN String action_id)
- </programlisting>
- <para>
-Removes the effect of a previous <link linkend="eggdbus-method-org.freedesktop.PolicyKit1.Authority.AddLockdownForAction">AddLockdownForAction()</link> call.
- </para>
-<variablelist role="params">
- <varlistentry>
- <term><literal>IN String <parameter>action_id</parameter></literal>:</term>
- <listitem>
- <para>
-Identifier for the action.
- </para>
- </listitem>
- </varlistentry>
-</variablelist>
- </refsect2>
</refsect1>
<refsect1 role="signals" id="eggdbus-if-signal-details-org.freedesktop.PolicyKit1.Authority">
<title role="signals.title">Signal Details</title>
diff --git a/docs/polkit/polkit-1-sections.txt b/docs/polkit/polkit-1-sections.txt
index 999abb2..b1b71cc 100644
--- a/docs/polkit/polkit-1-sections.txt
+++ b/docs/polkit/polkit-1-sections.txt
@@ -42,10 +42,6 @@ polkit_authority_revoke_temporary_authorizations
polkit_authority_revoke_temporary_authorizations_finish
polkit_authority_revoke_temporary_authorization_by_id
polkit_authority_revoke_temporary_authorization_by_id_finish
-polkit_authority_add_lockdown_for_action
-polkit_authority_add_lockdown_for_action_finish
-polkit_authority_remove_lockdown_for_action
-polkit_authority_remove_lockdown_for_action_finish
polkit_authority_check_authorization_sync
polkit_authority_enumerate_actions_sync
polkit_authority_register_authentication_agent_sync
@@ -54,8 +50,6 @@ polkit_authority_authentication_agent_response_sync
polkit_authority_enumerate_temporary_authorizations_sync
polkit_authority_revoke_temporary_authorizations_sync
polkit_authority_revoke_temporary_authorization_by_id_sync
-polkit_authority_add_lockdown_for_action_sync
-polkit_authority_remove_lockdown_for_action_sync
<SUBSECTION Standard>
PolkitAuthorityClass
POLKIT_AUTHORITY
@@ -75,7 +69,6 @@ polkit_authorization_result_get_is_authorized
polkit_authorization_result_get_is_challenge
polkit_authorization_result_get_retains_authorization
polkit_authorization_result_get_temporary_authorization_id
-polkit_authorization_result_get_locked_down
polkit_authorization_result_get_details
<SUBSECTION Standard>
PolkitAuthorizationResultClass
@@ -288,10 +281,6 @@ polkit_backend_authority_enumerate_actions
polkit_backend_authority_system_bus_name_owner_changed
polkit_backend_authority_enumerate_temporary_authorizations
polkit_backend_authority_revoke_temporary_authorizations
-polkit_backend_authority_add_lockdown_for_action
-polkit_backend_authority_add_lockdown_for_action_finish
-polkit_backend_authority_remove_lockdown_for_action
-polkit_backend_authority_remove_lockdown_for_action_finish
polkit_backend_authority_get
polkit_backend_authority_register
polkit_backend_authority_unregister