PolkitAuthority

PolkitAuthority — Authority

Stability Level

Stable, unless otherwise indicated

Synopsis

                    PolkitAuthority;
enum                PolkitAuthorityFeatures;
enum                PolkitCheckAuthorizationFlags;
void                polkit_authority_get_async          (GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);
PolkitAuthority *   polkit_authority_get_finish         (GAsyncResult *res,
                                                         GError **error);
PolkitAuthority *   polkit_authority_get_sync           (GCancellable *cancellable,
                                                         GError **error);
gchar *             polkit_authority_get_owner          (PolkitAuthority *authority);
const gchar *       polkit_authority_get_backend_name   (PolkitAuthority *authority);
const gchar *       polkit_authority_get_backend_version
                                                        (PolkitAuthority *authority);
PolkitAuthorityFeatures polkit_authority_get_backend_features
                                                        (PolkitAuthority *authority);
void                polkit_authority_check_authorization
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *action_id,
                                                         PolkitDetails *details,
                                                         PolkitCheckAuthorizationFlags flags,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);
PolkitAuthorizationResult * polkit_authority_check_authorization_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);
PolkitAuthorizationResult * polkit_authority_check_authorization_sync
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *action_id,
                                                         PolkitDetails *details,
                                                         PolkitCheckAuthorizationFlags flags,
                                                         GCancellable *cancellable,
                                                         GError **error);
void                polkit_authority_enumerate_actions  (PolkitAuthority *authority,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);
GList *             polkit_authority_enumerate_actions_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);
GList *             polkit_authority_enumerate_actions_sync
                                                        (PolkitAuthority *authority,
                                                         GCancellable *cancellable,
                                                         GError **error);
void                polkit_authority_register_authentication_agent
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *locale,
                                                         const gchar *object_path,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);
gboolean            polkit_authority_register_authentication_agent_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);
gboolean            polkit_authority_register_authentication_agent_sync
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *locale,
                                                         const gchar *object_path,
                                                         GCancellable *cancellable,
                                                         GError **error);
void                polkit_authority_register_authentication_agent_with_options
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *locale,
                                                         const gchar *object_path,
                                                         GVariant *options,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);
gboolean            polkit_authority_register_authentication_agent_with_options_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);
gboolean            polkit_authority_register_authentication_agent_with_options_sync
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *locale,
                                                         const gchar *object_path,
                                                         GVariant *options,
                                                         GCancellable *cancellable,
                                                         GError **error);
void                polkit_authority_unregister_authentication_agent
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *object_path,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);
gboolean            polkit_authority_unregister_authentication_agent_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);
gboolean            polkit_authority_unregister_authentication_agent_sync
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *object_path,
                                                         GCancellable *cancellable,
                                                         GError **error);
void                polkit_authority_authentication_agent_response
                                                        (PolkitAuthority *authority,
                                                         const gchar *cookie,
                                                         PolkitIdentity *identity,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);
gboolean            polkit_authority_authentication_agent_response_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);
gboolean            polkit_authority_authentication_agent_response_sync
                                                        (PolkitAuthority *authority,
                                                         const gchar *cookie,
                                                         PolkitIdentity *identity,
                                                         GCancellable *cancellable,
                                                         GError **error);
void                polkit_authority_enumerate_temporary_authorizations
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);
GList *             polkit_authority_enumerate_temporary_authorizations_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);
GList *             polkit_authority_enumerate_temporary_authorizations_sync
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         GCancellable *cancellable,
                                                         GError **error);
void                polkit_authority_revoke_temporary_authorizations
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);
gboolean            polkit_authority_revoke_temporary_authorizations_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);
gboolean            polkit_authority_revoke_temporary_authorizations_sync
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         GCancellable *cancellable,
                                                         GError **error);
void                polkit_authority_revoke_temporary_authorization_by_id
                                                        (PolkitAuthority *authority,
                                                         const gchar *id,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);
