Relevant BUGIDs:

Purpose of commit: bugfix

Commit summary:
---------------

2006-06-23  Thorsten Kukuk  <kukuk@thkukuk.de>

        * modules/pam_access/access.conf.5.xml: Fix syntax for SAG.
        * modules/pam_access/pam_access.8.xml: Likewise.
        * modules/pam_deny/pam_deny.8.xml: Likewise.
        * modules/pam_echo/pam_echo.8.xml: Likewise.
        * modules/pam_env/pam_env.8.xml: Likewise.
        * modules/pam_env/pam_env.conf.5.xml: Likewise.
        * modules/pam_group/group.conf.5.xml: Likewise.
        * modules/pam_group/pam_group.8.xml: Likewise.
        * modules/pam_limits/limits.conf.5.xml: Likewise.
        * modules/pam_listfile/pam_listfile.8.xml: Likewise.
        * modules/pam_succeed_if/pam_succeed_if.8.xml: Likewise.
        * modules/pam_time/pam_time.8.xml: Likewise.
        * modules/pam_time/time.conf.5.xml: Likewise.

        * modules/pam_access/access.conf.5: Regenerate.
        * modules/pam_access/pam_access.8: Likewise.
        * modules/pam_deny/pam_deny.8: Likewise.
        * modules/pam_echo/README: Likewise.
        * modules/pam_echo/pam_echo.8: Likewise.
        * modules/pam_env/pam_env.8: Likewise.
        * modules/pam_env/pam_env.conf.5: Likewise.
        * modules/pam_group/README: Likewise.
        * modules/pam_group/group.conf.5: Likewise.
        * modules/pam_group/pam_group.8: Likewise.
        * modules/pam_limits/limits.conf.5: Likewise.
        * modules/pam_listfile/README: Likewise.
        * modules/pam_listfile/pam_listfile.8: Likewise.
        * modules/pam_succeed_if/pam_succeed_if.8: Likewise.
        * modules/pam_time/pam_time.8: Likewise.
        * modules/pam_time/time.conf.5: Likewise.

        * doc/man/Makefile.am: Add pam.conf-desc.xml, pam.conf-dir.xml
        and pam.conf-syntax.xml.
        * doc/man/pam.conf.5.xml: Split into different pieces for SAG.
        * doc/man/pam.conf.5: Regenerated.
	* doc/man/pam.conf-desc.xml: New.
	* doc/man/pam.conf-dir.xml: New.
	* doc/man/pam.conf-syntax.xml: New.

1 files changed, 30 insertions, 0 deletions

diff --git a/doc/man/pam.conf-dir.xml b/doc/man/pam.conf-dir.xml
new file mode 100644
index 00000000..8446cf35
--- /dev/null
+++ b/doc/man/pam.conf-dir.xml
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+                   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
+<section id='pam.conf-dir'>
+    <para>
+      More flexible than the single configuration file is it to
+      configure libpam via the contents of the
+      <filename>/etc/pam.d/</filename> directory. In this case the
+      directory is filled with files each of which has a filename
+      equal to a service-name (in lower-case): it is the personal
+      configuration file for the named service.
+    </para>
+
+    <para>
+      The syntax of each file in /etc/pam.d/ is similar to that of the
+      <filename>/etc/pam.conf</filename> file and is made up of lines
+      of the following form:
+    </para>
+
+    <programlisting>
+type  control  module-path  module-arguments
+    </programlisting>
+
+    <para>
+      The only difference being that the service-name is not present. The
+      service-name is of course the name of the given configuration file.
+      For example, <filename>/etc/pam.d/login</filename> contains the
+      configuration for the <emphasis remap='B'>login</emphasis> service.
+    </para>
+</section>