ACC SHELL
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Authorization Database</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
<link rel="home" href="index.html" title="PolicyKit Library Reference Manual">
<link rel="up" href="ref-core.html" title="Core API Reference">
<link rel="prev" href="polkit-Authorization-Constraints.html" title="Authorization Constraints">
<link rel="next" href="polkit-Authorizations-and-Authentication.html" title="Authorizations and Authentication">
<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="polkit-Authorization-Constraints.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="ref-core.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">PolicyKit Library Reference Manual</th>
<td><a accesskey="n" href="polkit-Authorizations-and-Authentication.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#polkit-Authorization-Database.synopsis" class="shortcut">Top</a>
|
<a href="#polkit-Authorization-Database.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry" title="Authorization Database">
<a name="polkit-Authorization-Database"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="polkit-Authorization-Database.top_of_page"></a>Authorization Database</span></h2>
<p>Authorization Database — Reading from and writing to the database storing authorizations</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv" title="Synopsis">
<a name="polkit-Authorization-Database.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis"> <a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB">PolKitAuthorizationDB</a>;
enum <a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDBCapability" title="enum PolKitAuthorizationDBCapability">PolKitAuthorizationDBCapability</a>;
<a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDBCapability" title="enum PolKitAuthorizationDBCapability"><span class="returnvalue">PolKitAuthorizationDBCapability</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-get-capabilities" title="polkit_authorization_db_get_capabilities ()">polkit_authorization_db_get_capabilities</a>
(<em class="parameter"><code><span class="type">void</span></code></em>);
<a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="returnvalue">PolKitAuthorizationDB</span></a> * <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-ref" title="polkit_authorization_db_ref ()">polkit_authorization_db_ref</a> (<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>);
<span class="returnvalue">void</span> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-unref" title="polkit_authorization_db_unref ()">polkit_authorization_db_unref</a> (<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>);
<span class="returnvalue">void</span> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-debug" title="polkit_authorization_db_debug ()">polkit_authorization_db_debug</a> (<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-validate" title="polkit_authorization_db_validate ()">polkit_authorization_db_validate</a> (<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-is-session-authorized" title="polkit_authorization_db_is_session_authorized ()">polkit_authorization_db_is_session_authorized</a>
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Session.html#PolKitSession" title="PolKitSession"><span class="type">PolKitSession</span></a> *session</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="type">polkit_bool_t</span></a> *out_is_authorized</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="type">polkit_bool_t</span></a> *out_is_negative_authorized</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-is-caller-authorized" title="polkit_authorization_db_is_caller_authorized ()">polkit_authorization_db_is_caller_authorized</a>
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Caller.html#PolKitCaller" title="PolKitCaller"><span class="type">PolKitCaller</span></a> *caller</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="type">polkit_bool_t</span></a> revoke_if_one_shot</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="type">polkit_bool_t</span></a> *out_is_authorized</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="type">polkit_bool_t</span></a> *out_is_negative_authorized</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> (<a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDBForeach" title="PolKitAuthorizationDBForeach ()">*PolKitAuthorizationDBForeach</a>) (<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Entry.html#PolKitAuthorization" title="PolKitAuthorization"><span class="type">PolKitAuthorization</span></a> *auth</code></em>,
<em class="parameter"><code><span class="type">void</span> *user_data</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-foreach" title="polkit_authorization_db_foreach ()">polkit_authorization_db_foreach</a> (<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDBForeach" title="PolKitAuthorizationDBForeach ()"><span class="type">PolKitAuthorizationDBForeach</span></a> cb</code></em>,
<em class="parameter"><code><span class="type">void</span> *user_data</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-foreach-for-uid" title="polkit_authorization_db_foreach_for_uid ()">polkit_authorization_db_foreach_for_uid</a>
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> uid</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDBForeach" title="PolKitAuthorizationDBForeach ()"><span class="type">PolKitAuthorizationDBForeach</span></a> cb</code></em>,
<em class="parameter"><code><span class="type">void</span> *user_data</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-foreach-for-action" title="polkit_authorization_db_foreach_for_action ()">polkit_authorization_db_foreach_for_action</a>
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDBForeach" title="PolKitAuthorizationDBForeach ()"><span class="type">PolKitAuthorizationDBForeach</span></a> cb</code></em>,
<em class="parameter"><code><span class="type">void</span> *user_data</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-foreach-for-action-for-uid" title="polkit_authorization_db_foreach_for_action_for_uid ()">polkit_authorization_db_foreach_for_action_for_uid</a>
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> uid</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDBForeach" title="PolKitAuthorizationDBForeach ()"><span class="type">PolKitAuthorizationDBForeach</span></a> cb</code></em>,
<em class="parameter"><code><span class="type">void</span> *user_data</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-add-entry-process-one-shot" title="polkit_authorization_db_add_entry_process_one_shot ()">polkit_authorization_db_add_entry_process_one_shot</a>
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Caller.html#PolKitCaller" title="PolKitCaller"><span class="type">PolKitCaller</span></a> *caller</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> user_authenticated_as</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-add-entry-process" title="polkit_authorization_db_add_entry_process ()">polkit_authorization_db_add_entry_process</a>
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Caller.html#PolKitCaller" title="PolKitCaller"><span class="type">PolKitCaller</span></a> *caller</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> user_authenticated_as</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-add-entry-session" title="polkit_authorization_db_add_entry_session ()">polkit_authorization_db_add_entry_session</a>
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Caller.html#PolKitCaller" title="PolKitCaller"><span class="type">PolKitCaller</span></a> *caller</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> user_authenticated_as</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-add-entry-always" title="polkit_authorization_db_add_entry_always ()">polkit_authorization_db_add_entry_always</a>
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Caller.html#PolKitCaller" title="PolKitCaller"><span class="type">PolKitCaller</span></a> *caller</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> user_authenticated_as</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-grant-to-uid" title="polkit_authorization_db_grant_to_uid ()">polkit_authorization_db_grant_to_uid</a>
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> uid</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Constraints.html#PolKitAuthorizationConstraint" title="PolKitAuthorizationConstraint"><span class="type">PolKitAuthorizationConstraint</span></a> **constraints</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-grant-negative-to-uid" title="polkit_authorization_db_grant_negative_to_uid ()">polkit_authorization_db_grant_negative_to_uid</a>
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> uid</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Constraints.html#PolKitAuthorizationConstraint" title="PolKitAuthorizationConstraint"><span class="type">PolKitAuthorizationConstraint</span></a> **constraints</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-revoke-entry" title="polkit_authorization_db_revoke_entry ()">polkit_authorization_db_revoke_entry</a>
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Entry.html#PolKitAuthorization" title="PolKitAuthorization"><span class="type">PolKitAuthorization</span></a> *auth</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);
<a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> <a class="link" href="polkit-Authorization-Database.html#polkit-authorization-db-is-uid-blocked-by-self" title="polkit_authorization_db_is_uid_blocked_by_self ()">polkit_authorization_db_is_uid_blocked_by_self</a>
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> uid</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);
</pre>
</div>
<div class="refsect1" title="Description">
<a name="polkit-Authorization-Database.description"></a><h2>Description</h2>
<p>
This class presents an abstraction of the authorization database as
well as methods for reading and writing to it.
</p>
<p>
The reading parts are in <code class="literal">libpolkit</code> and the
writing parts are in <code class="literal">libpolkit-grant</code>.
</p>
</div>
<div class="refsect1" title="Details">
<a name="polkit-Authorization-Database.details"></a><h2>Details</h2>
<div class="refsect2" title="PolKitAuthorizationDB">
<a name="PolKitAuthorizationDB"></a><h3>PolKitAuthorizationDB</h3>
<pre class="programlisting">typedef struct {
} PolKitAuthorizationDB;
</pre>
<p>
Objects of this class are used to represent the authorization
database.
</p>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="enum PolKitAuthorizationDBCapability">
<a name="PolKitAuthorizationDBCapability"></a><h3>enum PolKitAuthorizationDBCapability</h3>
<pre class="programlisting">typedef enum
{
POLKIT_AUTHORIZATION_DB_CAPABILITY_CAN_OBTAIN = 1 << 0
} PolKitAuthorizationDBCapability;
</pre>
<p>
Capabilities of the authorization database backend.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><a name="POLKIT-AUTHORIZATION-DB-CAPABILITY-CAN-OBTAIN:CAPS"></a><span class="term"><code class="literal">POLKIT_AUTHORIZATION_DB_CAPABILITY_CAN_OBTAIN</code></span></p></td>
<td>Users can obtain
authorizations through authentication
</td>
</tr></tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_get_capabilities ()">
<a name="polkit-authorization-db-get-capabilities"></a><h3>polkit_authorization_db_get_capabilities ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDBCapability" title="enum PolKitAuthorizationDBCapability"><span class="returnvalue">PolKitAuthorizationDBCapability</span></a> polkit_authorization_db_get_capabilities
(<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>
Determine what capabilities the authorization backend has.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Flags from the <a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDBCapability" title="enum PolKitAuthorizationDBCapability"><span class="type">PolKitAuthorizationDBCapability</span></a> enumeration
</td>
</tr></tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_ref ()">
<a name="polkit-authorization-db-ref"></a><h3>polkit_authorization_db_ref ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="returnvalue">PolKitAuthorizationDB</span></a> * polkit_authorization_db_ref (<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>);</pre>
<p>
Increase reference count.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>the object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the object
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_unref ()">
<a name="polkit-authorization-db-unref"></a><h3>polkit_authorization_db_unref ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span> polkit_authorization_db_unref (<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>);</pre>
<p>
Decreases the reference count of the object. If it becomes zero,
the object is freed. Before freeing, reference counts on embedded
objects are decresed by one.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>the object
</td>
</tr></tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_debug ()">
<a name="polkit-authorization-db-debug"></a><h3>polkit_authorization_db_debug ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span> polkit_authorization_db_debug (<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>);</pre>
<p>
Print debug details
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>the object
</td>
</tr></tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_validate ()">
<a name="polkit-authorization-db-validate"></a><h3>polkit_authorization_db_validate ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> polkit_authorization_db_validate (<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>);</pre>
<p>
Validate the object
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>the object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> iff the object is valid.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_is_session_authorized ()">
<a name="polkit-authorization-db-is-session-authorized"></a><h3>polkit_authorization_db_is_session_authorized ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> polkit_authorization_db_is_session_authorized
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Session.html#PolKitSession" title="PolKitSession"><span class="type">PolKitSession</span></a> *session</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="type">polkit_bool_t</span></a> *out_is_authorized</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="type">polkit_bool_t</span></a> *out_is_negative_authorized</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);</pre>
<p>
Looks in the authorization database and determine if processes from
the given session are authorized to do the given specific
action. If there is an authorization record that matches the
session, <em class="parameter"><code>out_is_authorized</code></em> will be set to <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. If there is a
negative authorization record matching the session
<em class="parameter"><code>out_is_negative_authorized</code></em> will be set to <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>the authorization database
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td>the action to check for
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>session</code></em> :</span></p></td>
<td>the session to check for
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>out_is_authorized</code></em> :</span></p></td>
<td>return location
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>out_is_negative_authorized</code></em> :</span></p></td>
<td>return location
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>return location for error
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> if the look up was performed; <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a> if the caller
of this function lacks privileges to ask this question (e.g. asking
about a user that is not himself) or OOM (and <em class="parameter"><code>error</code></em> will be set)
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_is_caller_authorized ()">
<a name="polkit-authorization-db-is-caller-authorized"></a><h3>polkit_authorization_db_is_caller_authorized ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> polkit_authorization_db_is_caller_authorized
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Caller.html#PolKitCaller" title="PolKitCaller"><span class="type">PolKitCaller</span></a> *caller</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="type">polkit_bool_t</span></a> revoke_if_one_shot</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="type">polkit_bool_t</span></a> *out_is_authorized</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="type">polkit_bool_t</span></a> *out_is_negative_authorized</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);</pre>
<p>
Looks in the authorization database if the given caller is
authorized to do the given action. If there is an authorization
record that matches the caller, <em class="parameter"><code>out_is_authorized</code></em> will be set to
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. If there is a negative authorization record matching the
caller <em class="parameter"><code>out_is_negative_authorized</code></em> will be set to <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>the authorization database
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td>the action to check for
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>caller</code></em> :</span></p></td>
<td>the caller to check for
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>revoke_if_one_shot</code></em> :</span></p></td>
<td>Whether to revoke one-shot authorizations. See
discussion in <a class="link" href="polkit-Context.html#polkit-context-is-caller-authorized" title="polkit_context_is_caller_authorized ()"><code class="function">polkit_context_is_caller_authorized()</code></a> for details.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>out_is_authorized</code></em> :</span></p></td>
<td>return location
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>out_is_negative_authorized</code></em> :</span></p></td>
<td>return location
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>return location for error
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> if the look up was performed; <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a> if the caller
of this function lacks privileges to ask this question (e.g. asking
about a user that is not himself) or if OOM (and <em class="parameter"><code>error</code></em> will be set)
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="PolKitAuthorizationDBForeach ()">
<a name="PolKitAuthorizationDBForeach"></a><h3>PolKitAuthorizationDBForeach ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> (*PolKitAuthorizationDBForeach) (<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Entry.html#PolKitAuthorization" title="PolKitAuthorization"><span class="type">PolKitAuthorization</span></a> *auth</code></em>,
<em class="parameter"><code><span class="type">void</span> *user_data</code></em>);</pre>
<p>
Type of callback function for iterating over authorizations.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>authorization database
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>auth</code></em> :</span></p></td>
<td>authorization; user shall not unref this object. Unless
reffed by the user it will be destroyed when the callback function
returns.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data passed
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> pass <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> to stop iterating
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_foreach ()">
<a name="polkit-authorization-db-foreach"></a><h3>polkit_authorization_db_foreach ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> polkit_authorization_db_foreach (<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDBForeach" title="PolKitAuthorizationDBForeach ()"><span class="type">PolKitAuthorizationDBForeach</span></a> cb</code></em>,
<em class="parameter"><code><span class="type">void</span> *user_data</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);</pre>
<p>
Iterate over all entries in the authorization database.
</p>
<p>
Note that unless the calling process has the authorization
org.freedesktop.policykit.read this function may return an error.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>authorization database
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>cb</code></em> :</span></p></td>
<td>callback
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data to pass to callback
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>return location for error
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> if the callback returned <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> to stop iterating. If
<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a>, either error may be set or the callback returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a> on
every invocation.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_foreach_for_uid ()">
<a name="polkit-authorization-db-foreach-for-uid"></a><h3>polkit_authorization_db_foreach_for_uid ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> polkit_authorization_db_foreach_for_uid
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> uid</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDBForeach" title="PolKitAuthorizationDBForeach ()"><span class="type">PolKitAuthorizationDBForeach</span></a> cb</code></em>,
<em class="parameter"><code><span class="type">void</span> *user_data</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);</pre>
<p>
Iterate over all entries in the authorization database for a given
user.
</p>
<p>
Note that if the calling process asks for authorizations for a
different uid than itself and it lacks the authorization
org.freedesktop.policykit.read this function may return an error.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>authorization database
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td>user to get authorizations for
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>cb</code></em> :</span></p></td>
<td>callback
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data to pass to callback
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>return location for error
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> if the callback returned <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> to stop iterating. If
<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a>, either error may be set or the callback returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a> on
every invocation.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_foreach_for_action ()">
<a name="polkit-authorization-db-foreach-for-action"></a><h3>polkit_authorization_db_foreach_for_action ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> polkit_authorization_db_foreach_for_action
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDBForeach" title="PolKitAuthorizationDBForeach ()"><span class="type">PolKitAuthorizationDBForeach</span></a> cb</code></em>,
<em class="parameter"><code><span class="type">void</span> *user_data</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);</pre>
<p>
Iterate over all entries in the authorization database for a given
action.
</p>
<p>
Note that unless the calling process has the authorization
org.freedesktop.policykit.read this function may return an error.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>authorization database
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td>action to get authorizations for
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>cb</code></em> :</span></p></td>
<td>callback
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data to pass to callback
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>return location for error
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> if the callback returned <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> to stop iterating. If
<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a>, either error may be set or the callback returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a> on
every invocation.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_foreach_for_action_for_uid ()">
<a name="polkit-authorization-db-foreach-for-action-for-uid"></a><h3>polkit_authorization_db_foreach_for_action_for_uid ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> polkit_authorization_db_foreach_for_action_for_uid
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> uid</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDBForeach" title="PolKitAuthorizationDBForeach ()"><span class="type">PolKitAuthorizationDBForeach</span></a> cb</code></em>,
<em class="parameter"><code><span class="type">void</span> *user_data</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);</pre>
<p>
Iterate over all entries in the authorization database for a given
action and user.
</p>
<p>
Note that if the calling process asks for authorizations for a
different uid than itself and it lacks the authorization
org.freedesktop.policykit.read this function may return an error.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>authorization database
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td>action to get authorizations for
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td>user to get authorizations for
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>cb</code></em> :</span></p></td>
<td>callback
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>user data to pass to callback
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>return location for error
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> if the callback returned <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> to stop iterating. If
<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a>, either error may be set or the callback returns <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a> on
every invocation.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_add_entry_process_one_shot ()">
<a name="polkit-authorization-db-add-entry-process-one-shot"></a><h3>polkit_authorization_db_add_entry_process_one_shot ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> polkit_authorization_db_add_entry_process_one_shot
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Caller.html#PolKitCaller" title="PolKitCaller"><span class="type">PolKitCaller</span></a> *caller</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> user_authenticated_as</code></em>);</pre>
<p>
Write an entry to the authorization database to indicate that the
given caller is authorized for the given action a single time.
</p>
<p>
Note that this function should only be used by
<code class="literal">libpolkit-grant</code> or other sufficiently privileged
processes that deals with managing authorizations. It should never
be used by mechanisms or applications. The caller must have
egid=polkituser and umask set so creating files with mode 0460 will
work.
</p>
<p>
This function is in <code class="literal">libpolkit-grant</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>the authorization database
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td>the action
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>caller</code></em> :</span></p></td>
<td>the caller
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_authenticated_as</code></em> :</span></p></td>
<td>the user that was authenticated
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> if an entry was written to the authorization
database, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a> if the caller of this function is not sufficiently
privileged.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_add_entry_process ()">
<a name="polkit-authorization-db-add-entry-process"></a><h3>polkit_authorization_db_add_entry_process ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> polkit_authorization_db_add_entry_process
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Caller.html#PolKitCaller" title="PolKitCaller"><span class="type">PolKitCaller</span></a> *caller</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> user_authenticated_as</code></em>);</pre>
<p>
Write an entry to the authorization database to indicate that the
given caller is authorized for the given action.
</p>
<p>
Note that this function should only be used by
<code class="literal">libpolkit-grant</code> or other sufficiently privileged
processes that deals with managing authorizations. It should never
be used by mechanisms or applications. The caller must have
egid=polkituser and umask set so creating files with mode 0460 will
work.
</p>
<p>
This function is in <code class="literal">libpolkit-grant</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>the authorization database
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td>the action
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>caller</code></em> :</span></p></td>
<td>the caller
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_authenticated_as</code></em> :</span></p></td>
<td>the user that was authenticated
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> if an entry was written to the authorization
database, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a> if the caller of this function is not sufficiently
privileged.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_add_entry_session ()">
<a name="polkit-authorization-db-add-entry-session"></a><h3>polkit_authorization_db_add_entry_session ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> polkit_authorization_db_add_entry_session
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Caller.html#PolKitCaller" title="PolKitCaller"><span class="type">PolKitCaller</span></a> *caller</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> user_authenticated_as</code></em>);</pre>
<p>
Write an entry to the authorization database to indicate that the
session for the given caller is authorized for the given action for
the remainer of the session.
</p>
<p>
Note that this function should only be used by
<code class="literal">libpolkit-grant</code> or other sufficiently privileged
processes that deals with managing authorizations. It should never
be used by mechanisms or applications. The caller must have
egid=polkituser and umask set so creating files with mode 0460 will
work.
</p>
<p>
This function is in <code class="literal">libpolkit-grant</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>the authorization database
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td>the action
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>caller</code></em> :</span></p></td>
<td>the caller
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_authenticated_as</code></em> :</span></p></td>
<td>the user that was authenticated
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> if an entry was written to the authorization
database, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a> if the caller of this function is not sufficiently
privileged.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_add_entry_always ()">
<a name="polkit-authorization-db-add-entry-always"></a><h3>polkit_authorization_db_add_entry_always ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> polkit_authorization_db_add_entry_always
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Caller.html#PolKitCaller" title="PolKitCaller"><span class="type">PolKitCaller</span></a> *caller</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> user_authenticated_as</code></em>);</pre>
<p>
Write an entry to the authorization database to indicate that the
given user is authorized for the given action.
</p>
<p>
Note that this function should only be used by
<code class="literal">libpolkit-grant</code> or other sufficiently privileged
processes that deals with managing authorizations. It should never
be used by mechanisms or applications. The caller must have
egid=polkituser and umask set so creating files with mode 0460 will
work.
</p>
<p>
This function is in <code class="literal">libpolkit-grant</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>the authorization database
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td>the action
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>caller</code></em> :</span></p></td>
<td>the caller
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_authenticated_as</code></em> :</span></p></td>
<td>the user that was authenticated
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> if an entry was written to the authorization
database, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a> if the caller of this function is not sufficiently
privileged.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_grant_to_uid ()">
<a name="polkit-authorization-db-grant-to-uid"></a><h3>polkit_authorization_db_grant_to_uid ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> polkit_authorization_db_grant_to_uid
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> uid</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Constraints.html#PolKitAuthorizationConstraint" title="PolKitAuthorizationConstraint"><span class="type">PolKitAuthorizationConstraint</span></a> **constraints</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);</pre>
<p>
Grants an authorization to a user for a specific action. This
requires the org.freedesktop.policykit.grant authorization.
</p>
<p>
This function is in <code class="literal">libpolkit-grant</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>authorization database
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td>action
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td>uid to grant to
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>constraints</code></em> :</span></p></td>
<td>Either <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated list of constraint to put on the authorization
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>return location for error
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> if the authorization was granted, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a> otherwise
and error will be set
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_grant_negative_to_uid ()">
<a name="polkit-authorization-db-grant-negative-to-uid"></a><h3>polkit_authorization_db_grant_negative_to_uid ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> polkit_authorization_db_grant_negative_to_uid
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> uid</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Constraints.html#PolKitAuthorizationConstraint" title="PolKitAuthorizationConstraint"><span class="type">PolKitAuthorizationConstraint</span></a> **constraints</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);</pre>
<p>
Grants a negative authorization to a user for a specific action. If
<em class="parameter"><code>uid</code></em> differs from the calling user, the
org.freedesktop.policykit.grant authorization is required. In other
words, users may "grant" negative authorizations to themselves.
</p>
<p>
A negative authorization is normally used to block users that would
normally be authorized from an implicit authorization.
</p>
<p>
This function is in <code class="literal">libpolkit-grant</code>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>authorization database
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td>action
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td>uid to grant to
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>constraints</code></em> :</span></p></td>
<td>Either <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or a <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminated list of constraint to put on the authorization
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>return location for error
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> if the authorization was granted, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a> otherwise
and error will be set
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_revoke_entry ()">
<a name="polkit-authorization-db-revoke-entry"></a><h3>polkit_authorization_db_revoke_entry ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> polkit_authorization_db_revoke_entry
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Authorization-Entry.html#PolKitAuthorization" title="PolKitAuthorization"><span class="type">PolKitAuthorization</span></a> *auth</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);</pre>
<p>
Removes an authorization from the authorization database. This uses
a privileged helper /usr/libexec/polkit-revoke-helper.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>the authorization database
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>auth</code></em> :</span></p></td>
<td>the authorization to revoke
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>return location for error
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> if the authorization was revoked, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a> otherwise and error is set
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
<hr>
<div class="refsect2" title="polkit_authorization_db_is_uid_blocked_by_self ()">
<a name="polkit-authorization-db-is-uid-blocked-by-self"></a><h3>polkit_authorization_db_is_uid_blocked_by_self ()</h3>
<pre class="programlisting"><a class="link" href="polkit-Basic-types.html#polkit-bool-t" title="polkit_bool_t"><span class="returnvalue">polkit_bool_t</span></a> polkit_authorization_db_is_uid_blocked_by_self
(<em class="parameter"><code><a class="link" href="polkit-Authorization-Database.html#PolKitAuthorizationDB" title="PolKitAuthorizationDB"><span class="type">PolKitAuthorizationDB</span></a> *authdb</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Actions.html#PolKitAction" title="PolKitAction"><span class="type">PolKitAction</span></a> *action</code></em>,
<em class="parameter"><code><span class="type">uid_t</span> uid</code></em>,
<em class="parameter"><code><a class="link" href="polkit-Error-reporting.html#PolKitError" title="PolKitError"><span class="type">PolKitError</span></a> **error</code></em>);</pre>
<p>
Determine whether there exists negative authorizations for the
particular uid on the given action and whether those negative
authorization are "granted" by the uid itself.
</p>
<p>
If uid is different from <code class="function">getuid()</code>, e.g. if the calling process asks
for auths of another user this function will set an error if the
calling user is not authorized for org.freedesktop.policykit.read.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>authdb</code></em> :</span></p></td>
<td>the authorization database
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td>the action to check for
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>uid</code></em> :</span></p></td>
<td>the user to check for
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>return location for error
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> Result of computation described above; if error is set
will return <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 0.7</p>
</div>
</div>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.14</div>
</body>
</html>
ACC SHELL 2018