gboolean            polkit_authority_revoke_temporary_authorization_by_id_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);
gboolean            polkit_authority_revoke_temporary_authorization_by_id_sync
                                                        (PolkitAuthority *authority,
                                                         const gchar *id,
                                                         GCancellable *cancellable,
                                                         GError **error);

Object Hierarchy

  GObject
   +----PolkitAuthority
  GFlags
   +----PolkitAuthorityFeatures
  GFlags
   +----PolkitCheckAuthorizationFlags

Implemented Interfaces

PolkitAuthority implements GInitable and GAsyncInitable.

Properties

  "backend-features"         PolkitAuthorityFeatures  : Read
  "backend-name"             gchar*                : Read
  "backend-version"          gchar*                : Read
  "owner"                    gchar*                : Read

Signals

  "changed"                                        : Run Last

Description

PolkitAuthority is used for checking whether a given subject is authorized to perform a given action. Typically privileged system daemons or suid helpers will use this when handling requests from untrusted clients.

User sessions can register an authentication agent with the authority. This is used for requests from untrusted clients where system policy requires that the user needs to acknowledge (through proving he is the user or the administrator) a given action. See PolkitAgentListener and PolkitAgentSession for details.

Details

PolkitAuthority

typedef struct _PolkitAuthority PolkitAuthority;

The PolkitAuthority struct should not be accessed directly.


enum PolkitAuthorityFeatures

typedef enum {
  POLKIT_AUTHORITY_FEATURES_NONE                    = 0,
  POLKIT_AUTHORITY_FEATURES_TEMPORARY_AUTHORIZATION = (1<<0),
} PolkitAuthorityFeatures;

Flags describing features supported by the Authority implementation.

POLKIT_AUTHORITY_FEATURES_NONE

No flags set.

POLKIT_AUTHORITY_FEATURES_TEMPORARY_AUTHORIZATION

The authority supports temporary authorizations that can be obtained through authentication.

enum PolkitCheckAuthorizationFlags

typedef enum {
  POLKIT_CHECK_AUTHORIZATION_FLAGS_NONE = 0,
  POLKIT_CHECK_AUTHORIZATION_FLAGS_ALLOW_USER_INTERACTION = (1<<0),
} PolkitCheckAuthorizationFlags;

Possible flags when checking authorizations.

POLKIT_CHECK_AUTHORIZATION_FLAGS_NONE

No flags set.

POLKIT_CHECK_AUTHORIZATION_FLAGS_ALLOW_USER_INTERACTION

If the subject can obtain the authorization through authentication, and an authentication agent is available, then attempt to do so. Note, this means that the method used for checking authorization is likely to block for a long time.

polkit_authority_get_async ()

void                polkit_authority_get_async          (GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);

Asynchronously gets a reference to the authority.

This is an asynchronous failable function. When the result is ready, callback will be invoked in the thread-default main loop of the thread you are calling this method from and you can use polkit_authority_get_finish() to get the result. See polkit_authority_get_sync() for the synchronous version.

cancellable :

A GCancellable or NULL. [allow-none]

callback :

A GAsyncReadyCallback to call when the request is satisfied.

user_data :

The data to pass to callback.

polkit_authority_get_finish ()

PolkitAuthority *   polkit_authority_get_finish         (GAsyncResult *res,
                                                         GError **error);

Finishes an operation started with polkit_authority_get_async().

res :

A GAsyncResult obtained from the GAsyncReadyCallback passed to polkit_authority_get_async().

error :

Return location for error or NULL. [allow-none]

Returns :

A PolkitAuthority. Free it with g_object_unref() when done with it. [transfer full]

polkit_authority_get_sync ()

PolkitAuthority *   polkit_authority_get_sync           (GCancellable *cancellable,
                                                         GError **error);

Synchronously gets a reference to the authority.

This is a synchronous failable function - the calling thread is blocked until a reply is received. See polkit_authority_get_async() for the asynchronous version.

cancellable :

A GCancellable or NULL. [allow-none]

error :

Return location for error or NULL. [allow-none]

Returns :

A PolkitAuthority. Free it with g_object_unref() when done with it. [transfer full]

