From 2dd284eb425535445f0be6e9dd7d45e8ccd3ffa6 Mon Sep 17 00:00:00 2001 From: David Zeuthen Date: Thu, 12 Apr 2012 13:54:27 -0400 Subject: Make it possible to influence agent registration with an a{sv} parameter Additionally, add a "fallback" option. Also add support in this in the pkttyagent(1) program. This slightly breaks libpolkit-backend API by adding a GVariant* param to one of the class vfuncs... but that API is already declared unstable so that's fine. Signed-off-by: David Zeuthen --- docs/man/pkttyagent.xml | 11 +++++++++++ ...-interface-org.freedesktop.PolicyKit1.Authority.xml | 18 ++++++++++++++++++ docs/polkit/polkit-1-sections.txt | 4 ++++ 3 files changed, 33 insertions(+) (limited to 'docs') diff --git a/docs/man/pkttyagent.xml b/docs/man/pkttyagent.xml index f0f328e..a5bab8a 100644 --- a/docs/man/pkttyagent.xml +++ b/docs/man/pkttyagent.xml @@ -56,6 +56,12 @@ + + + + + + @@ -78,6 +84,11 @@ program. This file descriptor will then be closed when the authentication agent has been successfully registered. + + If is used, the textual + authentication agent will not replace an existing authentication + agent. + diff --git a/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml b/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml index d4894f5..49173f8 100644 --- a/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml +++ b/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml @@ -34,6 +34,10 @@ Structure TemporaryAuth RegisterAuthenticationAgent (IN Subject subject, IN String locale, IN String object_path) +RegisterAuthenticationAgentWithOptions (IN Subject subject, + IN String locale, + IN String object_path, + IN Dict<String,Variant> options) UnregisterAuthenticationAgent (IN Subject subject, IN String object_path) AuthenticationAgentResponse (IN String cookie, @@ -724,6 +728,20 @@ The object path of authentication agent object on the unique name of the caller. + + + RegisterAuthenticationAgentWithOptions () + +RegisterAuthenticationAgent (IN Subject subject, + IN String locale, + IN String object_path, + IN Dict<String,Variant> options) + + +Like RegisterAuthenticationAgent but takes additional options. If the option fallback (of type Boolean) is TRUE, then the authentcation agent will only be used as a fallback, e.g. if another agent (without the fallback option set TRUE) is available, it will be used instead. + + + UnregisterAuthenticationAgent () diff --git a/docs/polkit/polkit-1-sections.txt b/docs/polkit/polkit-1-sections.txt index ff6a301..3881004 100644 --- a/docs/polkit/polkit-1-sections.txt +++ b/docs/polkit/polkit-1-sections.txt @@ -38,6 +38,9 @@ polkit_authority_enumerate_actions_sync polkit_authority_register_authentication_agent polkit_authority_register_authentication_agent_finish polkit_authority_register_authentication_agent_sync +polkit_authority_register_authentication_agent_with_options +polkit_authority_register_authentication_agent_with_options_finish +polkit_authority_register_authentication_agent_with_options_sync polkit_authority_unregister_authentication_agent polkit_authority_unregister_authentication_agent_finish polkit_authority_unregister_authentication_agent_sync @@ -394,6 +397,7 @@ polkit_agent_listener_initiate_authentication polkit_agent_listener_initiate_authentication_finish PolkitAgentRegisterFlags polkit_agent_listener_register +polkit_agent_listener_register_with_options polkit_agent_listener_unregister POLKIT_AGENT_LISTENER -- cgit v1.2.1