From e9c0d4aaa20011a262597b3d135fb57e81e48bda Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Tue, 27 Jan 2009 22:18:37 -0500
Subject: fill out sections about subject/identity in the man page

Signed-off-by: David Zeuthen <davidz@redhat.com>
---
 docs/man/polkit.xml | 39 +++++++++++++++++++++++++++++++++++++--
 1 file changed, 37 insertions(+), 2 deletions(-)

(limited to 'docs')

diff --git a/docs/man/polkit.xml b/docs/man/polkit.xml
index f2f2d2c..7de4a66 100644
--- a/docs/man/polkit.xml
+++ b/docs/man/polkit.xml
@@ -319,14 +319,49 @@
   <refsect1 id="polkit-1-subject">
     <title>SUBJECTS</title>
     <para>
-      TODO: Write me.
+      Subjects represent the entities that may initiate requests requiring
+      authorization: processes, user sessions, or DBus services. To determine
+      whether a subject has an authorization, PolicyKit determines which
+      identities the subject matches.
+      See <xref linkend="polkit-1-identity"/> for details about <replaceable>identities</replaceable>.
+    </para>
+    <para>
+      To specify a Unix process as the subject, use
+      <literal>unix-process:<replaceable>pid</replaceable></literal>,
+      where <replaceable>pid</replaceable> is a numerical process id.
+    </para>
+    <para>
+      To specify a user session as the subject, use
+      <literal>unix-session:<replaceable>session-id</replaceable></literal>,
+      where <replaceable>session-id</replaceable> is the object path of
+      the ConsoleKit session object, e.g. /org/freedesktop/ConsoleKit/Session5.
+    </para>
+    <para>
+      To specify a DBus service, use
+      <literal>system-bus-name:<replaceable>bus-name</replaceable></literal>,
+      where <replaceable>bus-name</replaceable> is a DBus bus name, either
+      a well-known name like org.freedesktop.ConsoleKit, or a canonical
+      name like :1.16.
     </para>
   </refsect1>
 
   <refsect1 id="polkit-1-identity">
     <title>IDENTITIES</title>
     <para>
-      TODO: Write me.
+      Identities represent the entities that authorizations are granted to:
+      individual users or groups of users.
+    </para>
+    <para>
+      To specify an individual user as identity, use
+      <literal>unix-user:<replaceable>uid-or-name</replaceable></literal>,
+      where <replaceable>uid-or-name</replaceable> can be either a numeric
+      id of a Unix user, or the username of a Unix user.
+    </para>
+    <para>
+      To specify a group of users as identity, use
+      <literal>unix-group:<replaceable>gid-or-name</replaceable></literal>,
+      where <replaceable>gid-or-name</replaceable> can be either a numeric
+      id of a Unix group, or the name of a Unix group.
     </para>
   </refsect1>
 
-- 
cgit v1.2.3