polkit_authority_get_owner ()

gchar *             polkit_authority_get_owner          (PolkitAuthority *authority);

The unique name on the system message bus of the owner of the name org.freedesktop.PolicyKit1 or NULL if no-one currently owns the name. You may connect to the "notify" signal to track changes to the "owner" property.

authority :

A PolkitAuthority.

Returns :

NULL or a string that should be freed with g_free(). [allow-none]

polkit_authority_get_backend_name ()

const gchar *       polkit_authority_get_backend_name   (PolkitAuthority *authority);

Gets the name of the authority backend.

authority :

A PolkitAuthority.

Returns :

The name of the backend.

polkit_authority_get_backend_version ()

const gchar *       polkit_authority_get_backend_version
                                                        (PolkitAuthority *authority);

Gets the version of the authority backend.

authority :

A PolkitAuthority.

Returns :

The version string for the backend.

polkit_authority_get_backend_features ()

PolkitAuthorityFeatures polkit_authority_get_backend_features
                                                        (PolkitAuthority *authority);

Gets the features supported by the authority backend.

authority :

A PolkitAuthority.

Returns :

Flags from PolkitAuthorityFeatures.

polkit_authority_check_authorization ()

void                polkit_authority_check_authorization
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *action_id,
                                                         PolkitDetails *details,
                                                         PolkitCheckAuthorizationFlags flags,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);

Asynchronously checks if subject is authorized to perform the action represented by action_id.

Note that POLKIT_CHECK_AUTHORIZATION_FLAGS_ALLOW_USER_INTERACTION SHOULD be passed ONLY if the event that triggered the authorization check is stemming from an user action, e.g. the user pressing a button or attaching a device.

When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from. You can then call polkit_authority_check_authorization_finish() to get the result of the operation.

Known keys in details include polkit.message and polkit.gettext_domain that can be used to override the message shown to the user. See the documentation for the D-Bus method for more details.

If details is non-empty then the request will fail with POLKIT_ERROR_FAILED unless the process doing the check itsef is sufficiently authorized (e.g. running as uid 0).

authority :

A PolkitAuthority.

subject :

A PolkitSubject.

action_id :

The action to check for.

details :

Details about the action or NULL. [allow-none]

flags :

A set of PolkitCheckAuthorizationFlags.

cancellable :

A GCancellable or NULL. [allow-none]

callback :

A GAsyncReadyCallback to call when the request is satisfied.

user_data :

The data to pass to callback.

polkit_authority_check_authorization_finish ()

PolkitAuthorizationResult * polkit_authority_check_authorization_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);

Finishes checking if a subject is authorized for an action.

authority :

A PolkitAuthority.

res :

A GAsyncResult obtained from the callback.

error :

Return location for error or NULL. [allow-none]

Returns :

A PolkitAuthorizationResult or NULL if error is set. Free with g_object_unref(). [transfer full]

polkit_authority_check_authorization_sync ()

PolkitAuthorizationResult * polkit_authority_check_authorization_sync
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *action_id,
                                                         PolkitDetails *details,
                                                         PolkitCheckAuthorizationFlags flags,
                                                         GCancellable *cancellable,
                                                         GError **error);

Checks if subject is authorized to perform the action represented by action_id.

Note that POLKIT_CHECK_AUTHORIZATION_FLAGS_ALLOW_USER_INTERACTION SHOULD be passed ONLY if the event that triggered the authorization check is stemming from an user action, e.g. the user pressing a button or attaching a device.

Note the calling thread is blocked until a reply is received. You should therefore NEVER do this from a GUI thread or a daemon service thread when using the POLKIT_CHECK_AUTHORIZATION_FLAGS_ALLOW_USER_INTERACTION flag. This is because it may potentially take minutes (or even hours) for the operation to complete because it involves waiting for the user to authenticate.

Known keys in details include polkit.message and polkit.gettext_domain that can be used to override the message shown to the user. See the documentation for the D-Bus method for more details.

authority :

A PolkitAuthority.

