Commit ae8ea087 authored by David Zeuthen's avatar David Zeuthen

Add docs detailing how the Local Authority works

parent 002ce3d1
......@@ -6,6 +6,7 @@ if MAN_PAGES_ENABLED
man_MANS = \
polkit.8 \
polkitd.8 \
pklocalauthority.8 \
pkexec.1 \
pkcheck.1 \
pkaction.1 \
......@@ -19,6 +20,7 @@ endif # MAN_PAGES_ENABLED
EXTRA_DIST = \
polkit.xml \
polkitd.xml \
pklocalauthority.xml \
pkexec.xml \
pkcheck.xml \
pkaction.xml \
......
This diff is collapsed.
......@@ -127,6 +127,13 @@ System Context | |
documentation</ulink> for more information about using and
extending PolicyKit.
</para>
<para>
See
<citerefentry><refentrytitle>pklocalauthority</refentrytitle><manvolnum>8</manvolnum></citerefentry>
for information about the Local Authority - the default
authority implementation shipped with PolicyKit.
</para>
</refsect1>
<refsect1 id="polkit-authentication-agents"><title>AUTHENTICATION AGENTS</title>
......@@ -210,7 +217,9 @@ System Context | |
</textobject>
</mediaobject>
<para>
See <xref linkend="pkla"/> for how to set up the local authority
See
<citerefentry><refentrytitle>pklocalauthority</refentrytitle><manvolnum>8</manvolnum></citerefentry>
on how to set up the local authority
implemention for systems without a <literal>root</literal>
account.
</para>
......@@ -391,16 +400,6 @@ System Context | |
</para>
</refsect1>
<refsect1 id="pkla"><title>LOCAL AUTHORITY IMPLEMENTATION</title>
<para>
The default authority implementation in PolicyKit is using the
local filesystem to store authorizations. TODO: write some more
here including a link to a
<citerefentry><refentrytitle>pklamanage</refentrytitle><manvolnum>1</manvolnum></citerefentry>
command.
</para>
</refsect1>
<refsect1 id="polkit-author"><title>AUTHOR</title>
<para>
Written by David Zeuthen <email>davidz@redhat.com</email> with
......@@ -421,6 +420,12 @@ System Context | |
<refsect1 id="polkit-see-also">
<title>SEE ALSO</title>
<para>
<citerefentry>
<refentrytitle>pklocalauthority</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>
<citerefentry>
<refentrytitle>polkitd</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>
<citerefentry>
<refentrytitle>pkaction</refentrytitle><manvolnum>1</manvolnum>
</citerefentry>,
......@@ -430,9 +435,6 @@ System Context | |
<citerefentry>
<refentrytitle>pkexec</refentrytitle><manvolnum>1</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>polkitd</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>
</para>
</refsect1>
</refentry>
......@@ -61,6 +61,7 @@ content_files = \
../../src/polkit/docbook-interface-org.freedesktop.PolicyKit1.AuthenticationAgent.xml \
../man/polkit.xml \
../man/polkitd.xml \
../man/pklocalauthority.xml \
../man/pkcheck.xml \
../man/pkaction.xml \
../man/pkexec.xml \
......
......@@ -109,6 +109,7 @@
<title>Manual Pages</title>
<xi:include href="../man/polkit.xml"/>
<xi:include href="../man/polkitd.xml"/>
<xi:include href="../man/pklocalauthority.xml"/>
<xi:include href="../man/pkcheck.xml"/>
<xi:include href="../man/pkaction.xml"/>
<xi:include href="../man/pkexec.xml"/>
......
#
# Configuration file for the PolicyKit local authority backend.
# Configuration file for the PolicyKit Local Authority.
#
# DO NOT EDIT THIS FILE, it will be overwritten on update.
#
# To change configuration, create another file in this directory with
# a filename that is sorted after the 50-localauthority.conf and make
# sure it has the .conf extension.
#
# Only a single configuration item, AdminIdentities, is supported. It
# specifies what set of identities to use for administrator authentication.
# The value is a semicolon-separated list of identities. An identity can
# be specified as
#
# unix-user:<user>
# unix-group:<group>
#
# where <user> is username/uid and <group> is a groupname/gid. When
# using the group directive, any user in the given group can chosen
# for authentication.
#
# See the PolicyKit documentation for more information about PolicyKit.
# See the pklocalauthority(8) man page for more information
# about configuring the Local Authority.
#
[Configuration]
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment