From 986d7c293c6b35899a1e7bc6437f18775220dc47 Mon Sep 17 00:00:00 2001 From: David Zeuthen Date: Tue, 22 Feb 2011 16:49:44 -0500 Subject: =?UTF-8?q?Bug=2030653=20=E2=80=93=20No=20way=20to=20detect=20canc?= =?UTF-8?q?ellation=20in=20pkexec?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit https://bugs.freedesktop.org/show_bug.cgi?id=30653 Signed-off-by: David Zeuthen --- docs/man/pkexec.xml | 5 ++++- ...rg.freedesktop.PolicyKit1.AuthenticationAgent.xml | 20 ++++++++++++++++++-- ...nterface-org.freedesktop.PolicyKit1.Authority.xml | 2 +- docs/polkit/polkit-1-sections.txt | 1 + 4 files changed, 24 insertions(+), 4 deletions(-) (limited to 'docs') diff --git a/docs/man/pkexec.xml b/docs/man/pkexec.xml index 6f5dc9c..97ab315 100644 --- a/docs/man/pkexec.xml +++ b/docs/man/pkexec.xml @@ -61,7 +61,10 @@ of PROGRAM. If the calling process is not authorized or an authorization could not be obtained through authentication or an error occured, pkexec - exits with a return value of 127. + exits with a return value of 127. If the authorization could not + be obtained because the user dismissed the authentication + dialog, pkexec exits with a return value of + 126. diff --git a/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.AuthenticationAgent.xml b/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.AuthenticationAgent.xml index 663169e..b01fceb 100644 --- a/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.AuthenticationAgent.xml +++ b/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.AuthenticationAgent.xml @@ -40,8 +40,24 @@ BeginAuthentication (IN String action_id, IN Array<Identity> identities) -Called by the PolicyKit daemon when the authentication agent needs the user to authenticate as one of the identities in identities for the action with the identifier action_id.Upon succesful authentication, the authentication agent must invoke the AuthenticationAgentResponse() method on the org.freedesktop.PolicyKit1.Authority interface of the PolicyKit daemon before returning.If the user dismisses the authentication dialog, the authentication agent should return an error. + + Called by the PolicyKit daemon when the authentication agent + needs the user to authenticate as one of the identities in + identities for the action with the + identifier action_id.Upon + succesful authentication, the authentication agent must invoke + the AuthenticationAgentResponse() + method on the org.freedesktop.PolicyKit1.Authority + interface of the PolicyKit daemon before returning. + + + The authentication agent should not return until after authentication is complete. + If the user dismisses the authentication dialog, the authentication agent should return the org.freedesktop.PolicyKit1.Error.Cancelled error. + + IN String action_id: @@ -71,7 +87,7 @@ The themed icon describing the action or the empty string if no icon is set. IN Dict<String,String> details: -Details about the authentication request. This is a dictionary of key/value pairs where both key and value are strings. These strings are translated into the locale passed when registering the authentication agent using RegisterAuthenticationAgent().. +Details about the authentication request. This is a dictionary of key/value pairs where both key and value are strings. These strings are translated into the locale passed when registering the authentication agent using RegisterAuthenticationAgent(). Keys starting with polkit. are reserved for internal use and should never be displayed in the UI. Known key/value-pairs include polkit.caller-pid (the process id of the mechanism making the authorization check) and polkit.subject-pid (the process id of the subject the check is for). diff --git a/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml b/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml index cb9da6b..93f8cfa 100644 --- a/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml +++ b/docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml @@ -461,7 +461,7 @@ TRUE if the given Subject could be Dict<String,String> details -Details for the result or empty if not authorized. Known key/value-pairs include polkit.temporary_authorization_id (if the authorization is temporary, this is set to the opaque temporary authorization id), polkit.retains_authorization_after_challenge (Set to a non-empty string if the authorization will be retained after authentication (if is_challenge is TRUE)). +Details for the result or empty if not authorized. Known key/value-pairs include polkit.temporary_authorization_id (if the authorization is temporary, this is set to the opaque temporary authorization id), polkit.retains_authorization_after_challenge (Set to a non-empty string if the authorization will be retained after authentication (if is_challenge is TRUE)), polkit.dismissed (Set to a non-empty string if the authentication dialog was dismissed by the user). diff --git a/docs/polkit/polkit-1-sections.txt b/docs/polkit/polkit-1-sections.txt index 78248dc..12141e3 100644 --- a/docs/polkit/polkit-1-sections.txt +++ b/docs/polkit/polkit-1-sections.txt @@ -71,6 +71,7 @@ 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_dismissed polkit_authorization_result_get_details PolkitAuthorizationResultClass -- cgit v1.2.1