subject :

A PolkitSubject.

action_id :

The action to check for.

details :

Details about the action or NULL. [allow-none]

flags :

A set of PolkitCheckAuthorizationFlags.

cancellable :

A GCancellable or NULL. [allow-none]

error :

Return location for error or NULL. [allow-none]

Returns :

A PolkitAuthorizationResult or NULL if error is set. Free with g_object_unref(). [transfer full]

polkit_authority_enumerate_actions ()

void                polkit_authority_enumerate_actions  (PolkitAuthority *authority,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);

Asynchronously retrieves all registered actions.

When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from. You can then call polkit_authority_enumerate_actions_finish() to get the result of the operation.

authority :

A PolkitAuthority.

cancellable :

A GCancellable or NULL. [allow-none]

callback :

A GAsyncReadyCallback to call when the request is satisfied.

user_data :

The data to pass to callback.

polkit_authority_enumerate_actions_finish ()

GList *             polkit_authority_enumerate_actions_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);

Finishes retrieving all registered actions.

authority :

A PolkitAuthority.

res :

A GAsyncResult obtained from the callback.

error :

Return location for error or NULL. [allow-none]

Returns :

A list of PolkitActionDescription objects or NULL if error is set. The returned list should be freed with g_list_free() after each element have been freed with g_object_unref(). [transfer full]

polkit_authority_enumerate_actions_sync ()

GList *             polkit_authority_enumerate_actions_sync
                                                        (PolkitAuthority *authority,
                                                         GCancellable *cancellable,
                                                         GError **error);

Synchronously retrieves all registered actions - the calling thread is blocked until a reply is received. See polkit_authority_enumerate_actions() for the asynchronous version.

authority :

A PolkitAuthority.

cancellable :

A GCancellable or NULL. [allow-none]

error :

Return location for error or NULL. [allow-none]

Returns :

A list of PolkitActionDescription or NULL if error is set. The returned list should be freed with g_list_free() after each element have been freed with g_object_unref(). [transfer full]

polkit_authority_register_authentication_agent ()

void                polkit_authority_register_authentication_agent
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *locale,
                                                         const gchar *object_path,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);

Asynchronously registers an authentication agent.

When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from. You can then call polkit_authority_register_authentication_agent_finish() to get the result of the operation.

authority :

A PolkitAuthority.

subject :

The subject the authentication agent is for, typically a PolkitUnixSession object.

locale :

The locale of the authentication agent.

object_path :

The object path for the authentication agent.

cancellable :

A GCancellable or NULL. [allow-none]

callback :

A GAsyncReadyCallback to call when the request is satisfied.

user_data :

The data to pass to callback.

polkit_authority_register_authentication_agent_finish ()

gboolean            polkit_authority_register_authentication_agent_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);

Finishes registering an authentication agent.

authority :

A PolkitAuthority.

res :

A GAsyncResult obtained from the callback.

error :

Return location for error or NULL. [allow-none]

Returns :

TRUE if the authentication agent was successfully registered, FALSE if error is set.

polkit_authority_register_authentication_agent_sync ()

gboolean            polkit_authority_register_authentication_agent_sync
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *locale,
                                                         const gchar *object_path,
                                                         GCancellable *cancellable,
                                                         GError **error);

Registers an authentication agent. The calling thread is blocked until a reply is received. See polkit_authority_register_authentication_agent() for the asynchronous version.

authority :

A PolkitAuthority.

subject :

The subject the authentication agent is for, typically a PolkitUnixSession object.

locale :

The locale of the authentication agent.

object_path :

The object path for the authentication agent.

cancellable :

A GCancellable or NULL. [allow-none]

error :

Return location for error or NULL. [allow-none]

Returns :

TRUE if the authentication agent was successfully registered, FALSE if error is set.

polkit_authority_register_authentication_agent_with_options ()

void                polkit_authority_register_authentication_agent_with_options
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *locale,
                                                         const gchar *object_path,
                                                         GVariant *options,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);

Asynchronously registers an authentication agent.

