David Zeuthen


    
  

Version 0.6

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You may obtain a copy of the GNU Free Documentation License from the Free Software Foundation by visiting their Web site or by writing to:


  The Free Software Foundation, Inc.,
  59 Temple Place - Suite 330,
  BostonMA 02111-1307,
  USA

Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and those trademarks are made aware to the members of the GNOME Documentation Project, the names have been printed in caps or initial caps.


I. Design Overview
Introduction
About
History and Prior Art
Defining the Problem
PolicyKit Model
Mechanims vs. Policy
Concepts
Theory of Operation
PolicyKit configuration
Declaring Actions
Annotations
Beyond the Defaults
II. Core API Reference
Basic types — Type definitions for common primitive types.
Error reporting — Representation of recoverable errors.
Results — Definition of results of PolicyKit queries.
Actions — Models what a caller is attempting to do.
Seat — Represents a ConsoleKit Seat.
Session — Represents a ConsoleKit Session.
Caller — Represents a process requesting a mechanism to do something.
Context — The main interface used to query PolicyKit.
Configuration — Represents the system-wide /etc/PolicyKit/PolicyKit.conf file.
Policy Definition Files — Represents a set of declared actions.
Policy File Entry — Represents a declared action in a policy file.
Defaults — Models the default policy for an action.
Policy Cache — Holds the actions defined on the system.
III. Convenience API Reference
Caller Determination — Obtaining seat, session and caller information via D-Bus and ConsoleKit.
IV. Authorization and privilege granting API Reference
PolKitGrant — A class used for obtain privileges through authentication.
V. Tools and file formats
PolicyKit — Centralized policy management
PolicyKit.conf — PolicyKit configuration file
polkit-grant — manage PolicyKit privilege grants
polkit-list-actions — List registered PolicyKit actions
polkit-policy-file-validate — Validate a PolicyKit policy file
polkit-config-file-validate — Validate a PolicyKit configuration file
Index
A. License