When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from. You can then call polkit_authority_register_authentication_agent_with_options_finish() to get the result of the operation.

authority :

A PolkitAuthority.

subject :

The subject the authentication agent is for, typically a PolkitUnixSession object.

locale :

The locale of the authentication agent.

object_path :

The object path for the authentication agent.

options :

A GVariant with options or NULL. [allow-none]

cancellable :

A GCancellable or NULL. [allow-none]

callback :

A GAsyncReadyCallback to call when the request is satisfied.

user_data :

The data to pass to callback.

polkit_authority_register_authentication_agent_with_options_finish ()

gboolean            polkit_authority_register_authentication_agent_with_options_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);

Finishes registering an authentication agent.

authority :

A PolkitAuthority.

res :

A GAsyncResult obtained from the callback.

error :

Return location for error or NULL. [allow-none]

Returns :

TRUE if the authentication agent was successfully registered, FALSE if error is set.

polkit_authority_register_authentication_agent_with_options_sync ()

gboolean            polkit_authority_register_authentication_agent_with_options_sync
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *locale,
                                                         const gchar *object_path,
                                                         GVariant *options,
                                                         GCancellable *cancellable,
                                                         GError **error);

Registers an authentication agent. The calling thread is blocked until a reply is received. See polkit_authority_register_authentication_agent_with_options() for the asynchronous version.

authority :

A PolkitAuthority.

subject :

The subject the authentication agent is for, typically a PolkitUnixSession object.

locale :

The locale of the authentication agent.

object_path :

The object path for the authentication agent.

options :

A GVariant with options or NULL. [allow-none]

cancellable :

A GCancellable or NULL. [allow-none]

error :

Return location for error or NULL. [allow-none]

Returns :

TRUE if the authentication agent was successfully registered, FALSE if error is set.

polkit_authority_unregister_authentication_agent ()

void                polkit_authority_unregister_authentication_agent
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *object_path,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);

Asynchronously unregisters an authentication agent.

When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from. You can then call polkit_authority_unregister_authentication_agent_finish() to get the result of the operation.

authority :

A PolkitAuthority.

subject :

The subject the authentication agent is for, typically a PolkitUnixSession object.

object_path :

The object path for the authentication agent.

cancellable :

A GCancellable or NULL. [allow-none]

callback :

A GAsyncReadyCallback to call when the request is satisfied.

user_data :

The data to pass to callback.

polkit_authority_unregister_authentication_agent_finish ()

gboolean            polkit_authority_unregister_authentication_agent_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);

Finishes unregistering an authentication agent.

authority :

A PolkitAuthority.

res :

A GAsyncResult obtained from the callback.

error :

Return location for error or NULL. [allow-none]

Returns :

TRUE if the authentication agent was successfully unregistered, FALSE if error is set.

polkit_authority_unregister_authentication_agent_sync ()

gboolean            polkit_authority_unregister_authentication_agent_sync
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         const gchar *object_path,
                                                         GCancellable *cancellable,
                                                         GError **error);

Unregisters an authentication agent. The calling thread is blocked until a reply is received. See polkit_authority_unregister_authentication_agent() for the asynchronous version.

authority :

A PolkitAuthority.

subject :

The subject the authentication agent is for, typically a PolkitUnixSession object.

object_path :

The object path for the authentication agent.

cancellable :

A GCancellable or NULL. [allow-none]

error :

Return location for error or NULL. [allow-none]

Returns :

TRUE if the authentication agent was successfully unregistered, FALSE if error is set.

polkit_authority_authentication_agent_response ()

void                polkit_authority_authentication_agent_response
                                                        (PolkitAuthority *authority,
                                                         const gchar *cookie,
                                                         PolkitIdentity *identity,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);

Asynchronously provide response that identity successfully authenticated for the authentication request identified by cookie.

This function is only used by the privileged bits of an authentication agent. It will fail if the caller is not sufficiently privileged (typically uid 0).

When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from. You can then call polkit_authority_authentication_agent_response_finish() to get the result of the operation.

authority :

A PolkitAuthority.

cookie :

The cookie passed to the authentication agent from the authority.

identity :

The identity that was authenticated.

cancellable :

A GCancellable or NULL. [allow-none]

callback :

A GAsyncReadyCallback to call when the request is satisfied.

user_data :

The data to pass to callback.

polkit_authority_authentication_agent_response_finish ()

gboolean            polkit_authority_authentication_agent_response_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);

Finishes providing response from an authentication agent.

authority :

A PolkitAuthority.

res :

A GAsyncResult obtained from the callback.

error :

Return location for error or NULL. [allow-none]

Returns :

TRUE if authority acknowledged the call, FALSE if error is set.

polkit_authority_authentication_agent_response_sync ()

gboolean            polkit_authority_authentication_agent_response_sync
                                                        (PolkitAuthority *authority,
                                                         const gchar *cookie,
                                                         PolkitIdentity *identity,
                                                         GCancellable *cancellable,
                                                         GError **error);

Provide response that identity successfully authenticated for the authentication request identified by cookie. See polkit_authority_authentication_agent_response() for limitations on who is allowed is to call this method.

The calling thread is blocked until a reply is received. See polkit_authority_authentication_agent_response() for the asynchronous version.

authority :

A PolkitAuthority.

cookie :

The cookie passed to the authentication agent from the authority.

identity :

The identity that was authenticated.

cancellable :

A GCancellable or NULL. [allow-none]

error :

Return location for error or NULL. [allow-none]

Returns :

TRUE if authority acknowledged the call, FALSE if error is set.

polkit_authority_enumerate_temporary_authorizations ()

void                polkit_authority_enumerate_temporary_authorizations
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);

Asynchronously gets all temporary authorizations for subject.

When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from. You can then call polkit_authority_enumerate_temporary_authorizations_finish() to get the result of the operation.

authority :

A PolkitAuthority.

subject :

A PolkitSubject, typically a PolkitUnixSession.

cancellable :

A GCancellable or NULL. [allow-none]

callback :

A GAsyncReadyCallback to call when the request is satisfied.

user_data :

The data to pass to callback.

polkit_authority_enumerate_temporary_authorizations_finish ()

GList *             polkit_authority_enumerate_temporary_authorizations_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);

Finishes retrieving all registered actions.

authority :

A PolkitAuthority.

res :

A GAsyncResult obtained from the callback.

error :

Return location for error or NULL. [allow-none]

Returns :

A list of PolkitTemporaryAuthorization objects or NULL if error is set. The returned list should be freed with g_list_free() after each element have been freed with g_object_unref(). [transfer full]

polkit_authority_enumerate_temporary_authorizations_sync ()

GList *             polkit_authority_enumerate_temporary_authorizations_sync
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         GCancellable *cancellable,
                                                         GError **error);

Synchronousky gets all temporary authorizations for subject.

The calling thread is blocked until a reply is received. See polkit_authority_enumerate_temporary_authorizations() for the asynchronous version.

authority :

A PolkitAuthority.

subject :

A PolkitSubject, typically a PolkitUnixSession.

cancellable :

A GCancellable or NULL. [allow-none]

error :

Return location for error or NULL. [allow-none]

Returns :

A list of PolkitTemporaryAuthorization objects or NULL if error is set. The returned list should be freed with g_list_free() after each element have been freed with g_object_unref(). [transfer full]

polkit_authority_revoke_temporary_authorizations ()

void                polkit_authority_revoke_temporary_authorizations
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);

Asynchronously revokes all temporary authorizations for subject.

When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from. You can then call polkit_authority_revoke_temporary_authorizations_finish() to get the result of the operation.

authority :

A PolkitAuthority.

subject :

The subject to revoke authorizations from, typically a PolkitUnixSession.

cancellable :

A GCancellable or NULL. [allow-none]

callback :

A GAsyncReadyCallback to call when the request is satisfied.

user_data :

The data to pass to callback.

polkit_authority_revoke_temporary_authorizations_finish ()

gboolean            polkit_authority_revoke_temporary_authorizations_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);

Finishes revoking temporary authorizations.

authority :

A PolkitAuthority.

res :

A GAsyncResult obtained from the callback.

error :

Return location for error or NULL. [allow-none]

Returns :

TRUE if all the temporary authorizations was revoked, FALSE if error is set.

polkit_authority_revoke_temporary_authorizations_sync ()

gboolean            polkit_authority_revoke_temporary_authorizations_sync
                                                        (PolkitAuthority *authority,
                                                         PolkitSubject *subject,
                                                         GCancellable *cancellable,
                                                         GError **error);

Synchronously revokes all temporary authorization from subject.

The calling thread is blocked until a reply is received. See polkit_authority_revoke_temporary_authorizations() for the asynchronous version.

authority :

A PolkitAuthority.

subject :

The subject to revoke authorizations from, typically a PolkitUnixSession.

cancellable :

A GCancellable or NULL. [allow-none]

error :

Return location for error or NULL. [allow-none]

Returns :

TRUE if the temporary authorization was revoked, FALSE if error is set.

polkit_authority_revoke_temporary_authorization_by_id ()

void                polkit_authority_revoke_temporary_authorization_by_id
                                                        (PolkitAuthority *authority,
                                                         const gchar *id,
                                                         GCancellable *cancellable,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);

Asynchronously revoke a temporary authorization.

When the operation is finished, callback will be invoked in the thread-default main loop of the thread you are calling this method from. You can then call polkit_authority_revoke_temporary_authorization_by_id_finish() to get the result of the operation.

authority :

A PolkitAuthority.

id :

The opaque identifier for the temporary authorization.

cancellable :

A GCancellable or NULL. [allow-none]

callback :

A GAsyncReadyCallback to call when the request is satisfied.

user_data :

The data to pass to callback.

polkit_authority_revoke_temporary_authorization_by_id_finish ()

gboolean            polkit_authority_revoke_temporary_authorization_by_id_finish
                                                        (PolkitAuthority *authority,
                                                         GAsyncResult *res,
                                                         GError **error);

Finishes revoking a temporary authorization by id.

authority :

A PolkitAuthority.

res :

A GAsyncResult obtained from the callback.

error :

Return location for error or NULL. [allow-none]

Returns :

TRUE if the temporary authorization was revoked, FALSE if error is set.

polkit_authority_revoke_temporary_authorization_by_id_sync ()

gboolean            polkit_authority_revoke_temporary_authorization_by_id_sync
                                                        (PolkitAuthority *authority,
                                                         const gchar *id,
                                                         GCancellable *cancellable,
                                                         GError **error);

Synchronously revokes a temporary authorization.

The calling thread is blocked until a reply is received. See polkit_authority_revoke_temporary_authorization_by_id() for the asynchronous version.

authority :

A PolkitAuthority.

id :

The opaque identifier for the temporary authorization.

cancellable :

A GCancellable or NULL. [allow-none]

error :

Return location for error or NULL. [allow-none]

Returns :

TRUE if the temporary authorization was revoked, FALSE if error is set.

Property Details

The "backend-features" property

  "backend-features"         PolkitAuthorityFeatures  : Read

The features of the currently used Authority backend.


The "backend-name" property

  "backend-name"             gchar*                : Read

The name of the currently used Authority backend.

Default value: NULL


The "backend-version" property

  "backend-version"          gchar*                : Read

The version of the currently used Authority backend.

Default value: NULL


The "owner" property

  "owner"                    gchar*                : Read

The unique name of the owner of the org.freedesktop.PolicyKit1 D-Bus service or NULL if there is no owner. Connect to the "notify" signal to track changes to this property.

Default value: NULL

Signal Details

The "changed" signal

void                user_function                      (PolkitAuthority *authority,
                                                        gpointer         user_data)      : Run Last

Emitted when actions and/or authorizations change

authority :

A PolkitAuthority.

user_data :

user data set when the signal handler was connected.