mirrors/linux-pam
0
0
Fork 0
mirror of https://github.com/linux-pam/linux-pam.git synced 2024-11-27 03:33:39 +08:00
Code Issues Packages Projects Releases Wiki Activity

doc: Update PAM documentation from DockBook 4 to DocBook 5

Browse Source 
Changed files
--------------

Make.xml.rules.in:
- Using RNG file instead of DTD file for checking XML files.
- Taking the correct stylesheet for README files.

doc/sag/Makefile.am, doc/adg/Makefile.am, doc/mwg/Makefile.am:
- Using RNG file instead of DTD file for checking XML files.

configure.ac:
- Adding a new option for selecting RNG check file (-enable-docbook-rng)
- Switching stylesheets to docbook 5
- Checking DocBook 5 environment instead of DocBook 4 environment

*.xml:
Update from DockBook 4 to DocBook 5
This commit is contained in:
Stefan Schubert 2022-10-25 16:29:41 +02:00 committed by Thorsten Kukuk
parent 6135c45347
commit cf2fc5ff7b
235 changed files with 3398 additions and 5101 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
Make.xml.rules.in
View File

@ -5,22 +5,22 @@
README: $(XMLS)
README: README.xml
$(XSLTPROC) --path $(srcdir) --xinclude --stringparam generate.toc "none" @STRINGPARAM_VENDORDIR@ --nonet $(top_srcdir)/doc/custom-html.xsl $< | $(BROWSER) > $(srcdir)/$@
$(XSLTPROC) --path $(srcdir) --xinclude --stringparam generate.toc "none" @STRINGPARAM_VENDORDIR@ --nonet $(TXT_STYLESHEET) $< | $(BROWSER) > $(srcdir)/$@
%.1: %.1.xml
$(XMLLINT) --nonet --xinclude --postvalid --noout $<
$(XMLLINT) --nonet --xinclude --relaxng $(DOCBOOK_RNG) --noout $<
$(XSLTPROC) -o $(srcdir)/$@ --path $(srcdir) --xinclude @STRINGPARAM_VENDORDIR@ --nonet $(top_srcdir)/doc/custom-man.xsl $<
%.3: %.3.xml
$(XMLLINT) --nonet --xinclude --postvalid --noout $<
$(XMLLINT) --nonet --xinclude --relaxng $(DOCBOOK_RNG) --noout $<
$(XSLTPROC) -o $(srcdir)/$@ --path $(srcdir) --xinclude @STRINGPARAM_VENDORDIR@ --nonet $(top_srcdir)/doc/custom-man.xsl $<
%.5: %.5.xml
$(XMLLINT) --nonet --xinclude --postvalid --noout $<
$(XMLLINT) --nonet --xinclude --relaxng $(DOCBOOK_RNG) --noout $<
$(XSLTPROC) -o $(srcdir)/$@ --path $(srcdir) --xinclude @STRINGPARAM_VENDORDIR@ --nonet $(top_srcdir)/doc/custom-man.xsl $<
%.8: %.8.xml
$(XMLLINT) --nonet --xinclude --postvalid --noout $<
$(XMLLINT) --nonet --xinclude --relaxng $(DOCBOOK_RNG) --noout $<
$(XSLTPROC) -o $(srcdir)/$@ --path $(srcdir) --xinclude @STRINGPARAM_VENDORDIR@ @STRINGPARAM_HMAC@ --nonet $(top_srcdir)/doc/custom-man.xsl $<
#CLEANFILES += $(man_MANS) README

4
ci/install-dependencies.sh
View File

@ -13,8 +13,8 @@ automake
autopoint
bison
bzip2
docbook-xml
docbook-xsl
docbook5-xml
docbook-xsl-ns
flex
gettext
libaudit-dev

33
configure.ac
View File

@ -243,26 +243,35 @@ if test x"$enable_debug" = x"yes" ; then
[lots of stuff gets written to /var/run/pam-debug.log])
fi
AC_ARG_ENABLE(docbook_rng,
AS_HELP_STRING([--enable-docbook-rng=FILE],[RNG file for checking XML files @<:@default=http://docbook.org/xml/5.0/rng/docbookxi.rng@:>@]),
DOCBOOK_RNG=$enableval, DOCBOOK_RNG=http://docbook.org/xml/5.0/rng/docbookxi.rng)
AC_SUBST(DOCBOOK_RNG)
AC_ARG_ENABLE(html_stylesheet,
AS_HELP_STRING([--enable-html-stylesheet=FILE],[html stylesheet path @<:@default=http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl@:>@]),
HTML_STYLESHEET=$enableval, HTML_STYLESHEET=http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl)
AS_HELP_STRING([--enable-html-stylesheet=FILE],[html stylesheet path @<:@default=http://docbook.sourceforge.net/release/xsl-ns/current/html/chunk.xsl@:>@]),
HTML_STYLESHEET=$enableval, HTML_STYLESHEET=http://docbook.sourceforge.net/release/xsl-ns/current/html/chunk.xsl)
AC_SUBST(HTML_STYLESHEET)
AC_ARG_ENABLE(txt_stylesheet,
AS_HELP_STRING([--enable-txt-stylesheet=FILE],[text stylesheet path @<:@default=http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl@:>@]),
TXT_STYLESHEET=$enableval, TXT_STYLESHEET=http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl)
AS_HELP_STRING([--enable-txt-stylesheet=FILE],[text stylesheet path @<:@default=http://docbook.sourceforge.net/release/xsl-ns/current/html/docbook.xsl@:>@]),
TXT_STYLESHEET=$enableval, TXT_STYLESHEET=http://docbook.sourceforge.net/release/xsl-ns/current/html/docbook.xsl)
AC_SUBST(TXT_STYLESHEET)
# It has to be TXT_STYLESHEET otherwise a html tree will be generated while generating all README files.
sed "s+HTML_STYLESHEET+$TXT_STYLESHEET+g" <doc/custom-html.xsl.in >doc/custom-html.xsl
AC_ARG_ENABLE(pdf_stylesheet,
AS_HELP_STRING([--enable-pdf-stylesheet=FILE],[pdf stylesheet path @<:@default=http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl@:>@]),
PDF_STYLESHEET=$enableval, PDF_STYLESHEET=http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl)
AS_HELP_STRING([--enable-pdf-stylesheet=FILE],[pdf stylesheet path @<:@default=http://docbook.sourceforge.net/release/xsl-ns/current/fo/docbook.xsl@:>@]),
PDF_STYLESHEET=$enableval, PDF_STYLESHEET=http://docbook.sourceforge.net/release/xsl-ns/current/fo/docbook.xsl)
AC_SUBST(PDF_STYLESHEET)
AC_ARG_ENABLE(man_stylesheet,
AS_HELP_STRING([--enable-man-stylesheet=FILE],[man stylesheet path @<:@default=http://docbook.sourceforge.net/release/xsl/current/manpages/profile-docbook.xsl@:>@]),
MAN_STYLESHEET=$enableval, MAN_STYLESHEET=http://docbook.sourceforge.net/release/xsl/current/manpages/profile-docbook.xsl)
AS_HELP_STRING([--enable-man-stylesheet=FILE],[man stylesheet path @<:@default=http://docbook.sourceforge.net/release/xsl-ns/current/manpages/profile-docbook.xsl@:>@]),
MAN_STYLESHEET=$enableval, MAN_STYLESHEET=http://docbook.sourceforge.net/release/xsl-ns/current/manpages/profile-docbook.xsl)
AC_SUBST(MAN_STYLESHEET)
sed "s+MAN_STYLESHEET+$MAN_STYLESHEET+g" <doc/custom-man.xsl.in >doc/custom-man.xsl
@ -608,10 +617,10 @@ if test -z "$XSLTPROC"; then
enable_docu=no
fi
AC_PATH_PROG([XMLLINT], [xmllint],[/bin/true])
dnl check for DocBook DTD and stylesheets in the local catalog.
JH_CHECK_XML_CATALOG([-//OASIS//DTD DocBook XML V4.4//EN],
[DocBook XML DTD V4.4], [], enable_docu=no)
JH_CHECK_XML_CATALOG([http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl],
dnl check for DocBook RNG and stylesheets in the local catalog.
JH_CHECK_XML_CATALOG([http://docbook.org/xml/5.0/rng/docbookxi.rng],
[DocBook XML RNG V5.0], [], enable_docu=no)
JH_CHECK_XML_CATALOG([http://docbook.sourceforge.net/release/xsl-ns/current/manpages/docbook.xsl],
[DocBook XSL Stylesheets], [], enable_docu=no)
AC_PATH_PROG([BROWSER], [w3m])

199
doc/adg/Linux-PAM_ADG.xml
View File

@ -1,50 +1,39 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<book id="adg">
<bookinfo>
<book xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg">
<info>
<title>The Linux-PAM Application Developers' Guide</title>
<authorgroup>
<author>
<firstname>Andrew G.</firstname>
<surname>Morgan</surname>
<email>morgan@kernel.org</email>
</author>
<author>
<firstname>Thorsten</firstname>
<surname>Kukuk</surname>
<email>kukuk@thkukuk.de</email>
</author>
<author><personname><firstname>Andrew G.</firstname><surname>Morgan</surname></personname><email>morgan@kernel.org</email></author>
<author><personname><firstname>Thorsten</firstname><surname>Kukuk</surname></personname><email>kukuk@thkukuk.de</email></author>
</authorgroup>
<releaseinfo>Version 1.1.2, 31. August 2010</releaseinfo>
<abstract>
<para>
This manual documents what an application developer needs to know
about the <emphasis remap='B'>Linux-PAM</emphasis> library. It
about the <emphasis remap="B">Linux-PAM</emphasis> library. It
describes how an application might use the
<emphasis remap='B'>Linux-PAM</emphasis> library to authenticate
<emphasis remap="B">Linux-PAM</emphasis> library to authenticate
users. In addition it contains a description of the functions
to be found in <filename>libpam_misc</filename> library, that can
be used in general applications. Finally, it contains some comments
on PAM related security issues for the application developer.
</para>
</abstract>
</bookinfo>
</info>
<chapter id="adg-introduction">
<chapter xml:id="adg-introduction">
<title>Introduction</title>
<section id="adg-introduction-description">
<section xml:id="adg-introduction-description">
<title>Description</title>
<para>
<emphasis remap='B'>Linux-PAM</emphasis>
<emphasis remap="B">Linux-PAM</emphasis>
(Pluggable Authentication Modules for Linux) is a library that enables
the local system administrator to choose how individual applications
authenticate users. For an overview of the
<emphasis remap='B'>Linux-PAM</emphasis> library see the
<emphasis remap="B">Linux-PAM</emphasis> library see the
<emphasis>Linux-PAM System Administrators' Guide</emphasis>.
</para>
<para>
It is the purpose of the <emphasis remap='B'>Linux-PAM</emphasis>
It is the purpose of the <emphasis remap="B">Linux-PAM</emphasis>
project to liberate the development of privilege granting software
from the development of secure and appropriate authentication schemes.
This is accomplished by providing a documented library of functions
@ -64,11 +53,11 @@
</para>
</section>
<section id="adg-introduction-synopsis">
<section xml:id="adg-introduction-synopsis">
<title>Synopsis</title>
<para>
For general applications that wish to use the services provided by
<emphasis remap='B'>Linux-PAM</emphasis> the following is a summary
<emphasis remap="B">Linux-PAM</emphasis> the following is a summary
of the relevant linking information:
<programlisting>
#include &lt;security/pam_appl.h&gt;
@ -92,7 +81,7 @@ cc -o application .... -lpam -lpam_misc
</section>
</chapter>
<chapter id="adg-overview">
<chapter xml:id="adg-overview">
<title>Overview</title>
<para>
Most service-giving applications are restricted. In other words,
@ -108,7 +97,7 @@ cc -o application .... -lpam -lpam_misc
authentication-token (password changing) management services. It is
important to realize when writing a PAM based application that these
services are provided in a manner that is
<emphasis remap='B'>transparent</emphasis> to the application. That is
<emphasis remap="B">transparent</emphasis> to the application. That is
to say, when the application is written, no assumptions can be made
about <emphasis>how</emphasis> the client will be authenticated.
</para>
@ -206,74 +195,58 @@ cc -o application .... -lpam -lpam_misc
</para>
</chapter>
<chapter id="adg-interface">
<chapter xml:id="adg-interface">
<title>
The public interface to <emphasis remap='B'>Linux-PAM</emphasis>
The public interface to <emphasis remap="B">Linux-PAM</emphasis>
</title>
<para>
Firstly, the relevant include file for the
<emphasis remap='B'>Linux-PAM</emphasis> library is
<emphasis remap="B">Linux-PAM</emphasis> library is
<function>&lt;security/pam_appl.h&gt;</function>.
It contains the definitions for a number of functions. After
listing these functions, we collect some guiding remarks for
programmers.
</para>
<section id="adg-interface-by-app-expected">
<section xml:id="adg-interface-by-app-expected">
<title>What can be expected by the application</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_start.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_end.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_set_item.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_get_item.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_strerror.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_fail_delay.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_authenticate.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_setcred.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_acct_mgmt.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_chauthtok.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_open_session.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_close_session.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_putenv.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_getenv.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_getenvlist.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_start.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_end.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_set_item.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_get_item.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_strerror.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_fail_delay.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_authenticate.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_setcred.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_acct_mgmt.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_chauthtok.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_open_session.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_close_session.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_putenv.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_getenv.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_getenvlist.xml"/>
</section>
<section id="adg-interface-of-app-expected">
<section xml:id="adg-interface-of-app-expected">
<title>What is expected of an application</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_conv.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_conv.xml"/>
</section>
<section id="adg-interface-programming-notes">
<section xml:id="adg-interface-programming-notes">
<title>Programming notes</title>
<para>
Note, all of the authentication service function calls accept the
token <emphasis remap='B'>PAM_SILENT</emphasis>, which instructs
token <emphasis remap="B">PAM_SILENT</emphasis>, which instructs
the modules to not send messages to the application. This token
can be logically OR'd with any one of the permitted tokens specific
to the individual function calls.
<emphasis remap='B'>PAM_SILENT</emphasis> does not override the
<emphasis remap="B">PAM_SILENT</emphasis> does not override the
prompting of the user for passwords etc., it only stops informative
messages from being generated.
</para>
</section>
</chapter>
<chapter id="adg-security">
<chapter xml:id="adg-security">
<title>
Security issues of <emphasis remap='B'>Linux-PAM</emphasis>
Security issues of <emphasis remap="B">Linux-PAM</emphasis>
</title>
<para>
PAM, from the perspective of an application, is a convenient API for
@ -284,19 +257,19 @@ cc -o application .... -lpam -lpam_misc
</para>
<para>
A poorly (or maliciously) written application can defeat any
<emphasis remap='B'>Linux-PAM</emphasis> module's authentication
<emphasis remap="B">Linux-PAM</emphasis> module's authentication
mechanisms by simply ignoring it's return values. It is the
applications task and responsibility to grant privileges and access
to services. The <emphasis remap='B'>Linux-PAM</emphasis> library
to services. The <emphasis remap="B">Linux-PAM</emphasis> library
simply assumes the responsibility of <emphasis>authenticating</emphasis>
the user; ascertaining that the user <emphasis>is</emphasis> who they
say they are. Care should be taken to anticipate all of the documented
behavior of the <emphasis remap='B'>Linux-PAM</emphasis> library
behavior of the <emphasis remap="B">Linux-PAM</emphasis> library
functions. A failure to do this will most certainly lead to a future
security breach.
</para>
<section id="adg-security-library-calls">
<section xml:id="adg-security-library-calls">
<title>Care about standard library calls</title>
<para>
In general, writers of authorization-granting applications should
@ -308,9 +281,9 @@ cc -o application .... -lpam -lpam_misc
function is likely to corrupt a pointer previously
obtained by the application. The application programmer should
either re-call such a 'libc' function after a call to the
<emphasis remap='B'>Linux-PAM</emphasis> library, or copy the
<emphasis remap="B">Linux-PAM</emphasis> library, or copy the
structure contents to some safe area of memory before passing
control to the <emphasis remap='B'>Linux-PAM</emphasis> library.
control to the <emphasis remap="B">Linux-PAM</emphasis> library.
</para>
<para>
Two important function classes that fall into this category are
@ -322,12 +295,12 @@ cc -o application .... -lpam -lpam_misc
</para>
</section>
<section id="adg-security-service-name">
<section xml:id="adg-security-service-name">
<title>Choice of a service name</title>
<para>
When picking the <emphasis>service-name</emphasis> that
corresponds to the first entry in the
<emphasis remap='B'>Linux-PAM</emphasis> configuration file,
<emphasis remap="B">Linux-PAM</emphasis> configuration file,
the application programmer should <emphasis>avoid</emphasis>
the temptation of choosing something related to
<varname>argv[0]</varname>. It is a trivial matter for any user
@ -352,11 +325,11 @@ cc -o application .... -lpam -lpam_misc
and then run <command>./preferred_name</command>.
</para>
<para>
By studying the <emphasis remap='B'>Linux-PAM</emphasis>
By studying the <emphasis remap="B">Linux-PAM</emphasis>
configuration file(s), an attacker can choose the
<command>preferred_name</command> to be that of a service enjoying
minimal protection; for example a game which uses
<emphasis remap='B'>Linux-PAM</emphasis> to restrict access to
<emphasis remap="B">Linux-PAM</emphasis> to restrict access to
certain hours of the day. If the service-name were to be linked
to the filename under which the service was invoked, it
is clear that the user is effectively in the position of
@ -370,7 +343,7 @@ cc -o application .... -lpam -lpam_misc
</para>
</section>
<section id="adg-security-conv-function">
<section xml:id="adg-security-conv-function">
<title>The conversation function</title>
<para>
Care should be taken to ensure that the <function>conv()</function>
@ -380,10 +353,10 @@ cc -o application .... -lpam -lpam_misc
</para>
</section>
<section id="adg-security-user-identity">
<section xml:id="adg-security-user-identity">
<title>The identity of the user</title>
<para>
The <emphasis remap='B'>Linux-PAM</emphasis> modules will need
The <emphasis remap="B">Linux-PAM</emphasis> modules will need
to determine the identity of the user who requests a service,
and the identity of the user who grants the service. These two
users will seldom be the same. Indeed there is generally a third
@ -444,7 +417,7 @@ cc -o application .... -lpam -lpam_misc
</para>
</section>
<section id="adg-security-resources">
<section xml:id="adg-security-resources">
<title>Sufficient resources</title>
<para>
Care should be taken to ensure that the proper execution of an
@ -465,7 +438,7 @@ cc -o application .... -lpam -lpam_misc
</section>
</chapter>
<chapter id='adg-libpam_misc'>
<chapter xml:id="adg-libpam_misc">
<title>A library of miscellaneous helper functions</title>
<para>
To aid the work of the application developer a library of
@ -479,24 +452,20 @@ cc -o application .... -lpam -lpam_misc
library can be defined by including
<function>&lt;security/pam_misc.h&gt;</function>. It should be
noted that this library is specific to
<emphasis remap='B'>Linux-PAM</emphasis> and is not referred to in
<emphasis remap="B">Linux-PAM</emphasis> and is not referred to in
the defining DCE-RFC (see <link linkend="adg-see-also">See also</link>)
below.
</para>
<section id='adg-libpam-functions'>
<section xml:id="adg-libpam-functions">
<title>Functions supplied</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_misc_conv.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_misc_paste_env.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_misc_drop_env.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_misc_setenv.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_misc_conv.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_misc_paste_env.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_misc_drop_env.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_misc_setenv.xml"/>
</section>
</chapter>
<chapter id='adg-porting'>
<chapter xml:id="adg-porting">
<title>Porting legacy applications</title>
<para>
The point of PAM is that the application is not supposed to
@ -545,7 +514,7 @@ cc -o application .... -lpam -lpam_misc
</para>
</chapter>
<chapter id='adg-glossary'>
<chapter xml:id="adg-glossary">
<title>Glossary of PAM related terms</title>
<para>
The following are a list of terms used within this document.
@ -585,17 +554,17 @@ cc -o application .... -lpam -lpam_misc
</variablelist>
</chapter>
<chapter id='adg-example'>
<chapter xml:id="adg-example">
<title>An example application</title>
<para>
To get a flavor of the way a <emphasis remap='B'>Linux-PAM</emphasis>
To get a flavor of the way a <emphasis remap="B">Linux-PAM</emphasis>
application is written we include the following example. It prompts
the user for their password and indicates whether their account
is valid on the standard output, its return code also indicates
the success (<returnvalue>0</returnvalue> for success;
<returnvalue>1</returnvalue> for failure).
</para>
<programlisting><![CDATA[
<programlisting>
/*
This program was contributed by Shane Watts
[modifications by AGM and kukuk]
@ -607,9 +576,9 @@ cc -o application .... -lpam -lpam_misc
account required pam_unix.so
*/
#include <security/pam_appl.h>
#include <security/pam_misc.h>
#include <stdio.h>
#include &lt;security/pam_appl.h&gt;
#include &lt;security/pam_misc.h&gt;
#include &lt;stdio.h&gt;
static struct pam_conv conv = {
misc_conv,
@ -626,12 +595,12 @@ int main(int argc, char *argv[])
user = argv[1];
}
if(argc > 2) {
if(argc &gt; 2) {
fprintf(stderr, "Usage: check_user [username]\n");
exit(1);
}
retval = pam_start("check_user", user, &conv, &pamh);
retval = pam_start("check_user", user, &amp;conv, &amp;pamh);
if (retval == PAM_SUCCESS)
retval = pam_authenticate(pamh, 0); /* is user really user? */
@ -655,24 +624,24 @@ int main(int argc, char *argv[])
return ( retval == PAM_SUCCESS ? 0:1 ); /* indicate success */
}
]]>
</programlisting>
</chapter>
<chapter id='adg-files'>
<chapter xml:id="adg-files">
<title>Files</title>
<variablelist>
<varlistentry>
<term><filename>/usr/include/security/pam_appl.h</filename></term>
<term>/usr/include/security/pam_appl.h</term>
<listitem>
<para>
Header file with interfaces for
<emphasis remap='B'>Linux-PAM</emphasis> applications.
<emphasis remap="B">Linux-PAM</emphasis> applications.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><filename>/usr/include/security/pam_misc.h</filename></term>
<term>/usr/include/security/pam_misc.h</term>
<listitem>
<para>
Header file for useful library functions for making
@ -683,7 +652,7 @@ int main(int argc, char *argv[])
</variablelist>
</chapter>
<chapter id="adg-see-also">
<chapter xml:id="adg-see-also">
<title>See also</title>
<itemizedlist>
<listitem>
@ -706,7 +675,7 @@ int main(int argc, char *argv[])
</itemizedlist>
</chapter>
<chapter id='adg-author'>
<chapter xml:id="adg-author">
<title>Author/acknowledgments</title>
<para>
This document was written by Andrew G. Morgan (morgan@kernel.org)
@ -726,14 +695,14 @@ int main(int argc, char *argv[])
<para>
Thanks are also due to Sun Microsystems, especially to Vipin Samar and
Charlie Lai for their advice. At an early stage in the development of
<emphasis remap='B'>Linux-PAM</emphasis>, Sun graciously made the
<emphasis remap="B">Linux-PAM</emphasis>, Sun graciously made the
documentation for their implementation of PAM available. This act
greatly accelerated the development of
<emphasis remap='B'>Linux-PAM</emphasis>.
<emphasis remap="B">Linux-PAM</emphasis>.
</para>
</chapter>
<chapter id='adg-copyright'>
<chapter xml:id="adg-copyright">
<title>Copyright information for this document</title>
<programlisting>
Copyright (c) 2006 Thorsten Kukuk &lt;kukuk@thkukuk.de&gt;
@ -777,4 +746,4 @@ TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
</programlisting>
</chapter>
</book>
</book>

6
doc/adg/Makefile.am
View File

@ -16,7 +16,7 @@ all: Linux-PAM_ADG.txt html/Linux-PAM_ADG.html Linux-PAM_ADG.pdf
Linux-PAM_ADG.pdf: $(XMLS) $(DEP_XMLS)
if ENABLE_GENERATE_PDF
$(XMLLINT) --nonet --xinclude --postvalid --noent --noout $<
$(XMLLINT) --nonet --xinclude --relaxng $(DOCBOOK_RNG) --noent --noout $<
$(XSLTPROC) --stringparam generate.toc "book toc" \
--stringparam section.autolabel 1 \
--stringparam section.label.includes.component.label 1 \
@ -28,7 +28,7 @@ else
endif
Linux-PAM_ADG.txt: $(XMLS) $(DEP_XMLS)
$(XMLLINT) --nonet --xinclude --postvalid --noent --noout $<
$(XMLLINT) --nonet --xinclude --relaxng $(DOCBOOK_RNG) --noent --noout $<
$(XSLTPROC) --stringparam generate.toc "book toc" \
--stringparam section.autolabel 1 \
--stringparam section.label.includes.component.label 1 \
@ -37,7 +37,7 @@ Linux-PAM_ADG.txt: $(XMLS) $(DEP_XMLS)
html/Linux-PAM_ADG.html: $(XMLS) $(DEP_XMLS)
@test -d html || mkdir -p html
$(XMLLINT) --nonet --xinclude --postvalid --noent --noout $<
$(XMLLINT) --nonet --xinclude --relaxng $(DOCBOOK_RNG) --noent --noout $<
$(XSLTPROC) --stringparam base.dir html/ \
--stringparam root.filename Linux-PAM_ADG \
--stringparam use.id.as.filename 1 \

20
doc/adg/pam_acct_mgmt.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_acct_mgmt'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_acct_mgmt">
<title>Account validation management</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_acct_mgmt.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_acct_mgmt-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_acct_mgmt.3.xml" xpointer='xpointer(id("pam_acct_mgmt-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_acct_mgmt-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_acct_mgmt.3.xml" xpointer='xpointer(//refsect1[@id = "pam_acct_mgmt-description"]/*)'/>
<section xml:id="adg-pam_acct_mgmt-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_acct_mgmt.3.xml" xpointer='xpointer(id("pam_acct_mgmt-description")/*)'/>
</section>
<section id='adg-pam_acct_mgmt-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_acct_mgmt.3.xml" xpointer='xpointer(//refsect1[@id = "pam_acct_mgmt-return_values"]/*)'/>
<section xml:id="adg-pam_acct_mgmt-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_acct_mgmt.3.xml" xpointer='xpointer(id("pam_acct_mgmt-return_values")/*)'/>
</section>
</section>
</section>

20
doc/adg/pam_authenticate.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_authenticate'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_authenticate">
<title>Authenticating the user</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_authenticate.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_authenticate-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_authenticate.3.xml" xpointer='xpointer(id("pam_authenticate-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_authenticate-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_authenticate.3.xml" xpointer='xpointer(//refsect1[@id = "pam_authenticate-description"]/*)'/>
<section xml:id="adg-pam_authenticate-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_authenticate.3.xml" xpointer='xpointer(id("pam_authenticate-description")/*)'/>
</section>
<section id='adg-pam_authenticate-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_authenticate.3.xml" xpointer='xpointer(//refsect1[@id = "pam_authenticate-return_values"]/*)'/>
<section xml:id="adg-pam_authenticate-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_authenticate.3.xml" xpointer='xpointer(id("pam_authenticate-return_values")/*)'/>
</section>
</section>
</section>

20
doc/adg/pam_chauthtok.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_chauthtok'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_chauthtok">
<title>Updating authentication tokens</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_chauthtok.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_chauthtok-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_chauthtok.3.xml" xpointer='xpointer(id("pam_chauthtok-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_chauthtok-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_chauthtok.3.xml" xpointer='xpointer(//refsect1[@id = "pam_chauthtok-description"]/*)'/>
<section xml:id="adg-pam_chauthtok-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_chauthtok.3.xml" xpointer='xpointer(id("pam_chauthtok-description")/*)'/>
</section>
<section id='adg-pam_chauthtok-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_chauthtok.3.xml" xpointer='xpointer(//refsect1[@id = "pam_chauthtok-return_values"]/*)'/>
<section xml:id="adg-pam_chauthtok-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_chauthtok.3.xml" xpointer='xpointer(id("pam_chauthtok-return_values")/*)'/>
</section>
</section>
</section>

20
doc/adg/pam_close_session.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_close_session'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_close_session">
<title>terminating PAM session management</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_close_session.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_close_session-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_close_session.3.xml" xpointer='xpointer(id("pam_close_session-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_close_session-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_close_session.3.xml" xpointer='xpointer(//refsect1[@id = "pam_close_session-description"]/*)'/>
<section xml:id="adg-pam_close_session-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_close_session.3.xml" xpointer='xpointer(id("pam_close_session-description")/*)'/>
</section>
<section id='adg-pam_close_session-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_close_session.3.xml" xpointer='xpointer(//refsect1[@id = "pam_close_session-return_values"]/*)'/>
<section xml:id="adg-pam_close_session-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_close_session.3.xml" xpointer='xpointer(id("pam_close_session-return_values")/*)'/>
</section>
</section>
</section>

20
doc/adg/pam_conv.xml
View File

@ -1,11 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_conv'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_conv">
<title>The conversation function</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_conv.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_conv-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_conv.3.xml" xpointer='xpointer(id("pam_conv-synopsis")/*)'/>
</funcsynopsis>
<programlisting>
struct pam_message {
@ -24,12 +20,10 @@ struct pam_conv {
void *appdata_ptr;
};
</programlisting>
<section id='adg-pam_conv-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_conv.3.xml" xpointer='xpointer(//refsect1[@id = "pam_conv-description"]/*)'/>
<section xml:id="adg-pam_conv-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_conv.3.xml" xpointer='xpointer(id("pam_conv-description")/*)'/>
</section>
<section id='adg-pam_conv-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_conv.3.xml" xpointer='xpointer(//refsect1[@id = "pam_conv-return_values"]/*)'/>
<section xml:id="adg-pam_conv-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_conv.3.xml" xpointer='xpointer(id("pam_conv-return_values")/*)'/>
</section>
</section>
</section>

20
doc/adg/pam_end.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_end'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_end">
<title>Termination of PAM transaction</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_end.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_end-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_end.3.xml" xpointer='xpointer(id("pam_end-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_end-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_end.3.xml" xpointer='xpointer(//refsect1[@id = "pam_end-description"]/*)'/>
<section xml:id="adg-pam_end-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_end.3.xml" xpointer='xpointer(id("pam_end-description")/*)'/>
</section>
<section id='adg-pam_end-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_end.3.xml" xpointer='xpointer(//refsect1[@id = "pam_end-return_values"]/*)'/>
<section xml:id="adg-pam_end-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_end.3.xml" xpointer='xpointer(id("pam_end-return_values")/*)'/>
</section>
</section>
</section>

20
doc/adg/pam_fail_delay.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_fail_delay'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_fail_delay">
<title>Request a delay on failure</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_fail_delay.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_fail_delay-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_fail_delay.3.xml" xpointer='xpointer(id("pam_fail_delay-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_fail_delay-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_fail_delay.3.xml" xpointer='xpointer(//refsect1[@id = "pam_fail_delay-description"]/*)'/>
<section xml:id="adg-pam_fail_delay-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_fail_delay.3.xml" xpointer='xpointer(id("pam_fail_delay-description")/*)'/>
</section>
<section id='adg-pam_fail_delay-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_fail_delay.3.xml" xpointer='xpointer(//refsect1[@id = "pam_fail_delay-return_values"]/*)'/>
<section xml:id="adg-pam_fail_delay-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_fail_delay.3.xml" xpointer='xpointer(id("pam_fail_delay-return_values")/*)'/>
</section>
</section>
</section>

20
doc/adg/pam_get_item.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_get_item'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_get_item">
<title>Getting PAM items</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_get_item.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_get_item-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_get_item.3.xml" xpointer='xpointer(id("pam_get_item-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_get_item-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_get_item.3.xml" xpointer='xpointer(//refsect1[@id = "pam_get_item-description"]/*)'/>
<section xml:id="adg-pam_get_item-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_get_item.3.xml" xpointer='xpointer(id("pam_get_item-description")/*)'/>
</section>
<section id='adg-pam_get_item-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_get_item.3.xml" xpointer='xpointer(//refsect1[@id = "pam_get_item-return_values"]/*)'/>
<section xml:id="adg-pam_get_item-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_get_item.3.xml" xpointer='xpointer(id("pam_get_item-return_values")/*)'/>
</section>
</section>
</section>

20
doc/adg/pam_getenv.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_getenv'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_getenv">
<title>Get a PAM environment variable</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_getenv.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_getenv-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_getenv.3.xml" xpointer='xpointer(id("pam_getenv-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_getenv-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_getenv.3.xml" xpointer='xpointer(//refsect1[@id = "pam_getenv-description"]/*)'/>
<section xml:id="adg-pam_getenv-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_getenv.3.xml" xpointer='xpointer(id("pam_getenv-description")/*)'/>
</section>
<section id='adg-pam_getenv-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_getenv.3.xml" xpointer='xpointer(//refsect1[@id = "pam_getenv-return_values"]/*)'/>
<section xml:id="adg-pam_getenv-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_getenv.3.xml" xpointer='xpointer(id("pam_getenv-return_values")/*)'/>
</section>
</section>
</section>

20
doc/adg/pam_getenvlist.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_getenvlist'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_getenvlist">
<title>Getting the PAM environment</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_getenvlist.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_getenvlist-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_getenvlist.3.xml" xpointer='xpointer(id("pam_getenvlist-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_getenvlist-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_getenvlist.3.xml" xpointer='xpointer(//refsect1[@id = "pam_getenvlist-description"]/*)'/>
<section xml:id="adg-pam_getenvlist-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_getenvlist.3.xml" xpointer='xpointer(id("pam_getenvlist-description")/*)'/>
</section>
<section id='adg-pam_getenvlist-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_getenvlist.3.xml" xpointer='xpointer(//refsect1[@id = "pam_getenvlist-return_values"]/*)'/>
<section xml:id="adg-pam_getenvlist-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_getenvlist.3.xml" xpointer='xpointer(id("pam_getenvlist-return_values")/*)'/>
</section>
</section>
</section>

15
doc/adg/pam_misc_conv.xml
View File

@ -1,14 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-misc_conv'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-misc_conv">
<title>Text based conversation function</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/misc_conv.3.xml" xpointer='xpointer(//funcsynopsis[@id = "misc_conv-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/misc_conv.3.xml" xpointer='xpointer(id("misc_conv-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-misc_conv-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/misc_conv.3.xml" xpointer='xpointer(//refsect1[@id = "misc_conv-description"]/*)'/>
<section xml:id="adg-misc_conv-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/misc_conv.3.xml" xpointer='xpointer(id("misc_conv-description")/*)'/>
</section>
</section>
</section>

15
doc/adg/pam_misc_drop_env.xml
View File

@ -1,14 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_misc_drop_env'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_misc_drop_env">
<title>Liberating a locally saved environment</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_misc_drop_env.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_misc_drop_env-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_misc_drop_env.3.xml" xpointer='xpointer(id("pam_misc_drop_env-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_misc_drop_env-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_misc_drop_env.3.xml" xpointer='xpointer(//refsect1[@id = "pam_misc_drop_env-description"]/*)'/>
<section xml:id="adg-pam_misc_drop_env-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_misc_drop_env.3.xml" xpointer='xpointer(id("pam_misc_drop_env-description")/*)'/>
</section>
</section>
</section>

15
doc/adg/pam_misc_paste_env.xml
View File

@ -1,14 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_misc_paste_env'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_misc_paste_env">
<title>Transcribing an environment to that of PAM</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_misc_paste_env.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_misc_paste_env-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_misc_paste_env.3.xml" xpointer='xpointer(id("pam_misc_paste_env-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_misc_paste_env-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_misc_paste_env.3.xml" xpointer='xpointer(//refsect1[@id = "pam_misc_paste_env-description"]/*)'/>
<section xml:id="adg-pam_misc_paste_env-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_misc_paste_env.3.xml" xpointer='xpointer(id("pam_misc_paste_env-description")/*)'/>
</section>
</section>
</section>

15
doc/adg/pam_misc_setenv.xml
View File

@ -1,14 +1,9 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_misc_setenv'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_misc_setenv">
<title>BSD like PAM environment variable setting</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_misc_setenv.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_misc_setenv-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_misc_setenv.3.xml" xpointer='xpointer(id("pam_misc_setenv-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_misc_setenv-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_misc_setenv.3.xml" xpointer='xpointer(//refsect1[@id = "pam_misc_setenv-description"]/*)'/>
<section xml:id="adg-pam_misc_setenv-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_misc_setenv.3.xml" xpointer='xpointer(id("pam_misc_setenv-description")/*)'/>
</section>
</section>
</section>

20
doc/adg/pam_open_session.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_open_session'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_open_session">
<title>Start PAM session management</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_open_session.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_open_session-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_open_session.3.xml" xpointer='xpointer(id("pam_open_session-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_open_session-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_open_session.3.xml" xpointer='xpointer(//refsect1[@id = "pam_open_session-description"]/*)'/>
<section xml:id="adg-pam_open_session-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_open_session.3.xml" xpointer='xpointer(id("pam_open_session-description")/*)'/>
</section>
<section id='adg-pam_open_session-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_open_session.3.xml" xpointer='xpointer(//refsect1[@id = "pam_open_session-return_values"]/*)'/>
<section xml:id="adg-pam_open_session-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_open_session.3.xml" xpointer='xpointer(id("pam_open_session-return_values")/*)'/>
</section>
</section>
</section>

20
doc/adg/pam_putenv.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_putenv'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_putenv">
<title>Set or change PAM environment variable</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_putenv.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_putenv-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_putenv.3.xml" xpointer='xpointer(id("pam_putenv-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_putenv-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_putenv.3.xml" xpointer='xpointer(//refsect1[@id = "pam_putenv-description"]/*)'/>
<section xml:id="adg-pam_putenv-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_putenv.3.xml" xpointer='xpointer(id("pam_putenv-description")/*)'/>
</section>
<section id='adg-pam_putenv-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_putenv.3.xml" xpointer='xpointer(//refsect1[@id = "pam_putenv-return_values"]/*)'/>
<section xml:id="adg-pam_putenv-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_putenv.3.xml" xpointer='xpointer(id("pam_putenv-return_values")/*)'/>
</section>
</section>
</section>

20
doc/adg/pam_set_item.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_set_item'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_set_item">
<title>Setting PAM items</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_set_item.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_set_item-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_set_item.3.xml" xpointer='xpointer(id("pam_set_item-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_set_item-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_set_item.3.xml" xpointer='xpointer(//refsect1[@id = "pam_set_item-description"]/*)'/>
<section xml:id="adg-pam_set_item-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_set_item.3.xml" xpointer='xpointer(id("pam_set_item-description")/*)'/>
</section>
<section id='adg-pam_set_item-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_set_item.3.xml" xpointer='xpointer(//refsect1[@id = "pam_set_item-return_values"]/*)'/>
<section xml:id="adg-pam_set_item-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_set_item.3.xml" xpointer='xpointer(id("pam_set_item-return_values")/*)'/>
</section>
</section>
</section>

20
doc/adg/pam_setcred.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_setcred'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_setcred">
<title>Setting user credentials</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_setcred.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_setcred-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_setcred.3.xml" xpointer='xpointer(id("pam_setcred-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_setcred-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_setcred.3.xml" xpointer='xpointer(//refsect1[@id = "pam_setcred-description"]/*)'/>
<section xml:id="adg-pam_setcred-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_setcred.3.xml" xpointer='xpointer(id("pam_setcred-description")/*)'/>
</section>
<section id='adg-pam_setcred-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_setcred.3.xml" xpointer='xpointer(//refsect1[@id = "pam_setcred-return_values"]/*)'/>
<section xml:id="adg-pam_setcred-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_setcred.3.xml" xpointer='xpointer(id("pam_setcred-return_values")/*)'/>
</section>
</section>
</section>

20
doc/adg/pam_start.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_start'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_start">
<title>Initialization of PAM transaction</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_start.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_start-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_start.3.xml" xpointer='xpointer(id("pam_start-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_start-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_start.3.xml" xpointer='xpointer(//refsect1[@id = "pam_start-description"]/*)'/>
<section xml:id="adg-pam_start-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_start.3.xml" xpointer='xpointer(id("pam_start-description")/*)'/>
</section>
<section id='adg-pam_start-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_start.3.xml" xpointer='xpointer(//refsect1[@id = "pam_start-return_values"]/*)'/>
<section xml:id="adg-pam_start-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_start.3.xml" xpointer='xpointer(id("pam_start-return_values")/*)'/>
</section>
</section>
</section>

20
doc/adg/pam_strerror.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_strerror'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_strerror">
<title>Strings describing PAM error codes</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_strerror.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_strerror-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_strerror.3.xml" xpointer='xpointer(id("pam_strerror-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_strerror-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_strerror.3.xml" xpointer='xpointer(//refsect1[@id = "pam_strerror-description"]/*)'/>
<section xml:id="adg-pam_strerror-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_strerror.3.xml" xpointer='xpointer(id("pam_strerror-description")/*)'/>
</section>
<section id='adg-pam_strerror-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_strerror.3.xml" xpointer='xpointer(//refsect1[@id = "pam_strerror-return_values"]/*)'/>
<section xml:id="adg-pam_strerror-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_strerror.3.xml" xpointer='xpointer(id("pam_strerror-return_values")/*)'/>
</section>
</section>
</section>

35
doc/man/misc_conv.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="misc_conv">
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="misc_conv">
<refmeta>
<refentrytitle>misc_conv</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="misc_conv-name">
<refnamediv xml:id="misc_conv-name">
<refname>misc_conv</refname>
<refpurpose>text based conversation function</refpurpose>
</refnamediv>
@ -18,7 +15,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id="misc_conv-synopsis">
<funcsynopsis xml:id="misc_conv-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_misc.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>misc_conv</function></funcdef>
@ -30,7 +27,7 @@
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id='misc_conv-description'>
<refsect1 xml:id="misc_conv-description">
<title>DESCRIPTION</title>
<para>
The <function>misc_conv</function> function is part of
@ -50,7 +47,7 @@
</para>
<variablelist>
<varlistentry>
<term><type>time_t</type> <varname>pam_misc_conv_warn_time</varname>;</term>
<term>time_t pam_misc_conv_warn_time;</term>
<listitem>
<para>
This variable contains the <emphasis>time</emphasis> (as
@ -67,7 +64,7 @@
</varlistentry>
<varlistentry>
<term><type>const char *</type><varname>pam_misc_conv_warn_line</varname>;</term>
<term>const char *pam_misc_conv_warn_line;</term>
<listitem>
<para>
Used in conjunction with
@ -83,7 +80,7 @@
</varlistentry>
<varlistentry>
<term><type>time_t</type> <varname>pam_misc_conv_die_time</varname>;</term>
<term>time_t pam_misc_conv_die_time;</term>
<listitem>
<para>
This variable contains the <emphasis>time</emphasis> (as
@ -100,7 +97,7 @@
</varlistentry>
<varlistentry>
<term><type>const char *</type><varname>pam_misc_conv_die_line</varname>;</term>
<term>const char *pam_misc_conv_die_line;</term>
<listitem>
<para>
Used in conjunction with
@ -116,7 +113,7 @@
</varlistentry>
<varlistentry>
<term><type>int</type> <varname>pam_misc_conv_died</varname>;</term>
<term>int pam_misc_conv_died;</term>
<listitem>
<para>
Following a return from the <emphasis>Linux-PAM</emphasis>
@ -136,7 +133,7 @@
<variablelist>
<varlistentry>
<term>
<type>int</type> <varname>(*pam_binary_handler_fn)</varname>(<type>void *</type><varname>appdata</varname>, <type>pamc_bp_t *</type><varname>prompt_p</varname>);
int (*pam_binary_handler_fn)(void *appdata, pamc_bp_t *prompt_p);
</term>
<listitem>
<para>
@ -151,7 +148,7 @@
</varlistentry>
<varlistentry>
<term>
<type>int</type> <varname>(*pam_binary_handler_free)</varname>(<type>void *</type><varname>appdata</varname>, <type>pamc_bp_t *</type><varname>delete_me</varname>);
int (*pam_binary_handler_free)(void *appdata, pamc_bp_t *delete_me);
</term>
<listitem>
<para>
@ -164,7 +161,7 @@
</variablelist>
</refsect1>
<refsect1 id='misc_conv-see_also'>
<refsect1 xml:id="misc_conv-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -176,7 +173,7 @@
</para>
</refsect1>
<refsect1 id='misc_conv-standards'>
<refsect1 xml:id="misc_conv-standards">
<title>STANDARDS</title>
<para>
The <function>misc_conv</function> function is part of the
@ -185,4 +182,4 @@
</para>
</refsect1>
</refentry>
</refentry>

40
doc/man/pam.3.xml
View File

@ -1,20 +1,18 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam3'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam3">
<refmeta>
<refentrytitle>pam</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id='pam3-name'>
<refnamediv xml:id="pam3-name">
<refname>pam</refname>
<refpurpose>Pluggable Authentication Modules Library</refpurpose>
</refnamediv>
<refsynopsisdiv id='pam3-synopsis'>
<refsynopsisdiv xml:id="pam3-synopsis">
<funcsynopsis>
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
<funcsynopsisinfo>#include &lt;security/pam_modules.h&gt;</funcsynopsisinfo>
@ -22,10 +20,10 @@
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id='pam3-description'>
<refsect1 xml:id="pam3-description">
<title>DESCRIPTION</title>
<para>
<emphasis remap='B'>PAM</emphasis> is a system of libraries
<emphasis remap="B">PAM</emphasis> is a system of libraries
that handle the authentication tasks of applications (services)
on the system. The library provides a stable general interface
(Application Programming Interface - API) that privilege granting
@ -38,7 +36,7 @@
defer to to perform standard authentication tasks.
</para>
<refsect2 id='pam3-initialization_and_cleanup'>
<refsect2 xml:id="pam3-initialization_and_cleanup">
<title>Initialization and Cleanup</title>
<para>
The
@ -64,7 +62,7 @@
</para>
</refsect2>
<refsect2 id='pam3-authentication'>
<refsect2 xml:id="pam3-authentication">
<title>Authentication</title>
<para>
The
@ -85,7 +83,7 @@
</para>
</refsect2>
<refsect2 id='pam3-account_management'>
<refsect2 xml:id="pam3-account_management">
<title>Account Management</title>
<para>
The
@ -98,7 +96,7 @@
</para>
</refsect2>
<refsect2 id='pam3-password_management'>
<refsect2 xml:id="pam3-password_management">
<title>Password Management</title>
<para>
The
@ -109,7 +107,7 @@
</para>
</refsect2>
<refsect2 id='pam3-session_management'>
<refsect2 xml:id="pam3-session_management">
<title>Session Management</title>
<para>
The
@ -124,7 +122,7 @@
</para>
</refsect2>
<refsect2 id='pam3-conversation'>
<refsect2 xml:id="pam3-conversation">
<title>Conversation</title>
<para>
The PAM library uses an application-defined callback to allow
@ -141,7 +139,7 @@
</para>
</refsect2>
<refsect2 id='pam3-data'>
<refsect2 xml:id="pam3-data">
<title>Data Objects</title>
<para>
The
@ -176,7 +174,7 @@
</para>
</refsect2>
<refsect2 id='pam3-miscellaneous'>
<refsect2 xml:id="pam3-miscellaneous">
<title>Environment and Error Management</title>
<para>
The
@ -202,7 +200,7 @@
</refsect2>
</refsect1>
<refsect1 id='pam3-return_values'>
<refsect1 xml:id="pam3-return_values">
<title>RETURN VALUES</title>
<para>
The following return codes are known by PAM:
@ -389,7 +387,7 @@
</variablelist>
</refsect1>
<refsect1 id='see_also'><title>SEE ALSO</title>
<refsect1 xml:id="see_also"><title>SEE ALSO</title>
<para>
<citerefentry>
<refentrytitle>pam_acct_mgmt</refentrytitle><manvolnum>3</manvolnum>
@ -430,10 +428,10 @@
</citerefentry>
</para>
</refsect1>
<refsect1 id='pam3-notes'><title>NOTES</title>
<refsect1 xml:id="pam3-notes"><title>NOTES</title>
<para>
The <emphasis>libpam</emphasis> interfaces are only thread-safe if each
thread within the multithreaded application uses its own PAM handle.
</para>
</refsect1>
</refentry>
</refentry>

85
doc/man/pam.8.xml
View File

@ -1,32 +1,29 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam8'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam8">
<refmeta>
<refentrytitle>pam</refentrytitle>
<manvolnum>8</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id='pam8-name'>
<refnamediv xml:id="pam8-name">
<refname>PAM</refname>
<refname>pam</refname>
<refpurpose>Pluggable Authentication Modules for Linux</refpurpose>
</refnamediv>
<refsect1 id='pam8-description'>
<refsect1 xml:id="pam8-description">
<title>DESCRIPTION</title>
<para>
This manual is intended to offer a quick introduction to
<emphasis remap='B'>Linux-PAM</emphasis>. For more information
<emphasis remap="B">Linux-PAM</emphasis>. For more information
the reader is directed to the
<emphasis remap='B'>Linux-PAM system administrators' guide</emphasis>.
<emphasis remap="B">Linux-PAM system administrators' guide</emphasis>.
</para>
<para>
<emphasis remap='B'>Linux-PAM</emphasis> is a system of libraries
<emphasis remap="B">Linux-PAM</emphasis> is a system of libraries
that handle the authentication tasks of applications (services) on
the system. The library provides a stable general interface
(Application Programming Interface - API) that privilege granting
@ -43,12 +40,12 @@
system administrator is free to choose how individual
service-providing applications will authenticate users. This dynamic
configuration is set by the contents of the single
<emphasis remap='B'>Linux-PAM</emphasis> configuration file
<emphasis remap="B">Linux-PAM</emphasis> configuration file
<filename>/etc/pam.conf</filename>. Alternatively, the configuration
can be set by individual configuration files located in the
<filename>/etc/pam.d/</filename> directory. The presence of this
directory will cause <emphasis remap='B'>Linux-PAM</emphasis> to
<emphasis remap='I'>ignore</emphasis> <filename>/etc/pam.conf</filename>.
directory will cause <emphasis remap="B">Linux-PAM</emphasis> to
<emphasis remap="I">ignore</emphasis> <filename>/etc/pam.conf</filename>.
</para>
<para>
@ -64,26 +61,26 @@
<para>From the point of view of the system administrator, for whom this
manual is provided, it is not of primary importance to understand the
internal behavior of the
<emphasis remap='B'>Linux-PAM</emphasis>
<emphasis remap="B">Linux-PAM</emphasis>
library. The important point to recognize is that the configuration
file(s)
<emphasis remap='I'>define</emphasis>
<emphasis remap="I">define</emphasis>
the connection between applications
<emphasis remap='B'></emphasis>(<emphasis remap='B'>services</emphasis>)
<emphasis remap="B"/>(<emphasis remap="B">services</emphasis>)
and the pluggable authentication modules
<emphasis remap='B'></emphasis>(<emphasis remap='B'>PAM</emphasis>s)
<emphasis remap="B"/>(<emphasis remap="B">PAM</emphasis>s)
that perform the actual authentication tasks.</para>
<para><emphasis remap='B'>Linux-PAM</emphasis>
<para><emphasis remap="B">Linux-PAM</emphasis>
separates the tasks of
<emphasis remap='I'>authentication</emphasis>
<emphasis remap="I">authentication</emphasis>
into four independent management groups:
<emphasis remap='B'>account</emphasis> management;
<emphasis remap='B'>auth</emphasis>entication management;
<emphasis remap='B'>password</emphasis> management;
<emphasis remap="B">account</emphasis> management;
<emphasis remap="B">auth</emphasis>entication management;
<emphasis remap="B">password</emphasis> management;
and
<emphasis remap='B'>session</emphasis> management.
<emphasis remap="B">session</emphasis> management.
(We highlight the abbreviations used for these groups in the
configuration file.)</para>
@ -92,12 +89,12 @@ configuration file.)</para>
user's request for a restricted service:</para>
<para><emphasis remap='B'>account</emphasis> -
<para><emphasis remap="B">account</emphasis> -
provide account verification types of service: has the user's password
expired?; is this user permitted access to the requested service?</para>
<!-- .br -->
<para><emphasis remap='B'>auth</emphasis>entication -
<para><emphasis remap="B">auth</emphasis>entication -
authenticate a user and set up user credentials. Typically this is via
some challenge-response request that the user must satisfy: if you are
who you claim to be please enter your password. Not all authentications
@ -105,64 +102,64 @@ are of this type, there exist hardware based authentication schemes
(such as the use of smart-cards and biometric devices), with suitable
modules, these may be substituted seamlessly for more standard
approaches to authentication - such is the flexibility of
<emphasis remap='B'>Linux-PAM</emphasis>.</para>
<emphasis remap="B">Linux-PAM</emphasis>.</para>
<!-- .br -->
<para><emphasis remap='B'>password</emphasis> -
<para><emphasis remap="B">password</emphasis> -
this group's responsibility is the task of updating authentication
mechanisms. Typically, such services are strongly coupled to those of
the
<emphasis remap='B'>auth</emphasis>
<emphasis remap="B">auth</emphasis>
group. Some authentication mechanisms lend themselves well to being
updated with such a function. Standard UN*X password-based access is
the obvious example: please enter a replacement password.</para>
<!-- .br -->
<para><emphasis remap='B'>session</emphasis> -
<para><emphasis remap="B">session</emphasis> -
this group of tasks cover things that should be done prior to a
service being given and after it is withdrawn. Such tasks include the
maintenance of audit trails and the mounting of the user's home
directory. The
<emphasis remap='B'>session</emphasis>
<emphasis remap="B">session</emphasis>
management group is important as it provides both an opening and
closing hook for modules to affect the services available to a user.</para>
</refsect1>
<refsect1 id='pam8-files'>
<refsect1 xml:id="pam8-files">
<title>FILES</title>
<variablelist>
<varlistentry>
<term><filename>/etc/pam.conf</filename></term>
<term>/etc/pam.conf</term>
<listitem>
<para>the configuration file</para>
</listitem>
</varlistentry>
<varlistentry>
<term><filename>/etc/pam.d</filename></term>
<term>/etc/pam.d</term>
<listitem>
<para>
the <emphasis remap='B'>Linux-PAM</emphasis> configuration
the <emphasis remap="B">Linux-PAM</emphasis> configuration
directory. Generally, if this directory is present, the
<filename>/etc/pam.conf</filename> file is ignored.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><filename>/usr/lib/pam.d</filename></term>
<term>/usr/lib/pam.d</term>
<listitem>
<para>
the <emphasis remap='B'>Linux-PAM</emphasis> vendor configuration
the <emphasis remap="B">Linux-PAM</emphasis> vendor configuration
directory. Files in <filename>/etc/pam.d</filename> override
files with the same name in this directory.
</para>
</listitem>
</varlistentry>
<varlistentry condition="with_vendordir">
<term><filename>%vendordir%/pam.d</filename></term>
<term>%vendordir%/pam.d</term>
<listitem>
<para>
the <emphasis remap='B'>Linux-PAM</emphasis> vendor configuration
the <emphasis remap="B">Linux-PAM</emphasis> vendor configuration
directory. Files in <filename>/etc/pam.d</filename> and
<filename>/usr/lib/pam.d</filename> override files with the same
name in this directory.
@ -172,18 +169,18 @@ closing hook for modules to affect the services available to a user.</para>
</variablelist>
</refsect1>
<refsect1 id='pam8-errors'>
<refsect1 xml:id="pam8-errors">
<title>ERRORS</title>
<para>
Typically errors generated by the
<emphasis remap='B'>Linux-PAM</emphasis> system of libraries, will
<emphasis remap="B">Linux-PAM</emphasis> system of libraries, will
be written to <citerefentry>
<refentrytitle>syslog</refentrytitle><manvolnum>3</manvolnum>
</citerefentry>.
</para>
</refsect1>
<refsect1 id='pam8-conforming_to'>
<refsect1 xml:id="pam8-conforming_to">
<title>CONFORMING TO</title>
<para>
DCE-RFC 86.0, October 1995.
@ -192,7 +189,7 @@ closing hook for modules to affect the services available to a user.</para>
</para>
</refsect1>
<refsect1 id='pam8-see_also'>
<refsect1 xml:id="pam8-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -212,4 +209,4 @@ closing hook for modules to affect the services available to a user.</para>
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

7
doc/man/pam.conf-desc.xml
View File

@ -1,7 +1,4 @@
<?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-desc'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam.conf-desc">
<para>
When a <emphasis>PAM</emphasis> aware privilege granting application
is started, it activates its attachment to the PAM-API. This
@ -18,4 +15,4 @@
behavior of the PAM-API in the event that individual
<emphasis>PAM</emphasis>s fail.
</para>
</section>
</section>

9
doc/man/pam.conf-dir.xml
View File

@ -1,7 +1,4 @@
<?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'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam.conf-dir">
<para>
More flexible than the single configuration file is it to
configure libpam via the contents of the
@ -25,6 +22,6 @@ type control module-path module-arguments
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.
configuration for the <emphasis remap="B">login</emphasis> service.
</para>
</section>
</section>

12
doc/man/pam.conf-syntax.xml
View File

@ -1,8 +1,4 @@
<?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-syntax'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam.conf-syntax">
<para>
The syntax of the <filename>/etc/pam.conf</filename>
configuration file is as follows. The file is made up of a list
@ -18,7 +14,7 @@
</para>
<para>
<emphasis remap='B'> service type control module-path module-arguments</emphasis>
<emphasis remap="B"> service type control module-path module-arguments</emphasis>
</para>
<para>
@ -411,7 +407,7 @@
should use `\]'. In other words:
</para>
<programlisting>
[..[..\]..] --> ..[..]..
[..[..\]..] --&gt; ..[..]..
</programlisting>
<para>
@ -424,4 +420,4 @@
</citerefentry>.
</para>
</section>
</section>

28
doc/man/pam.conf.5.xml
View File

@ -1,15 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam.conf'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam.conf">
<refmeta>
<refentrytitle>pam.conf</refentrytitle>
<manvolnum>5</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id='pam.conf-name'>
<refnamediv xml:id="pam.conf-name">
<refname>pam.conf</refname>
<refname>pam.d</refname>
<refpurpose>PAM configuration files</refpurpose>
@ -17,22 +15,16 @@
<!-- body begins here -->
<refsect1 id='pam.conf-description'>
<refsect1 xml:id="pam.conf-description">
<title>DESCRIPTION</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam.conf-desc.xml"
xpointer='xpointer(//section[@id = "pam.conf-desc"]/*)' />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam.conf-desc.xml" xpointer='xpointer(id("pam.conf-desc")/*)' />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam.conf-syntax.xml"
xpointer='xpointer(//section[@id = "pam.conf-syntax"]/*)' />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam.conf-syntax.xml" xpointer='xpointer(id("pam.conf-syntax")/*)' />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam.conf-dir.xml"
xpointer='xpointer(//section[@id = "pam.conf-dir"]/*)' />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam.conf-dir.xml" xpointer='xpointer(id("pam.conf-dir")/*)' />
</refsect1>
<refsect1 id='pam.conf-see_also'>
<refsect1 xml:id="pam.conf-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -47,4 +39,4 @@
</para>
</refsect1>
</refentry>
</refentry>

20
doc/man/pam_acct_mgmt.3.xml
View File

@ -1,14 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_acct_mgmt'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_acct_mgmt">
<refmeta>
<refentrytitle>pam_acct_mgmt</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_acct_mgmt-name">
<refnamediv xml:id="pam_acct_mgmt-name">
<refname>pam_acct_mgmt</refname>
<refpurpose>PAM account validation management</refpurpose>
</refnamediv>
@ -16,7 +14,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id='pam_acct_mgmt-synopsis'>
<funcsynopsis xml:id="pam_acct_mgmt-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_acct_mgmt</function></funcdef>
@ -27,7 +25,7 @@
</refsynopsisdiv>
<refsect1 id='pam_acct_mgmt-description'>
<refsect1 xml:id="pam_acct_mgmt-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_acct_mgmt</function> function is used to determine
@ -62,7 +60,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_acct_mgmt-return_values">
<refsect1 xml:id="pam_acct_mgmt-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -122,7 +120,7 @@
</variablelist>
</refsect1>
<refsect1 id='pam_acct_mgmt-see_also'>
<refsect1 xml:id="pam_acct_mgmt-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -142,4 +140,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

20
doc/man/pam_authenticate.3.xml
View File

@ -1,14 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_authenticate'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_authenticate">
<refmeta>
<refentrytitle>pam_authenticate</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_authenticate-name">
<refnamediv xml:id="pam_authenticate-name">
<refname>pam_authenticate</refname>
<refpurpose>account authentication</refpurpose>
</refnamediv>
@ -16,7 +14,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id='pam_authenticate-synopsis'>
<funcsynopsis xml:id="pam_authenticate-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_authenticate</function></funcdef>
@ -27,7 +25,7 @@
</refsynopsisdiv>
<refsect1 id='pam_authenticate-description'>
<refsect1 xml:id="pam_authenticate-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_authenticate</function> function is used to
@ -77,7 +75,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_authenticate-return_values">
<refsect1 xml:id="pam_authenticate-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -146,7 +144,7 @@
</variablelist>
</refsect1>
<refsect1 id='pam_authenticate-see_also'>
<refsect1 xml:id="pam_authenticate-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -166,4 +164,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

20
doc/man/pam_chauthtok.3.xml
View File

@ -1,14 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_chauthtok'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_chauthtok">
<refmeta>
<refentrytitle>pam_chauthtok</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_chauthtok-name">
<refnamediv xml:id="pam_chauthtok-name">
<refname>pam_chauthtok</refname>
<refpurpose>updating authentication tokens</refpurpose>
</refnamediv>
@ -16,7 +14,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id='pam_chauthtok-synopsis'>
<funcsynopsis xml:id="pam_chauthtok-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_chauthtok</function></funcdef>
@ -27,7 +25,7 @@
</refsynopsisdiv>
<refsect1 id='pam_chauthtok-description'>
<refsect1 xml:id="pam_chauthtok-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_chauthtok</function> function is used to change the
@ -64,7 +62,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_chauthtok-return_values">
<refsect1 xml:id="pam_chauthtok-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -138,7 +136,7 @@
</variablelist>
</refsect1>
<refsect1 id='pam_chauthtok-see_also'>
<refsect1 xml:id="pam_chauthtok-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -161,4 +159,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

21
doc/man/pam_close_session.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_send'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_send">
<refmeta>
<refentrytitle>pam_close_session</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_close_session-name">
<refnamediv xml:id="pam_close_session-name">
<refname>pam_close_session</refname>
<refpurpose>terminate PAM session management</refpurpose>
</refnamediv>
@ -18,7 +15,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id="pam_close_session-synopsis">
<funcsynopsis xml:id="pam_close_session-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_close_session</function></funcdef>
@ -29,7 +26,7 @@
</refsynopsisdiv>
<refsect1 id="pam_close_session-description">
<refsect1 xml:id="pam_close_session-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_close_session</function> function is used
@ -63,7 +60,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_close_session-return_values">
<refsect1 xml:id="pam_close_session-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -101,7 +98,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_close_session-see_also">
<refsect1 xml:id="pam_close_session-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -112,4 +109,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

20
doc/man/pam_conv.3.xml
View File

@ -1,14 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_conv'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_conv">
<refmeta>
<refentrytitle>pam_conv</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_conv-name">
<refnamediv xml:id="pam_conv-name">
<refname>pam_conv</refname>
<refpurpose>PAM conversation function</refpurpose>
</refnamediv>
@ -16,7 +14,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id="pam_conv-synopsis">
<funcsynopsis xml:id="pam_conv-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
</funcsynopsis>
<programlisting>
@ -38,7 +36,7 @@ struct pam_conv {
</programlisting>
</refsynopsisdiv>
<refsect1 id='pam_conv-description'>
<refsect1 xml:id="pam_conv-description">
<title>DESCRIPTION</title>
<para>
The PAM library uses an application-defined callback to allow
@ -174,7 +172,7 @@ struct pam_conv {
</itemizedlist>
</refsect1>
<refsect1 id="pam_conv-return_values">
<refsect1 xml:id="pam_conv-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -205,7 +203,7 @@ struct pam_conv {
</variablelist>
</refsect1>
<refsect1 id='pam_conv-see_also'>
<refsect1 xml:id="pam_conv-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -225,4 +223,4 @@ struct pam_conv {
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

21
doc/man/pam_end.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_end'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_end">
<refmeta>
<refentrytitle>pam_end</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_end-name">
<refnamediv xml:id="pam_end-name">
<refname>pam_end</refname>
<refpurpose>termination of PAM transaction</refpurpose>
</refnamediv>
@ -18,7 +15,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id="pam_end-synopsis">
<funcsynopsis xml:id="pam_end-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_end</function></funcdef>
@ -29,7 +26,7 @@
</refsynopsisdiv>
<refsect1 id="pam_end-description">
<refsect1 xml:id="pam_end-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_end</function> function terminates the PAM
@ -79,7 +76,7 @@
</para>
</refsect1>
<refsect1 id="pam_end-return_values">
<refsect1 xml:id="pam_end-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -102,7 +99,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_end-see_also">
<refsect1 xml:id="pam_end-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -119,4 +116,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

23
doc/man/pam_error.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="pam_error">
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_error">
<refmeta>
<refentrytitle>pam_error</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_error-name">
<refnamediv xml:id="pam_error-name">
<refname>pam_error</refname>
<refname>pam_verror</refname>
<refpurpose>display error messages to the user</refpurpose>
@ -18,7 +15,7 @@
<!-- body begins here -->
<refsynopsisdiv id="pam_error-synopsis">
<refsynopsisdiv xml:id="pam_error-synopsis">
<funcsynopsis>
<funcsynopsisinfo>#include &lt;security/pam_ext.h&gt;</funcsynopsisinfo>
<funcprototype>
@ -36,7 +33,7 @@
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id='pam_error-description'>
<refsect1 xml:id="pam_error-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_error</function> function prints error messages
@ -51,7 +48,7 @@
</citerefentry> variable argument list macros.
</para>
</refsect1>
<refsect1 id="pam_error-return_values">
<refsect1 xml:id="pam_error-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -89,7 +86,7 @@
</variablelist>
</refsect1>
<refsect1 id='pam_error-see_also'>
<refsect1 xml:id="pam_error-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -110,7 +107,7 @@
</para>
</refsect1>
<refsect1 id='pam_error-standards'>
<refsect1 xml:id="pam_error-standards">
<title>STANDARDS</title>
<para>
The <function>pam_error</function> and <function>pam_verror</function>
@ -118,4 +115,4 @@
</para>
</refsect1>
</refentry>
</refentry>

27
doc/man/pam_fail_delay.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="pam_fail_delay">
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_fail_delay">
<refmeta>
<refentrytitle>pam_fail_delay</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_fail_delay-name">
<refnamediv xml:id="pam_fail_delay-name">
<refname>pam_fail_delay</refname>
<refpurpose>request a delay on failure</refpurpose>
</refnamediv>
@ -18,7 +15,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id="pam_fail_delay-synopsis">
<funcsynopsis xml:id="pam_fail_delay-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_fail_delay</function></funcdef>
@ -28,7 +25,7 @@
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id='pam_fail_delay-description'>
<refsect1 xml:id="pam_fail_delay-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_fail_delay</function> function provides a
@ -105,7 +102,7 @@ void (*delay_fn)(int retval, unsigned usec_delay, void *appdata_ptr);
</para>
</refsect1>
<refsect1 id='pam_fail_delay-rationale'>
<refsect1 xml:id="pam_fail_delay-rationale">
<title>RATIONALE</title>
<para>
It is often possible to attack an authentication scheme by exploiting
@ -129,7 +126,7 @@ void (*delay_fn)(int retval, unsigned usec_delay, void *appdata_ptr);
</para>
</refsect1>
<refsect1 id='pam_fail_delay-example'>
<refsect1 xml:id="pam_fail_delay-example">
<title>EXAMPLE</title>
<para>
For example, a login application may require a failure delay of
@ -161,7 +158,7 @@ module #2: pam_fail_delay (pamh, 4000000);
</para>
</refsect1>
<refsect1 id='pam_fail_delay-return_values'>
<refsect1 xml:id="pam_fail_delay-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -183,7 +180,7 @@ module #2: pam_fail_delay (pamh, 4000000);
</variablelist>
</refsect1>
<refsect1 id='pam_fail_delay-see_also'>
<refsect1 xml:id="pam_fail_delay-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -198,7 +195,7 @@ module #2: pam_fail_delay (pamh, 4000000);
</para>
</refsect1>
<refsect1 id='pam_fail_delay-standards'>
<refsect1 xml:id="pam_fail_delay-standards">
<title>STANDARDS</title>
<para>
The <function>pam_fail_delay</function> function is an
@ -206,4 +203,4 @@ module #2: pam_fail_delay (pamh, 4000000);
</para>
</refsect1>
</refentry>
</refentry>

33
doc/man/pam_get_authtok.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="pam_get_authtok">
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_get_authtok">
<refmeta>
<refentrytitle>pam_get_authtok</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_get_authtok-name">
<refnamediv xml:id="pam_get_authtok-name">
<refname>pam_get_authtok</refname>
<refname>pam_get_authtok_verify</refname>
<refname>pam_get_authtok_noverify</refname>
@ -19,7 +16,7 @@
<!-- body begins here -->
<refsynopsisdiv id="pam_get_authtok-synopsis">
<refsynopsisdiv xml:id="pam_get_authtok-synopsis">
<funcsynopsis>
<funcsynopsisinfo>#include &lt;security/pam_ext.h&gt;</funcsynopsisinfo>
<funcprototype>
@ -44,7 +41,7 @@
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id='pam_get_authtok-description'>
<refsect1 xml:id="pam_get_authtok-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_get_authtok</function> function returns the
@ -119,7 +116,7 @@
</para>
</refsect1>
<refsect1 id="pam_get_authtok-options">
<refsect1 xml:id="pam_get_authtok-options">
<title>OPTIONS</title>
<para>
<function>pam_get_authtok</function> honours the following module
@ -128,7 +125,7 @@
<variablelist>
<varlistentry>
<term>
<option>try_first_pass</option>
try_first_pass
</term>
<listitem>
<para>
@ -140,7 +137,7 @@
</varlistentry>
<varlistentry>
<term>
<option>use_first_pass</option>
use_first_pass
</term>
<listitem>
<para>
@ -153,7 +150,7 @@
</varlistentry>
<varlistentry>
<term>
<option>use_authtok</option>
use_authtok
</term>
<listitem>
<para>
@ -166,7 +163,7 @@
</varlistentry>
<varlistentry>
<term>
<option>authtok_type=<replaceable>XXX</replaceable></option>
authtok_type=XXX
</term>
<listitem>
<para>
@ -182,7 +179,7 @@
</refsect1>
<refsect1 id="pam_get_authtok-return_values">
<refsect1 xml:id="pam_get_authtok-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -228,7 +225,7 @@
</variablelist>
</refsect1>
<refsect1 id='pam_get_authtok-see_also'>
<refsect1 xml:id="pam_get_authtok-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -237,7 +234,7 @@
</para>
</refsect1>
<refsect1 id='pam_get_authtok-standards'>
<refsect1 xml:id="pam_get_authtok-standards">
<title>STANDARDS</title>
<para>
The <function>pam_get_authtok</function> function is a Linux-PAM
@ -245,4 +242,4 @@
</para>
</refsect1>
</refentry>
</refentry>

21
doc/man/pam_get_data.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_get_data'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_get_data">
<refmeta>
<refentrytitle>pam_get_data</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id='pam_get_data-name'>
<refnamediv xml:id="pam_get_data-name">
<refname>pam_get_data</refname>
<refpurpose>
get module internal data
@ -22,7 +19,7 @@
<refsynopsisdiv>
<funcsynopsis id="pam_get_data-synopsis">
<funcsynopsis xml:id="pam_get_data-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_modules.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_get_data</function></funcdef>
@ -35,7 +32,7 @@
</refsynopsisdiv>
<refsect1 id="pam_get_data-description">
<refsect1 xml:id="pam_get_data-description">
<title>DESCRIPTION</title>
<para>
This function together with the
@ -58,7 +55,7 @@
</para>
</refsect1>
<refsect1 id="pam_get_data-return_values">
<refsect1 xml:id="pam_get_data-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -90,7 +87,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_get_data-see_also">
<refsect1 xml:id="pam_get_data-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -105,4 +102,4 @@
</para>
</refsect1>
</refentry>
</refentry>

33
doc/man/pam_get_item.3.xml
View File

@ -1,22 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
[
<!--
<!ENTITY accessconf SYSTEM "pam_item_types_std.inc.xml">
<!ENTITY accessconf SYSTEM "pam_item_types_ext.inc.xml">
-->
]>
<refentry id='pam_get_item'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_get_item">
<refmeta>
<refentrytitle>pam_get_item</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id='pam_get_item-name'>
<refnamediv xml:id="pam_get_item-name">
<refname>pam_get_item</refname>
<refpurpose>
getting PAM information
@ -28,7 +19,7 @@
<refsynopsisdiv>
<funcsynopsis id="pam_get_item-synopsis">
<funcsynopsis xml:id="pam_get_item-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_modules.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_get_item</function></funcdef>
@ -41,7 +32,7 @@
</refsynopsisdiv>
<refsect1 id="pam_get_item-description">
<refsect1 xml:id="pam_get_item-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_get_item</function> function allows applications
@ -55,16 +46,14 @@
<emphasis>item_type</emphasis>:
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_item_types_std.inc.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_item_types_std.inc.xml"/>
<para>
The following additional items are specific to Linux-PAM and should not be used in
portable applications:
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_item_types_ext.inc.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_item_types_ext.inc.xml"/>
<para>
If a service module wishes to obtain the name of the user,
@ -80,7 +69,7 @@
</refsect1>
<refsect1 id="pam_get_item-return_values">
<refsect1 xml:id="pam_get_item-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -128,7 +117,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_get_item-see_also">
<refsect1 xml:id="pam_get_item-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -140,4 +129,4 @@
</para>
</refsect1>
</refentry>
</refentry>

21
doc/man/pam_get_user.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_get_user'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_get_user">
<refmeta>
<refentrytitle>pam_get_user</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id='pam_get_user-name'>
<refnamediv xml:id="pam_get_user-name">
<refname>pam_get_user</refname>
<refpurpose>
get user name
@ -22,7 +19,7 @@
<refsynopsisdiv>
<funcsynopsis id="pam_get_user-synopsis">
<funcsynopsis xml:id="pam_get_user-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_modules.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_get_user</function></funcdef>
@ -35,7 +32,7 @@
</refsynopsisdiv>
<refsect1 id="pam_get_user-description">
<refsect1 xml:id="pam_get_user-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_get_user</function> function returns the
@ -87,7 +84,7 @@
</para>
</refsect1>
<refsect1 id="pam_get_user-return_values">
<refsect1 xml:id="pam_get_user-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -143,7 +140,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_get_user-see_also">
<refsect1 xml:id="pam_get_user-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -161,4 +158,4 @@
</para>
</refsect1>
</refentry>
</refentry>

20
doc/man/pam_getenv.3.xml
View File

@ -1,14 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_getenv'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_getenv">
<refmeta>
<refentrytitle>pam_getenv</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_getenv-name">
<refnamediv xml:id="pam_getenv-name">
<refname>pam_getenv</refname>
<refpurpose>get a PAM environment variable</refpurpose>
</refnamediv>
@ -16,7 +14,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id='pam_getenv-synopsis'>
<funcsynopsis xml:id="pam_getenv-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>const char *<function>pam_getenv</function></funcdef>
@ -27,7 +25,7 @@
</refsynopsisdiv>
<refsect1 id='pam_getenv-description'>
<refsect1 xml:id="pam_getenv-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_getenv</function> function searches the
@ -39,7 +37,7 @@
</para>
</refsect1>
<refsect1 id="pam_getenv-return_values">
<refsect1 xml:id="pam_getenv-return_values">
<title>RETURN VALUES</title>
<para>
The <function>pam_getenv</function> function returns NULL
@ -47,7 +45,7 @@
</para>
</refsect1>
<refsect1 id='pam_getenv-see_also'>
<refsect1 xml:id="pam_getenv-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -64,4 +62,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

20
doc/man/pam_getenvlist.3.xml
View File

@ -1,14 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_getenvlist'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_getenvlist">
<refmeta>
<refentrytitle>pam_getenvlist</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_getenvlist-name">
<refnamediv xml:id="pam_getenvlist-name">
<refname>pam_getenvlist</refname>
<refpurpose>getting the PAM environment</refpurpose>
</refnamediv>
@ -16,7 +14,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id='pam_getenvlist-synopsis'>
<funcsynopsis xml:id="pam_getenvlist-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>char **<function>pam_getenvlist</function></funcdef>
@ -26,7 +24,7 @@
</refsynopsisdiv>
<refsect1 id='pam_getenvlist-description'>
<refsect1 xml:id="pam_getenvlist-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_getenvlist</function> function returns a complete
@ -57,7 +55,7 @@
</para>
</refsect1>
<refsect1 id="pam_getenvlist-return_values">
<refsect1 xml:id="pam_getenvlist-return_values">
<title>RETURN VALUES</title>
<para>
The <function>pam_getenvlist</function> function returns NULL
@ -65,7 +63,7 @@
</para>
</refsect1>
<refsect1 id='pam_getenvlist-see_also'>
<refsect1 xml:id="pam_getenvlist-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -82,4 +80,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

23
doc/man/pam_info.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="pam_info">
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_info">
<refmeta>
<refentrytitle>pam_info</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_info-name">
<refnamediv xml:id="pam_info-name">
<refname>pam_info</refname>
<refname>pam_vinfo</refname>
<refpurpose>display messages to the user</refpurpose>
@ -18,7 +15,7 @@
<!-- body begins here -->
<refsynopsisdiv id="pam_info-synopsis">
<refsynopsisdiv xml:id="pam_info-synopsis">
<funcsynopsis>
<funcsynopsisinfo>#include &lt;security/pam_ext.h&gt;</funcsynopsisinfo>
<funcprototype>
@ -36,7 +33,7 @@
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id='pam_info-description'>
<refsect1 xml:id="pam_info-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_info</function> function prints messages
@ -51,7 +48,7 @@
</citerefentry> variable argument list macros.
</para>
</refsect1>
<refsect1 id="pam_info-return_values">
<refsect1 xml:id="pam_info-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -89,7 +86,7 @@
</variablelist>
</refsect1>
<refsect1 id='pam_info-see_also'>
<refsect1 xml:id="pam_info-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -98,7 +95,7 @@
</para>
</refsect1>
<refsect1 id='pam_info-standards'>
<refsect1 xml:id="pam_info-standards">
<title>STANDARDS</title>
<para>
The <function>pam_info</function> and <function>pam_vinfo</function>
@ -106,4 +103,4 @@
</para>
</refsect1>
</refentry>
</refentry>

5
doc/man/pam_item_types_ext.inc.xml
View File

@ -1,6 +1,5 @@
<!-- this file is included by pam_set_item and pam_get_item -->
<variablelist>
<variablelist xmlns="http://docbook.org/ns/docbook" version="5.0">
<varlistentry>
<term>PAM_FAIL_DELAY</term>
<listitem>
@ -58,4 +57,4 @@
</listitem>
</varlistentry>
</variablelist>
</variablelist>

5
doc/man/pam_item_types_std.inc.xml
View File

@ -1,6 +1,5 @@
<!-- this file is included by pam_set_item and pam_get_item -->
<variablelist>
<variablelist xmlns="http://docbook.org/ns/docbook" version="5.0">
<varlistentry>
<term>PAM_SERVICE</term>
<listitem>
@ -135,4 +134,4 @@
</listitem>
</varlistentry>
</variablelist>
</variablelist>

21
doc/man/pam_misc_drop_env.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="pam_misc_drop_env">
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_misc_drop_env">
<refmeta>
<refentrytitle>pam_misc_drop_env</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_misc_drop_env-name">
<refnamediv xml:id="pam_misc_drop_env-name">
<refname>pam_misc_drop_env</refname>
<refpurpose>liberating a locally saved environment</refpurpose>
</refnamediv>
@ -18,7 +15,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id="pam_misc_drop_env-synopsis">
<funcsynopsis xml:id="pam_misc_drop_env-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_misc.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_misc_drop_env</function></funcdef>
@ -27,7 +24,7 @@
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id='pam_misc_drop_env-description'>
<refsect1 xml:id="pam_misc_drop_env-description">
<title>DESCRIPTION</title>
<para>
This function is defined to complement the <citerefentry>
@ -39,7 +36,7 @@
</para>
</refsect1>
<refsect1 id='pam_misc_drop_env-see_also'>
<refsect1 xml:id="pam_misc_drop_env-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -51,7 +48,7 @@
</para>
</refsect1>
<refsect1 id='pam_misc_drop_env-standards'>
<refsect1 xml:id="pam_misc_drop_env-standards">
<title>STANDARDS</title>
<para>
The <function>pam_misc_drop_env</function> function is part of the
@ -60,4 +57,4 @@
</para>
</refsect1>
</refentry>
</refentry>

21
doc/man/pam_misc_paste_env.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="pam_misc_paste_env">
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_misc_paste_env">
<refmeta>
<refentrytitle>pam_misc_paste_env</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_misc_paste_env-name">
<refnamediv xml:id="pam_misc_paste_env-name">
<refname>pam_misc_paste_env</refname>
<refpurpose>transcribing an environment to that of PAM</refpurpose>
</refnamediv>
@ -18,7 +15,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id="pam_misc_paste_env-synopsis">
<funcsynopsis xml:id="pam_misc_paste_env-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_misc.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_misc_paste_env</function></funcdef>
@ -28,7 +25,7 @@
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id='pam_misc_paste_env-description'>
<refsect1 xml:id="pam_misc_paste_env-description">
<title>DESCRIPTION</title>
<para>
This function takes the supplied list of environment pointers and
@ -37,7 +34,7 @@
</para>
</refsect1>
<refsect1 id='pam_misc_paste_env-see_also'>
<refsect1 xml:id="pam_misc_paste_env-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -49,7 +46,7 @@
</para>
</refsect1>
<refsect1 id='pam_misc_paste_env-standards'>
<refsect1 xml:id="pam_misc_paste_env-standards">
<title>STANDARDS</title>
<para>
The <function>pam_misc_paste_env</function> function is part of the
@ -58,4 +55,4 @@
</para>
</refsect1>
</refentry>
</refentry>

21
doc/man/pam_misc_setenv.3.xml
View File

@ -1,15 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="pam_misc_setenv">
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_misc_setenv">
<refmeta>
<refentrytitle>pam_misc_setenv</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_misc_setenv-name">
<refnamediv xml:id="pam_misc_setenv-name">
<refname>pam_misc_setenv</refname>
<refpurpose>BSD like PAM environment variable setting</refpurpose>
</refnamediv>
@ -17,7 +14,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id="pam_misc_setenv-synopsis">
<funcsynopsis xml:id="pam_misc_setenv-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_misc.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_misc_setenv</function></funcdef>
@ -29,7 +26,7 @@
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id='pam_misc_setenv-description'>
<refsect1 xml:id="pam_misc_setenv-description">
<title>DESCRIPTION</title>
<para>
This function performs a task equivalent to <citerefentry>
@ -44,7 +41,7 @@
</para>
</refsect1>
<refsect1 id='pam_misc_setenv-see_also'>
<refsect1 xml:id="pam_misc_setenv-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -56,7 +53,7 @@
</para>
</refsect1>
<refsect1 id='pam_misc_setenv-standards'>
<refsect1 xml:id="pam_misc_setenv-standards">
<title>STANDARDS</title>
<para>
The <function>pam_misc_setenv</function> function is part of the
@ -65,4 +62,4 @@
</para>
</refsect1>
</refentry>
</refentry>

21
doc/man/pam_open_session.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_send'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_send">
<refmeta>
<refentrytitle>pam_open_session</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_open_session-name">
<refnamediv xml:id="pam_open_session-name">
<refname>pam_open_session</refname>
<refpurpose>start PAM session management</refpurpose>
</refnamediv>
@ -18,7 +15,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id="pam_open_session-synopsis">
<funcsynopsis xml:id="pam_open_session-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_open_session</function></funcdef>
@ -29,7 +26,7 @@
</refsynopsisdiv>
<refsect1 id="pam_open_session-description">
<refsect1 xml:id="pam_open_session-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_open_session</function> function sets up a
@ -63,7 +60,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_open_session-return_values">
<refsect1 xml:id="pam_open_session-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -101,7 +98,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_open_session-see_also">
<refsect1 xml:id="pam_open_session-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -112,4 +109,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

23
doc/man/pam_prompt.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="pam_prompt">
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_prompt">
<refmeta>
<refentrytitle>pam_prompt</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_prompt-name">
<refnamediv xml:id="pam_prompt-name">
<refname>pam_prompt</refname>
<refname>pam_vprompt</refname>
<refpurpose>interface to conversation function</refpurpose>
@ -18,7 +15,7 @@
<!-- body begins here -->
<refsynopsisdiv id="pam_prompt-synopsis">
<refsynopsisdiv xml:id="pam_prompt-synopsis">
<funcsynopsis>
<funcsynopsisinfo>#include &lt;security/pam_ext.h&gt;</funcsynopsisinfo>
<funcprototype>
@ -40,7 +37,7 @@
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id='pam_prompt-description'>
<refsect1 xml:id="pam_prompt-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_prompt</function> function constructs a message
@ -52,7 +49,7 @@
</para>
</refsect1>
<refsect1 id="pam_prompt-return_values">
<refsect1 xml:id="pam_prompt-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -91,7 +88,7 @@
</refsect1>
<refsect1 id='pam_prompt-see_also'>
<refsect1 xml:id="pam_prompt-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -103,7 +100,7 @@
</para>
</refsect1>
<refsect1 id='pam_prompt-standards'>
<refsect1 xml:id="pam_prompt-standards">
<title>STANDARDS</title>
<para>
The <function>pam_prompt</function> and <function>pam_vprompt</function>
@ -111,4 +108,4 @@
</para>
</refsect1>
</refentry>
</refentry>

20
doc/man/pam_putenv.3.xml
View File

@ -1,14 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_putenv'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_putenv">
<refmeta>
<refentrytitle>pam_putenv</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_putenv-name">
<refnamediv xml:id="pam_putenv-name">
<refname>pam_putenv</refname>
<refpurpose>set or change PAM environment variable</refpurpose>
</refnamediv>
@ -16,7 +14,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id='pam_putenv-synopsis'>
<funcsynopsis xml:id="pam_putenv-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_putenv</function></funcdef>
@ -27,7 +25,7 @@
</refsynopsisdiv>
<refsect1 id='pam_putenv-description'>
<refsect1 xml:id="pam_putenv-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_putenv</function> function is used to
@ -83,7 +81,7 @@
</para>
</refsect1>
<refsect1 id="pam_putenv-return_values">
<refsect1 xml:id="pam_putenv-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -129,7 +127,7 @@
</variablelist>
</refsect1>
<refsect1 id='pam_putenv-see_also'>
<refsect1 xml:id="pam_putenv-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -149,4 +147,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

21
doc/man/pam_set_data.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_set_data'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_set_data">
<refmeta>
<refentrytitle>pam_set_data</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id='pam_set_data-name'>
<refnamediv xml:id="pam_set_data-name">
<refname>pam_set_data</refname>
<refpurpose>
set module internal data
@ -22,7 +19,7 @@
<refsynopsisdiv>
<funcsynopsis id="pam_set_data-synopsis">
<funcsynopsis xml:id="pam_set_data-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_modules.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_set_data</function></funcdef>
@ -36,7 +33,7 @@
</refsynopsisdiv>
<refsect1 id="pam_set_data-description">
<refsect1 xml:id="pam_set_data-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_set_data</function> function associates a pointer
@ -123,7 +120,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_set_data-return_values">
<refsect1 xml:id="pam_set_data-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -154,7 +151,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_set_data-see_also">
<refsect1 xml:id="pam_set_data-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -169,4 +166,4 @@
</para>
</refsect1>
</refentry>
</refentry>

33
doc/man/pam_set_item.3.xml
View File

@ -1,22 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"
[
<!--
<!ENTITY accessconf SYSTEM "pam_item_types_std.inc.xml">
<!ENTITY accessconf SYSTEM "pam_item_types_ext.inc.xml">
-->
]>
<refentry id='pam_set_item'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_set_item">
<refmeta>
<refentrytitle>pam_set_item</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id='pam_set_item-name'>
<refnamediv xml:id="pam_set_item-name">
<refname>pam_set_item</refname>
<refpurpose>
set and update PAM information
@ -28,7 +19,7 @@
<refsynopsisdiv>
<funcsynopsis id="pam_set_item-synopsis">
<funcsynopsis xml:id="pam_set_item-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_modules.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_set_item</function></funcdef>
@ -41,7 +32,7 @@
</refsynopsisdiv>
<refsect1 id="pam_set_item-description">
<refsect1 xml:id="pam_set_item-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_set_item</function> function allows applications
@ -52,16 +43,14 @@
supported:
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_item_types_std.inc.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_item_types_std.inc.xml"/>
<para>
The following additional items are specific to Linux-PAM and should not be used in
portable applications:
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_item_types_ext.inc.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_item_types_ext.inc.xml"/>
<para>
For all <emphasis>item_type</emphasis>s, other than PAM_CONV and
@ -81,7 +70,7 @@
</refsect1>
<refsect1 id="pam_set_item-return_values">
<refsect1 xml:id="pam_set_item-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -121,7 +110,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_set_item-see_also">
<refsect1 xml:id="pam_set_item-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -133,4 +122,4 @@
</para>
</refsect1>
</refentry>
</refentry>

21
doc/man/pam_setcred.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="pam_setcred">
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_setcred">
<refmeta>
<refentrytitle>pam_setcred</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_setcred-name">
<refnamediv xml:id="pam_setcred-name">
<refname>pam_setcred</refname>
<refpurpose>
establish / delete user credentials
@ -19,7 +16,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id='pam_setcred-synopsis'>
<funcsynopsis xml:id="pam_setcred-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_setcred</function></funcdef>
@ -30,7 +27,7 @@
</refsynopsisdiv>
<refsect1 id='pam_setcred-description'>
<refsect1 xml:id="pam_setcred-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_setcred</function> function is used to establish,
@ -95,7 +92,7 @@
</variablelist>
</refsect1>
<refsect1 id='pam_setcred-return_values'>
<refsect1 xml:id="pam_setcred-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -160,7 +157,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_set_data-see_also">
<refsect1 xml:id="pam_set_data-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -177,4 +174,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

22
doc/man/pam_sm_acct_mgmt.3.xml
View File

@ -1,14 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_sm_acct_mgmt'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_sm_acct_mgmt">
<refmeta>
<refentrytitle>pam_sm_acct_mgmt</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_sm_acct_mgmt-name">
<refnamediv xml:id="pam_sm_acct_mgmt-name">
<refname>pam_sm_acct_mgmt</refname>
<refpurpose>PAM service function for account management</refpurpose>
</refnamediv>
@ -16,7 +14,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id='pam_sm_acct_mgmt-synopsis'>
<funcsynopsis xml:id="pam_sm_acct_mgmt-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_modules.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_sm_acct_mgmt</function></funcdef>
@ -29,7 +27,7 @@
</refsynopsisdiv>
<refsect1 id='pam_sm_acct_mgmt-description'>
<refsect1 xml:id="pam_sm_acct_mgmt-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_sm_acct_mgmt</function> function is the service
@ -64,7 +62,7 @@
<term>PAM_DISALLOW_NULL_AUTHTOK</term>
<listitem>
<para>
Return <emphasis remap='B'>PAM_AUTH_ERR</emphasis> if the
Return <emphasis remap="B">PAM_AUTH_ERR</emphasis> if the
database of authentication tokens for this authentication
mechanism has a <emphasis>NULL</emphasis> entry for the user.
</para>
@ -73,7 +71,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_sm_acct_mgmt-return_values">
<refsect1 xml:id="pam_sm_acct_mgmt-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -131,7 +129,7 @@
</variablelist>
</refsect1>
<refsect1 id='pam_sm_acct_mgmt-see_also'>
<refsect1 xml:id="pam_sm_acct_mgmt-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -151,4 +149,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

22
doc/man/pam_sm_authenticate.3.xml
View File

@ -1,14 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_sm_authenticate'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_sm_authenticate">
<refmeta>
<refentrytitle>pam_sm_authenticate</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_sm_authenticate-name">
<refnamediv xml:id="pam_sm_authenticate-name">
<refname>pam_sm_authenticate</refname>
<refpurpose>PAM service function for user authentication</refpurpose>
</refnamediv>
@ -16,7 +14,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id='pam_sm_authenticate-synopsis'>
<funcsynopsis xml:id="pam_sm_authenticate-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_modules.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_sm_authenticate</function></funcdef>
@ -29,7 +27,7 @@
</refsynopsisdiv>
<refsect1 id='pam_sm_authenticate-description'>
<refsect1 xml:id="pam_sm_authenticate-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_sm_authenticate</function> function is the service
@ -58,7 +56,7 @@
<term>PAM_DISALLOW_NULL_AUTHTOK</term>
<listitem>
<para>
Return <emphasis remap='B'>PAM_AUTH_ERR</emphasis> if the
Return <emphasis remap="B">PAM_AUTH_ERR</emphasis> if the
database of authentication tokens for this authentication
mechanism has a <emphasis>NULL</emphasis> entry for the user.
Without this flag, such a <emphasis>NULL</emphasis> token
@ -69,7 +67,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_sm_authenticate-return_values">
<refsect1 xml:id="pam_sm_authenticate-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -128,7 +126,7 @@
</variablelist>
</refsect1>
<refsect1 id='pam_sm_authenticate-see_also'>
<refsect1 xml:id="pam_sm_authenticate-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -148,4 +146,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

30
doc/man/pam_sm_chauthtok.3.xml
View File

@ -1,14 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_sm_chauthtok'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_sm_chauthtok">
<refmeta>
<refentrytitle>pam_sm_chauthtok</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_sm_chauthtok-name">
<refnamediv xml:id="pam_sm_chauthtok-name">
<refname>pam_sm_chauthtok</refname>
<refpurpose>PAM service function for authentication token management</refpurpose>
</refnamediv>
@ -16,7 +14,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id='pam_sm_chauthtok-synopsis'>
<funcsynopsis xml:id="pam_sm_chauthtok-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_modules.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_sm_chauthtok</function></funcdef>
@ -29,7 +27,7 @@
</refsynopsisdiv>
<refsect1 id='pam_sm_chauthtok-description'>
<refsect1 xml:id="pam_sm_chauthtok-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_sm_chauthtok</function> function is the service
@ -77,7 +75,7 @@
some network it should attempt to verify it can connect to
this system on receiving this flag. If a module cannot establish
it is ready to update the user's authentication token it should
return <emphasis remap='B'>PAM_TRY_AGAIN</emphasis>, this
return <emphasis remap="B">PAM_TRY_AGAIN</emphasis>, this
information will be passed back to the application.
</para>
<para>
@ -93,7 +91,7 @@
<para>
This informs the module that this is the call it should change
the authorization tokens. If the flag is logically OR'd with
<emphasis remap='B'>PAM_CHANGE_EXPIRED_AUTHTOK</emphasis>, the
<emphasis remap="B">PAM_CHANGE_EXPIRED_AUTHTOK</emphasis>, the
token is only changed if it has actually expired.
</para>
</listitem>
@ -101,15 +99,15 @@
</variablelist>
<para>
The PAM library calls this function twice in succession. The first
time with <emphasis remap='B'>PAM_PRELIM_CHECK</emphasis> and then,
time with <emphasis remap="B">PAM_PRELIM_CHECK</emphasis> and then,
if the module does not return
<emphasis remap='B'>PAM_TRY_AGAIN</emphasis>, subsequently with
<emphasis remap='B'>PAM_UPDATE_AUTHTOK</emphasis>. It is only on
<emphasis remap="B">PAM_TRY_AGAIN</emphasis>, subsequently with
<emphasis remap="B">PAM_UPDATE_AUTHTOK</emphasis>. It is only on
the second call that the authorization token is (possibly) changed.
</para>
</refsect1>
<refsect1 id="pam_sm_chauthtok-return_values">
<refsect1 xml:id="pam_sm_chauthtok-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -181,7 +179,7 @@
</variablelist>
</refsect1>
<refsect1 id='pam_sm_chauthtok-see_also'>
<refsect1 xml:id="pam_sm_chauthtok-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -201,4 +199,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

22
doc/man/pam_sm_close_session.3.xml
View File

@ -1,14 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-close.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_sm_close_session'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_sm_close_session">
<refmeta>
<refentrytitle>pam_sm_close_session</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_sm_close_session-name">
<refnamediv xml:id="pam_sm_close_session-name">
<refname>pam_sm_close_session</refname>
<refpurpose>PAM service function to terminate session management</refpurpose>
</refnamediv>
@ -16,7 +14,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id='pam_sm_close_session-synopsis'>
<funcsynopsis xml:id="pam_sm_close_session-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_modules.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_sm_close_session</function></funcdef>
@ -29,7 +27,7 @@
</refsynopsisdiv>
<refsect1 id='pam_sm_close_session-description'>
<refsect1 xml:id="pam_sm_close_session-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_sm_close_session</function> function is the service
@ -40,7 +38,7 @@
</para>
<para>
This function is called to terminate a session. The only valid
value for <varname role='parameter'>flags</varname> is zero or:
value for <varname role="parameter">flags</varname> is zero or:
</para>
<variablelist>
<varlistentry>
@ -54,7 +52,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_sm_close_session-return_values">
<refsect1 xml:id="pam_sm_close_session-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -76,7 +74,7 @@
</variablelist>
</refsect1>
<refsect1 id='pam_sm_close_session-see_also'>
<refsect1 xml:id="pam_sm_close_session-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -96,4 +94,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

22
doc/man/pam_sm_open_session.3.xml
View File

@ -1,14 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_sm_open_session'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_sm_open_session">
<refmeta>
<refentrytitle>pam_sm_open_session</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_sm_open_session-name">
<refnamediv xml:id="pam_sm_open_session-name">
<refname>pam_sm_open_session</refname>
<refpurpose>PAM service function to start session management</refpurpose>
</refnamediv>
@ -16,7 +14,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id='pam_sm_open_session-synopsis'>
<funcsynopsis xml:id="pam_sm_open_session-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_modules.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_sm_open_session</function></funcdef>
@ -29,7 +27,7 @@
</refsynopsisdiv>
<refsect1 id='pam_sm_open_session-description'>
<refsect1 xml:id="pam_sm_open_session-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_sm_open_session</function> function is the service
@ -40,7 +38,7 @@
</para>
<para>
This function is called to commence a session. The only valid
value for <varname role='parameter'>flags</varname> is zero or:
value for <varname role="parameter">flags</varname> is zero or:
</para>
<variablelist>
<varlistentry>
@ -54,7 +52,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_sm_open_session-return_values">
<refsect1 xml:id="pam_sm_open_session-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -76,7 +74,7 @@
</variablelist>
</refsect1>
<refsect1 id='pam_sm_open_session-see_also'>
<refsect1 xml:id="pam_sm_open_session-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -96,4 +94,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

24
doc/man/pam_sm_setcred.3.xml
View File

@ -1,14 +1,12 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_sm_setcred'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_sm_setcred">
<refmeta>
<refentrytitle>pam_sm_setcred</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_sm_setcred-name">
<refnamediv xml:id="pam_sm_setcred-name">
<refname>pam_sm_setcred</refname>
<refpurpose>PAM service function to alter credentials</refpurpose>
</refnamediv>
@ -16,7 +14,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id='pam_sm_setcred-synopsis'>
<funcsynopsis xml:id="pam_sm_setcred-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_modules.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_sm_setcred</function></funcdef>
@ -29,7 +27,7 @@
</refsynopsisdiv>
<refsect1 id='pam_sm_setcred-description'>
<refsect1 xml:id="pam_sm_setcred-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_sm_setcred</function> function is the service
@ -92,7 +90,7 @@
</varlistentry>
</variablelist>
<para>
The way the <emphasis remap='B'>auth</emphasis> stack is
The way the <emphasis remap="B">auth</emphasis> stack is
navigated in order to evaluate the <function>pam_setcred</function>()
function call, independent of the <function>pam_sm_setcred</function>()
return codes, is exactly the same way that it was navigated when
@ -102,11 +100,11 @@
libpam evaluates the <function>pam_setcred</function>() function
call. Otherwise, the return codes from each module specific
<function>pam_sm_setcred</function>() call are treated as
<emphasis remap='B'>required</emphasis>.
<emphasis remap="B">required</emphasis>.
</para>
</refsect1>
<refsect1 id="pam_sm_setcred-return_values">
<refsect1 xml:id="pam_sm_setcred-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -158,7 +156,7 @@
</para>
</refsect1>
<refsect1 id='pam_sm_setcred-see_also'>
<refsect1 xml:id="pam_sm_setcred-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -181,4 +179,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

21
doc/man/pam_start.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_start'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_start">
<refmeta>
<refentrytitle>pam_start</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_start-name">
<refnamediv xml:id="pam_start-name">
<refname>pam_start</refname>
<refname>pam_start_confdir</refname>
<refpurpose>initialization of PAM transaction</refpurpose>
@ -19,7 +16,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id="pam_start-synopsis">
<funcsynopsis xml:id="pam_start-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>int <function>pam_start</function></funcdef>
@ -40,7 +37,7 @@
</refsynopsisdiv>
<refsect1 id="pam_start-description">
<refsect1 xml:id="pam_start-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_start</function> function creates the PAM context
@ -108,7 +105,7 @@
</para>
</refsect1>
<refsect1 id="pam_start-return_values">
<refsect1 xml:id="pam_start-return_values">
<title>RETURN VALUES</title>
<variablelist>
<varlistentry>
@ -147,7 +144,7 @@
</variablelist>
</refsect1>
<refsect1 id="pam_start-see_also">
<refsect1 xml:id="pam_start-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -164,4 +161,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

21
doc/man/pam_strerror.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id='pam_strerror'>
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_strerror">
<refmeta>
<refentrytitle>pam_strerror</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_strerror-name">
<refnamediv xml:id="pam_strerror-name">
<refname>pam_strerror</refname>
<refpurpose>return string describing PAM error code</refpurpose>
</refnamediv>
@ -18,7 +15,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id="pam_strerror-synopsis">
<funcsynopsis xml:id="pam_strerror-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
<funcprototype>
<funcdef>const char *<function>pam_strerror</function></funcdef>
@ -29,7 +26,7 @@
</refsynopsisdiv>
<refsect1 id="pam_strerror-description">
<refsect1 xml:id="pam_strerror-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_strerror</function> function returns a pointer to
@ -40,14 +37,14 @@
modify this string.
</para>
</refsect1>
<refsect1 id="pam_strerror-return_values">
<refsect1 xml:id="pam_strerror-return_values">
<title>RETURN VALUES</title>
<para>
This function returns always a pointer to a string.
</para>
</refsect1>
<refsect1 id="pam_strerror-see_also">
<refsect1 xml:id="pam_strerror-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -55,4 +52,4 @@
</citerefentry>
</para>
</refsect1>
</refentry>
</refentry>

21
doc/man/pam_syslog.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="pam_syslog">
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_syslog">
<refmeta>
<refentrytitle>pam_syslog</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_syslog-name">
<refnamediv xml:id="pam_syslog-name">
<refname>pam_syslog</refname>
<refname>pam_vsyslog</refname>
<refpurpose>send messages to the system logger</refpurpose>
@ -18,7 +15,7 @@
<!-- body begins here -->
<refsynopsisdiv id="pam_syslog-synopsis">
<refsynopsisdiv xml:id="pam_syslog-synopsis">
<funcsynopsis>
<funcsynopsisinfo>#include &lt;syslog.h&gt;</funcsynopsisinfo>
<funcsynopsisinfo>#include &lt;security/pam_ext.h&gt;</funcsynopsisinfo>
@ -39,7 +36,7 @@
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id='pam_syslog-description'>
<refsect1 xml:id="pam_syslog-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_syslog</function> function logs messages using
@ -62,7 +59,7 @@
</para>
</refsect1>
<refsect1 id='pam_syslog-see_also'>
<refsect1 xml:id="pam_syslog-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -71,7 +68,7 @@
</para>
</refsect1>
<refsect1 id='pam_syslog-standards'>
<refsect1 xml:id="pam_syslog-standards">
<title>STANDARDS</title>
<para>
The <function>pam_syslog</function> and <function>pam_vsyslog</function>
@ -79,4 +76,4 @@
</para>
</refsect1>
</refentry>
</refentry>

21
doc/man/pam_xauth_data.3.xml
View File

@ -1,16 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<refentry id="pam_xauth_data">
<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="pam_xauth_data">
<refmeta>
<refentrytitle>pam_xauth_data</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo class='setdesc'>Linux-PAM Manual</refmiscinfo>
<refmiscinfo class="source">Linux-PAM</refmiscinfo>
<refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
</refmeta>
<refnamediv id="pam_xauth_data-name">
<refnamediv xml:id="pam_xauth_data-name">
<refname>pam_xauth_data</refname>
<refpurpose>structure containing X authentication data</refpurpose>
</refnamediv>
@ -18,7 +15,7 @@
<!-- body begins here -->
<refsynopsisdiv>
<funcsynopsis id="pam_xauth_data-synopsis">
<funcsynopsis xml:id="pam_xauth_data-synopsis">
<funcsynopsisinfo>#include &lt;security/pam_appl.h&gt;</funcsynopsisinfo>
</funcsynopsis>
<programlisting>
@ -31,7 +28,7 @@ struct pam_xauth_data {
</programlisting>
</refsynopsisdiv>
<refsect1 id='pam_xauth_data-description'>
<refsect1 xml:id="pam_xauth_data-description">
<title>DESCRIPTION</title>
<para>
The <function>pam_xauth_data</function> structure contains X
@ -70,7 +67,7 @@ struct pam_xauth_data {
</para>
</refsect1>
<refsect1 id='pam_xauth_data-see_also'>
<refsect1 xml:id="pam_xauth_data-see_also">
<title>SEE ALSO</title>
<para>
<citerefentry>
@ -82,7 +79,7 @@ struct pam_xauth_data {
</para>
</refsect1>
<refsect1 id='pam_xauth_data-standards'>
<refsect1 xml:id="pam_xauth_data-standards">
<title>STANDARDS</title>
<para>
The <function>pam_xauth_data</function> structure and
@ -91,4 +88,4 @@ struct pam_xauth_data {
</para>
</refsect1>
</refentry>
</refentry>

178
doc/mwg/Linux-PAM_MWG.xml
View File

@ -1,49 +1,38 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<book id="mwg">
<bookinfo>
<book xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="mwg">
<info>
<title>The Linux-PAM Module Writers' Guide</title>
<authorgroup>
<author>
<firstname>Andrew G.</firstname>
<surname>Morgan</surname>
<email>morgan@kernel.org</email>
</author>
<author>
<firstname>Thorsten</firstname>
<surname>Kukuk</surname>
<email>kukuk@thkukuk.de</email>
</author>
<author><personname><firstname>Andrew G.</firstname><surname>Morgan</surname></personname><email>morgan@kernel.org</email></author>
<author><personname><firstname>Thorsten</firstname><surname>Kukuk</surname></personname><email>kukuk@thkukuk.de</email></author>
</authorgroup>
<releaseinfo>Version 1.1.2, 31. August 2010</releaseinfo>
<abstract>
<para>
This manual documents what a programmer needs to know in order
to write a module that conforms to the
<emphasis remap='B'>Linux-PAM</emphasis> standard.It also
<emphasis remap="B">Linux-PAM</emphasis> standard.It also
discusses some security issues from the point of view of the
module programmer.
</para>
</abstract>
</bookinfo>
</info>
<chapter id="mwg-introduction">
<chapter xml:id="mwg-introduction">
<title>Introduction</title>
<section id="mwg-introduction-description">
<section xml:id="mwg-introduction-description">
<title>Description</title>
<para>
<emphasis remap='B'>Linux-PAM</emphasis> (Pluggable Authentication
<emphasis remap="B">Linux-PAM</emphasis> (Pluggable Authentication
Modules for Linux) is a library that enables the local system
administrator to choose how individual applications authenticate
users. For an overview of the
<emphasis remap='B'>Linux-PAM</emphasis> library see the
<emphasis remap="B">Linux-PAM</emphasis> library see the
<emphasis>Linux-PAM System Administrators' Guide</emphasis>.
</para>
<para>
A <emphasis remap='B'>Linux-PAM</emphasis> module is a single
A <emphasis remap="B">Linux-PAM</emphasis> module is a single
executable binary file that can be loaded by the
<emphasis remap='B'>Linux-PAM</emphasis> interface library.
<emphasis remap="B">Linux-PAM</emphasis> interface library.
This PAM library is configured locally with a system file,
<filename>/etc/pam.conf</filename>, to authenticate a user
request via the locally available authentication modules. The
@ -54,14 +43,14 @@
<citerefentry>
<refentrytitle>dlopen</refentrytitle><manvolnum>3</manvolnum>
</citerefentry>. Alternatively, the modules can be statically
linked into the <emphasis remap='B'>Linux-PAM</emphasis> library;
this is mostly to allow <emphasis remap='B'>Linux-PAM</emphasis> to
linked into the <emphasis remap="B">Linux-PAM</emphasis> library;
this is mostly to allow <emphasis remap="B">Linux-PAM</emphasis> to
be used on platforms without dynamic linking available, but this is
a <emphasis>deprecated</emphasis> functionality. It is the
<emphasis remap='B'>Linux-PAM</emphasis> interface that is called
<emphasis remap="B">Linux-PAM</emphasis> interface that is called
by an application and it is the responsibility of the library to
locate, load and call the appropriate functions in a
<emphasis remap='B'>Linux-PAM</emphasis>-module.
<emphasis remap="B">Linux-PAM</emphasis>-module.
</para>
<para>
Except for the immediate purpose of interacting with the user
@ -71,7 +60,7 @@
</para>
</section>
<section id="mwg-introduction-synopsis">
<section xml:id="mwg-introduction-synopsis">
<title>Synopsis</title>
<programlisting>
#include &lt;security/pam_modules.h&gt;
@ -82,63 +71,52 @@ gcc -shared -o pam_module.so pam_module.o -lpam
</section>
</chapter>
<chapter id="mwg-expected-by-module">
<chapter xml:id="mwg-expected-by-module">
<title>What can be expected by the module</title>
<para>
Here we list the interface that the conventions that all
<emphasis remap='B'>Linux-PAM</emphasis> modules must adhere to.
<emphasis remap="B">Linux-PAM</emphasis> modules must adhere to.
</para>
<section id="mwg-expected-by-module-item">
<section xml:id="mwg-expected-by-module-item">
<title>
Getting and setting <emphasis>PAM_ITEM</emphasis>s and
<emphasis>data</emphasis>
</title>
<para>
First, we cover what the module should expect from the
<emphasis remap='B'>Linux-PAM</emphasis> library and a
<emphasis remap='B'>Linux-PAM</emphasis> aware application.
<emphasis remap="B">Linux-PAM</emphasis> library and a
<emphasis remap="B">Linux-PAM</emphasis> aware application.
Essentially this is the <filename>libpam.*</filename> library.
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_set_data.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_get_data.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_set_item.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_get_item.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_get_user.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_conv.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_putenv.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_getenv.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_getenvlist.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_set_data.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_get_data.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_set_item.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_get_item.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_get_user.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_conv.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_putenv.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_getenv.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_getenvlist.xml"/>
</section>
<section id="mwg-expected-by-module-other">
<section xml:id="mwg-expected-by-module-other">
<title>
Other functions provided by <filename>libpam</filename>
</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_strerror.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_fail_delay.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_strerror.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_fail_delay.xml"/>
</section>
</chapter>
<chapter id="mwg-expected-of-module">
<chapter xml:id="mwg-expected-of-module">
<title>What is expected of a module</title>
<para>
The module must supply a sub-set of the six functions listed
below. Together they define the function of a
<emphasis remap='B'>Linux-PAM module</emphasis>. Module developers
<emphasis remap="B">Linux-PAM module</emphasis>. Module developers
are strongly urged to read the comments on security that follow
this list.
</para>
<section id="mwg-expected-of-module-overview">
<section xml:id="mwg-expected-of-module-overview">
<title>Overview</title>
<para>
The six module functions are grouped into four independent
@ -149,7 +127,7 @@ gcc -shared -o pam_module.so pam_module.o -lpam
at least one of these groups. A single module may contain the
necessary functions for <emphasis>all</emphasis> four groups.
</para>
<section id="mwg-expected-of-module-overview-1">
<section xml:id="mwg-expected-of-module-overview-1">
<title>Functional independence</title>
<para>
The independence of the four groups of service a module can
@ -163,7 +141,7 @@ gcc -shared -o pam_module.so pam_module.o -lpam
As an informative example, consider the possibility that an
application applies to change a user's authentication token,
without having first requested that
<emphasis remap='B'>Linux-PAM</emphasis> authenticate the
<emphasis remap="B">Linux-PAM</emphasis> authenticate the
user. In some cases this may be deemed appropriate: when
<command>root</command> wants to change the authentication
token of some lesser user. In other cases it may not be
@ -176,7 +154,7 @@ gcc -shared -o pam_module.so pam_module.o -lpam
this when implementing a given module.
</para>
</section>
<section id="mwg-expected-of-module-overview-2">
<section xml:id="mwg-expected-of-module-overview-2">
<title>Minimizing administration problems</title>
<para>
To avoid system administration problems and the poor
@ -189,7 +167,7 @@ gcc -shared -o pam_module.so pam_module.o -lpam
simply return <errorname>PAM_IGNORE</errorname>.
</para>
</section>
<section id="mwg-expected-of-module-overview-3">
<section xml:id="mwg-expected-of-module-overview-3">
<title>Arguments supplied to the module</title>
<para>
The <parameter>flags</parameter> argument of each of
@ -203,7 +181,7 @@ gcc -shared -o pam_module.so pam_module.o -lpam
arguments are taken from the line appropriate to this
module---that is, with the <emphasis>service_name</emphasis>
matching that of the application---in the configuration file
(see the <emphasis remap='B'>Linux-PAM</emphasis>
(see the <emphasis remap="B">Linux-PAM</emphasis>
System Administrators' Guide). Together these two parameters
provide the number of arguments and an array of pointers to
the individual argument tokens. This will be familiar to C
@ -214,33 +192,27 @@ gcc -shared -o pam_module.so pam_module.o -lpam
</para>
</section>
</section>
<section id="mwg-expected-of-module-auth">
<section xml:id="mwg-expected-of-module-auth">
<title>Authentication management</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_sm_authenticate.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_sm_setcred.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_sm_authenticate.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_sm_setcred.xml"/>
</section>
<section id="mwg-expected-of-module-acct">
<section xml:id="mwg-expected-of-module-acct">
<title>Account management</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_sm_acct_mgmt.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_sm_acct_mgmt.xml"/>
</section>
<section id="mwg-expected-of-module-session">
<section xml:id="mwg-expected-of-module-session">
<title>Session management</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_sm_open_session.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_sm_close_session.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_sm_open_session.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_sm_close_session.xml"/>
</section>
<section id="mwg-expected-of-module-chauthtok">
<section xml:id="mwg-expected-of-module-chauthtok">
<title>Authentication token management</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_sm_chauthtok.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_sm_chauthtok.xml"/>
</section>
</chapter>
<chapter id="mwg-see-options">
<chapter xml:id="mwg-see-options">
<title>Generic optional arguments</title>
<para>
Here we list the generic arguments that all modules can expect to
@ -276,17 +248,17 @@ gcc -shared -o pam_module.so pam_module.o -lpam
</variablelist>
</chapter>
<chapter id="mwg-see-programming">
<chapter xml:id="mwg-see-programming">
<title>Programming notes</title>
<para>
Here we collect some pointers for the module writer to bear in mind
when writing/developing a <emphasis remap='B'>Linux-PAM</emphasis>
when writing/developing a <emphasis remap="B">Linux-PAM</emphasis>
compatible module.
</para>
<section id="mwg-see-programming-sec">
<section xml:id="mwg-see-programming-sec">
<title>Security issues for module creation</title>
<section id="mwg-see-programming-sec-res">
<section xml:id="mwg-see-programming-sec-res">
<title>Sufficient resources</title>
<para>
Care should be taken to ensure that the proper execution
@ -299,7 +271,7 @@ gcc -shared -o pam_module.so pam_module.o -lpam
consideration.
</para>
</section>
<section id="mwg-see-programming-sec-who">
<section xml:id="mwg-see-programming-sec-who">
<title>Who´s who?</title>
<para>
Generally, the module may wish to establish the identity of
@ -349,13 +321,13 @@ gcc -shared -o pam_module.so pam_module.o -lpam
Z, the user under whose identity the service will be granted.
This is the username returned by
<function>pam_get_user()</function> and also stored in the
<emphasis remap='B'>Linux-PAM</emphasis> item,
<emphasis remap="B">Linux-PAM</emphasis> item,
<emphasis>PAM_USER</emphasis>.
</para>
</listitem>
<listitem>
<para>
<emphasis remap='B'>Linux-PAM</emphasis> has a place for
<emphasis remap="B">Linux-PAM</emphasis> has a place for
an additional user identity that a module may care to make
use of. This is the <emphasis>PAM_RUSER</emphasis> item.
Generally, network sensitive modules/applications may wish
@ -369,10 +341,10 @@ gcc -shared -o pam_module.so pam_module.o -lpam
<emphasis>uid</emphasis> or <emphasis>euid</emphasis> of the
running process, it should take care to restore the original
values prior to returning control to the
<emphasis remap='B'>Linux-PAM</emphasis> library.
<emphasis remap="B">Linux-PAM</emphasis> library.
</para>
</section>
<section id="mwg-see-programming-sec-conv">
<section xml:id="mwg-see-programming-sec-conv">
<title>Using the conversation function</title>
<para>
Prior to calling the conversation function, the module should
@ -389,7 +361,7 @@ gcc -shared -o pam_module.so pam_module.o -lpam
indicating failure.
</para>
</section>
<section id="mwg-see-programming-sec-token">
<section xml:id="mwg-see-programming-sec-token">
<title>Authentication tokens</title>
<para>
To ensure that the authentication tokens are not left lying
@ -403,7 +375,7 @@ gcc -shared -o pam_module.so pam_module.o -lpam
general rule the module should overwrite authentication tokens
as soon as they are no longer needed. Especially before
<function>free()</function>'ing them. The
<emphasis remap='B'>Linux-PAM</emphasis> library is
<emphasis remap="B">Linux-PAM</emphasis> library is
required to do this when either of these authentication
token items are (re)set.
</para>
@ -437,7 +409,7 @@ int cleanup(pam_handle_t *pamh, void *data, int error_status)
</para>
</section>
</section>
<section id="mwg-see-programming-syslog">
<section xml:id="mwg-see-programming-syslog">
<title>Use of <citerefentry>
<refentrytitle>syslog</refentrytitle><manvolnum>3</manvolnum>
</citerefentry></title>
@ -451,7 +423,7 @@ int cleanup(pam_handle_t *pamh, void *data, int error_status)
<citerefentry>
<refentrytitle>syslog</refentrytitle><manvolnum>3</manvolnum>
</citerefentry> with <emphasis>facility-type</emphasis>
<emphasis remap='B'>LOG_AUTHPRIV</emphasis>.
<emphasis remap="B">LOG_AUTHPRIV</emphasis>.
</para>
<para>
With a few exceptions, the level of logging is, at the discretion
@ -501,7 +473,7 @@ int cleanup(pam_handle_t *pamh, void *data, int error_status)
</listitem>
</itemizedlist>
</section>
<section id="mwg-see-programming-libs">
<section xml:id="mwg-see-programming-libs">
<title>Modules that require system libraries</title>
<para>
Writing a module is much like writing an application. You
@ -526,16 +498,16 @@ int cleanup(pam_handle_t *pamh, void *data, int error_status)
</section>
</chapter>
<chapter id="mwg-example">
<chapter xml:id="mwg-example">
<title>An example module</title>
<para>
At some point, we may include a fully commented example of a module in
this document. For now, please look at the modules directory of the
<emphasis remap='B'>Linux-PAM</emphasis> sources.
<emphasis remap="B">Linux-PAM</emphasis> sources.
</para>
</chapter>
<chapter id="mwg-see-also">
<chapter xml:id="mwg-see-also">
<title>See also</title>
<itemizedlist>
<listitem>
@ -558,7 +530,7 @@ int cleanup(pam_handle_t *pamh, void *data, int error_status)
</itemizedlist>
</chapter>
<chapter id='mwg-author'>
<chapter xml:id="mwg-author">
<title>Author/acknowledgments</title>
<para>
This document was written by Andrew G. Morgan (morgan@kernel.org)
@ -578,14 +550,14 @@ int cleanup(pam_handle_t *pamh, void *data, int error_status)
<para>
Thanks are also due to Sun Microsystems, especially to Vipin Samar and
Charlie Lai for their advice. At an early stage in the development of
<emphasis remap='B'>Linux-PAM</emphasis>, Sun graciously made the
<emphasis remap="B">Linux-PAM</emphasis>, Sun graciously made the
documentation for their implementation of PAM available. This act
greatly accelerated the development of
<emphasis remap='B'>Linux-PAM</emphasis>.
<emphasis remap="B">Linux-PAM</emphasis>.
</para>
</chapter>
<chapter id='mwg-copyright'>
<chapter xml:id="mwg-copyright">
<title>Copyright information for this document</title>
<programlisting>
Copyright (c) 2006 Thorsten Kukuk &lt;kukuk@thkukuk.de&gt;
@ -629,4 +601,4 @@ TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
</programlisting>
</chapter>
</book>
</book>

6
doc/mwg/Makefile.am
View File

@ -16,7 +16,7 @@ all: Linux-PAM_MWG.txt html/Linux-PAM_MWG.html Linux-PAM_MWG.pdf
Linux-PAM_MWG.pdf: $(XMLS) $(DEP_XMLS)
if ENABLE_GENERATE_PDF
$(XMLLINT) --nonet --xinclude --postvalid --noent --noout $<
$(XMLLINT) --nonet --xinclude --relaxng $(DOCBOOK_RNG) --noent --noout $<
$(XSLTPROC) --stringparam generate.toc "book toc" \
--stringparam section.autolabel 1 \
--stringparam section.label.includes.component.label 1 \
@ -28,7 +28,7 @@ else
endif
Linux-PAM_MWG.txt: $(XMLS) $(DEP_XMLS)
$(XMLLINT) --nonet --xinclude --postvalid --noent --noout $<
$(XMLLINT) --nonet --xinclude --relaxng $(DOCBOOK_RNG) --noent --noout $<
$(XSLTPROC) --stringparam generate.toc "book toc" \
--stringparam section.autolabel 1 \
--stringparam section.label.includes.component.label 1 \
@ -37,7 +37,7 @@ Linux-PAM_MWG.txt: $(XMLS) $(DEP_XMLS)
html/Linux-PAM_MWG.html: $(XMLS) $(DEP_XMLS)
@test -d html || mkdir -p html
$(XMLLINT) --nonet --xinclude --postvalid --noent --noout $<
$(XMLLINT) --nonet --xinclude --relaxng $(DOCBOOK_RNG) --noent --noout $<
$(XSLTPROC) --stringparam base.dir html/ \
--stringparam root.filename Linux-PAM_MWG \
--stringparam use.id.as.filename 1 \

20
doc/mwg/pam_conv.xml
View File

@ -1,11 +1,7 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='mwg-pam_conv'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="mwg-pam_conv">
<title>The conversation function</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_conv.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_conv-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_conv.3.xml" xpointer='xpointer(id("pam_conv-synopsis")/*)'/>
</funcsynopsis>
<programlisting>
struct pam_message {
@ -24,12 +20,10 @@ struct pam_conv {
void *appdata_ptr;
};
</programlisting>
<section id='mwg-pam_conv-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_conv.3.xml" xpointer='xpointer(//refsect1[@id = "pam_conv-description"]/*)'/>
<section xml:id="mwg-pam_conv-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_conv.3.xml" xpointer='xpointer(id("pam_conv-description")/*)'/>
</section>
<section id='mwg-pam_conv-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_conv.3.xml" xpointer='xpointer(//refsect1[@id = "pam_conv-return_values"]/*)'/>
<section xml:id="mwg-pam_conv-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_conv.3.xml" xpointer='xpointer(id("pam_conv-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_fail_delay.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_fail_delay'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_fail_delay">
<title>Request a delay on failure</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_fail_delay.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_fail_delay-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_fail_delay.3.xml" xpointer='xpointer(id("pam_fail_delay-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_fail_delay-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_fail_delay.3.xml" xpointer='xpointer(//refsect1[@id = "pam_fail_delay-description"]/*)'/>
<section xml:id="adg-pam_fail_delay-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_fail_delay.3.xml" xpointer='xpointer(id("pam_fail_delay-description")/*)'/>
</section>
<section id='adg-pam_fail_delay-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_fail_delay.3.xml" xpointer='xpointer(//refsect1[@id = "pam_fail_delay-return_values"]/*)'/>
<section xml:id="adg-pam_fail_delay-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_fail_delay.3.xml" xpointer='xpointer(id("pam_fail_delay-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_get_data.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='mwg-pam_get_data'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="mwg-pam_get_data">
<title>Get module internal data</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_get_data.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_get_data-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_get_data.3.xml" xpointer='xpointer(id("pam_get_data-synopsis")/*)'/>
</funcsynopsis>
<section id='mwg-pam_get_data-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_get_data.3.xml" xpointer='xpointer(//refsect1[@id = "pam_get_data-description"]/*)'/>
<section xml:id="mwg-pam_get_data-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_get_data.3.xml" xpointer='xpointer(id("pam_get_data-description")/*)'/>
</section>
<section id='mwg-pam_get_data-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_get_data.3.xml" xpointer='xpointer(//refsect1[@id = "pam_get_data-return_values"]/*)'/>
<section xml:id="mwg-pam_get_data-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_get_data.3.xml" xpointer='xpointer(id("pam_get_data-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_get_item.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='mwg-pam_get_item'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="mwg-pam_get_item">
<title>Getting PAM items</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_get_item.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_get_item-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_get_item.3.xml" xpointer='xpointer(id("pam_get_item-synopsis")/*)'/>
</funcsynopsis>
<section id='mwg-pam_get_item-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_get_item.3.xml" xpointer='xpointer(//refsect1[@id = "pam_get_item-description"]/*)'/>
<section xml:id="mwg-pam_get_item-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_get_item.3.xml" xpointer='xpointer(id("pam_get_item-description")/*)'/>
</section>
<section id='mwg-pam_get_item-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_get_item.3.xml" xpointer='xpointer(//refsect1[@id = "pam_get_item-return_values"]/*)'/>
<section xml:id="mwg-pam_get_item-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_get_item.3.xml" xpointer='xpointer(id("pam_get_item-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_get_user.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='mwg-pam_get_user'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="mwg-pam_get_user">
<title>Get user name</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_get_user.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_get_user-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_get_user.3.xml" xpointer='xpointer(id("pam_get_user-synopsis")/*)'/>
</funcsynopsis>
<section id='mwg-pam_get_user-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_get_user.3.xml" xpointer='xpointer(//refsect1[@id = "pam_get_user-description"]/*)'/>
<section xml:id="mwg-pam_get_user-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_get_user.3.xml" xpointer='xpointer(id("pam_get_user-description")/*)'/>
</section>
<section id='mwg-pam_get_user-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_get_user.3.xml" xpointer='xpointer(//refsect1[@id = "pam_get_user-return_values"]/*)'/>
<section xml:id="mwg-pam_get_user-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_get_user.3.xml" xpointer='xpointer(id("pam_get_user-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_getenv.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_getenv'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_getenv">
<title>Get a PAM environment variable</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_getenv.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_getenv-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_getenv.3.xml" xpointer='xpointer(id("pam_getenv-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_getenv-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_getenv.3.xml" xpointer='xpointer(//refsect1[@id = "pam_getenv-description"]/*)'/>
<section xml:id="adg-pam_getenv-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_getenv.3.xml" xpointer='xpointer(id("pam_getenv-description")/*)'/>
</section>
<section id='adg-pam_getenv-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_getenv.3.xml" xpointer='xpointer(//refsect1[@id = "pam_getenv-return_values"]/*)'/>
<section xml:id="adg-pam_getenv-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_getenv.3.xml" xpointer='xpointer(id("pam_getenv-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_getenvlist.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_getenvlist'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_getenvlist">
<title>Getting the PAM environment</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_getenvlist.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_getenvlist-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_getenvlist.3.xml" xpointer='xpointer(id("pam_getenvlist-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_getenvlist-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_getenvlist.3.xml" xpointer='xpointer(//refsect1[@id = "pam_getenvlist-description"]/*)'/>
<section xml:id="adg-pam_getenvlist-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_getenvlist.3.xml" xpointer='xpointer(id("pam_getenvlist-description")/*)'/>
</section>
<section id='adg-pam_getenvlist-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_getenvlist.3.xml" xpointer='xpointer(//refsect1[@id = "pam_getenvlist-return_values"]/*)'/>
<section xml:id="adg-pam_getenvlist-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_getenvlist.3.xml" xpointer='xpointer(id("pam_getenvlist-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_putenv.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_putenv'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_putenv">
<title>Set or change PAM environment variable</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_putenv.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_putenv-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_putenv.3.xml" xpointer='xpointer(id("pam_putenv-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_putenv-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_putenv.3.xml" xpointer='xpointer(//refsect1[@id = "pam_putenv-description"]/*)'/>
<section xml:id="adg-pam_putenv-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_putenv.3.xml" xpointer='xpointer(id("pam_putenv-description")/*)'/>
</section>
<section id='adg-pam_putenv-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_putenv.3.xml" xpointer='xpointer(//refsect1[@id = "pam_putenv-return_values"]/*)'/>
<section xml:id="adg-pam_putenv-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_putenv.3.xml" xpointer='xpointer(id("pam_putenv-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_set_data.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='mwg-pam_set_data'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="mwg-pam_set_data">
<title>Set module internal data</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_set_data.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_set_data-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_set_data.3.xml" xpointer='xpointer(id("pam_set_data-synopsis")/*)'/>
</funcsynopsis>
<section id='mwg-pam_set_data-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_set_data.3.xml" xpointer='xpointer(//refsect1[@id = "pam_set_data-description"]/*)'/>
<section xml:id="mwg-pam_set_data-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_set_data.3.xml" xpointer='xpointer(id("pam_set_data-description")/*)'/>
</section>
<section id='mwg-pam_set_data-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_set_data.3.xml" xpointer='xpointer(//refsect1[@id = "pam_set_data-return_values"]/*)'/>
<section xml:id="mwg-pam_set_data-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_set_data.3.xml" xpointer='xpointer(id("pam_set_data-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_set_item.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='mwg-pam_set_item'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="mwg-pam_set_item">
<title>Setting PAM items</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_set_item.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_set_item-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_set_item.3.xml" xpointer='xpointer(id("pam_set_item-synopsis")/*)'/>
</funcsynopsis>
<section id='mwg-pam_set_item-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_set_item.3.xml" xpointer='xpointer(//refsect1[@id = "pam_set_item-description"]/*)'/>
<section xml:id="mwg-pam_set_item-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_set_item.3.xml" xpointer='xpointer(id("pam_set_item-description")/*)'/>
</section>
<section id='mwg-pam_set_item-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_set_item.3.xml" xpointer='xpointer(//refsect1[@id = "pam_set_item-return_values"]/*)'/>
<section xml:id="mwg-pam_set_item-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_set_item.3.xml" xpointer='xpointer(id("pam_set_item-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_sm_acct_mgmt.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='mwg-pam_sm_acct_mgmt'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="mwg-pam_sm_acct_mgmt">
<title>Service function for account management</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_acct_mgmt.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_sm_acct_mgmt-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_acct_mgmt.3.xml" xpointer='xpointer(id("pam_sm_acct_mgmt-synopsis")/*)'/>
</funcsynopsis>
<section id='mwg-pam_sm_acct_mgmt-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_acct_mgmt.3.xml" xpointer='xpointer(//refsect1[@id = "pam_sm_acct_mgmt-description"]/*)'/>
<section xml:id="mwg-pam_sm_acct_mgmt-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_acct_mgmt.3.xml" xpointer='xpointer(id("pam_sm_acct_mgmt-description")/*)'/>
</section>
<section id='mwg-pam_sm_acct_mgmt-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_acct_mgmt.3.xml" xpointer='xpointer(//refsect1[@id = "pam_sm_acct_mgmt-return_values"]/*)'/>
<section xml:id="mwg-pam_sm_acct_mgmt-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_acct_mgmt.3.xml" xpointer='xpointer(id("pam_sm_acct_mgmt-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_sm_authenticate.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='mwg-pam_sm_authenticate'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="mwg-pam_sm_authenticate">
<title>Service function for user authentication</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_authenticate.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_sm_authenticate-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_authenticate.3.xml" xpointer='xpointer(id("pam_sm_authenticate-synopsis")/*)'/>
</funcsynopsis>
<section id='mwg-pam_sm_authenticate-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_authenticate.3.xml" xpointer='xpointer(//refsect1[@id = "pam_sm_authenticate-description"]/*)'/>
<section xml:id="mwg-pam_sm_authenticate-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_authenticate.3.xml" xpointer='xpointer(id("pam_sm_authenticate-description")/*)'/>
</section>
<section id='mwg-pam_sm_authenticate-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_authenticate.3.xml" xpointer='xpointer(//refsect1[@id = "pam_sm_authenticate-return_values"]/*)'/>
<section xml:id="mwg-pam_sm_authenticate-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_authenticate.3.xml" xpointer='xpointer(id("pam_sm_authenticate-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_sm_chauthtok.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='mwg-pam_sm_chauthtok'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="mwg-pam_sm_chauthtok">
<title>Service function to alter authentication token</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_chauthtok.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_sm_chauthtok-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_chauthtok.3.xml" xpointer='xpointer(id("pam_sm_chauthtok-synopsis")/*)'/>
</funcsynopsis>
<section id='mwg-pam_sm_chauthtok-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_chauthtok.3.xml" xpointer='xpointer(//refsect1[@id = "pam_sm_chauthtok-description"]/*)'/>
<section xml:id="mwg-pam_sm_chauthtok-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_chauthtok.3.xml" xpointer='xpointer(id("pam_sm_chauthtok-description")/*)'/>
</section>
<section id='mwg-pam_sm_chauthtok-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_chauthtok.3.xml" xpointer='xpointer(//refsect1[@id = "pam_sm_chauthtok-return_values"]/*)'/>
<section xml:id="mwg-pam_sm_chauthtok-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_chauthtok.3.xml" xpointer='xpointer(id("pam_sm_chauthtok-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_sm_close_session.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-close.org/docbook/xml/4.4/docbookx.dtd">
<section id='mwg-pam_sm_close_session'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="mwg-pam_sm_close_session">
<title>Service function to terminate session management</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_close_session.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_sm_close_session-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_close_session.3.xml" xpointer='xpointer(id("pam_sm_close_session-synopsis")/*)'/>
</funcsynopsis>
<section id='mwg-pam_sm_close_session-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_close_session.3.xml" xpointer='xpointer(//refsect1[@id = "pam_sm_close_session-description"]/*)'/>
<section xml:id="mwg-pam_sm_close_session-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_close_session.3.xml" xpointer='xpointer(id("pam_sm_close_session-description")/*)'/>
</section>
<section id='mwg-pam_sm_close_session-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_close_session.3.xml" xpointer='xpointer(//refsect1[@id = "pam_sm_close_session-return_values"]/*)'/>
<section xml:id="mwg-pam_sm_close_session-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_close_session.3.xml" xpointer='xpointer(id("pam_sm_close_session-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_sm_open_session.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='mwg-pam_sm_open_session'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="mwg-pam_sm_open_session">
<title>Service function to start session management</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_open_session.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_sm_open_session-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_open_session.3.xml" xpointer='xpointer(id("pam_sm_open_session-synopsis")/*)'/>
</funcsynopsis>
<section id='mwg-pam_sm_open_session-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_open_session.3.xml" xpointer='xpointer(//refsect1[@id = "pam_sm_open_session-description"]/*)'/>
<section xml:id="mwg-pam_sm_open_session-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_open_session.3.xml" xpointer='xpointer(id("pam_sm_open_session-description")/*)'/>
</section>
<section id='mwg-pam_sm_open_session-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_open_session.3.xml" xpointer='xpointer(//refsect1[@id = "pam_sm_open_session-return_values"]/*)'/>
<section xml:id="mwg-pam_sm_open_session-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_open_session.3.xml" xpointer='xpointer(id("pam_sm_open_session-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_sm_setcred.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='mwg-pam_sm_setcred'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="mwg-pam_sm_setcred">
<title>Service function to alter credentials</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_setcred.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_sm_setcred-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_setcred.3.xml" xpointer='xpointer(id("pam_sm_setcred-synopsis")/*)'/>
</funcsynopsis>
<section id='mwg-pam_sm_setcred-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_setcred.3.xml" xpointer='xpointer(//refsect1[@id = "pam_sm_setcred-description"]/*)'/>
<section xml:id="mwg-pam_sm_setcred-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_setcred.3.xml" xpointer='xpointer(id("pam_sm_setcred-description")/*)'/>
</section>
<section id='mwg-pam_sm_setcred-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_sm_setcred.3.xml" xpointer='xpointer(//refsect1[@id = "pam_sm_setcred-return_values"]/*)'/>
<section xml:id="mwg-pam_sm_setcred-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_sm_setcred.3.xml" xpointer='xpointer(id("pam_sm_setcred-return_values")/*)'/>
</section>
</section>
</section>

20
doc/mwg/pam_strerror.xml
View File

@ -1,18 +1,12 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='adg-pam_strerror'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="adg-pam_strerror">
<title>Strings describing PAM error codes</title>
<funcsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_strerror.3.xml" xpointer='xpointer(//funcsynopsis[@id = "pam_strerror-synopsis"]/*)'/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_strerror.3.xml" xpointer='xpointer(id("pam_strerror-synopsis")/*)'/>
</funcsynopsis>
<section id='adg-pam_strerror-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_strerror.3.xml" xpointer='xpointer(//refsect1[@id = "pam_strerror-description"]/*)'/>
<section xml:id="adg-pam_strerror-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_strerror.3.xml" xpointer='xpointer(id("pam_strerror-description")/*)'/>
</section>
<section id='adg-pam_strerror-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam_strerror.3.xml" xpointer='xpointer(//refsect1[@id = "pam_strerror-return_values"]/*)'/>
<section xml:id="adg-pam_strerror-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam_strerror.3.xml" xpointer='xpointer(id("pam_strerror-return_values")/*)'/>
</section>
</section>
</section>

229
doc/sag/Linux-PAM_SAG.xml
View File

@ -1,36 +1,25 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<book id="sag">
<bookinfo>
<book xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="sag">
<info>
<title>The Linux-PAM System Administrators' Guide</title>
<authorgroup>
<author>
<firstname>Andrew G.</firstname>
<surname>Morgan</surname>
<email>morgan@kernel.org</email>
</author>
<author>
<firstname>Thorsten</firstname>
<surname>Kukuk</surname>
<email>kukuk@thkukuk.de</email>
</author>
<author><personname><firstname>Andrew G.</firstname><surname>Morgan</surname></personname><email>morgan@kernel.org</email></author>
<author><personname><firstname>Thorsten</firstname><surname>Kukuk</surname></personname><email>kukuk@thkukuk.de</email></author>
</authorgroup>
<releaseinfo>Version 1.1.2, 31. August 2010</releaseinfo>
<abstract>
<para>
This manual documents what a system-administrator needs to know about
the <emphasis remap='B'>Linux-PAM</emphasis> library. It covers the
the <emphasis remap="B">Linux-PAM</emphasis> library. It covers the
correct syntax of the PAM configuration file and discusses strategies
for maintaining a secure system.
</para>
</abstract>
</bookinfo>
</info>
<chapter id='sag-introduction'>
<chapter xml:id="sag-introduction">
<title>Introduction</title>
<para>
<emphasis remap='B'>Linux-PAM</emphasis> (Pluggable Authentication
<emphasis remap="B">Linux-PAM</emphasis> (Pluggable Authentication
Modules for Linux) is a suite of shared libraries that enable the
local system administrator to choose how applications authenticate users.
</para>
@ -58,7 +47,7 @@
on entries in the <filename>/etc/group</filename> file.
</para>
<para>
It is the purpose of the <emphasis remap='B'>Linux-PAM</emphasis>
It is the purpose of the <emphasis remap="B">Linux-PAM</emphasis>
project to separate the development of privilege granting software
from the development of secure and appropriate authentication schemes.
This is accomplished by providing a library of functions that an
@ -76,7 +65,7 @@
</para>
</chapter>
<chapter id="sag-text-conventions">
<chapter xml:id="sag-text-conventions">
<title>Some comments on the text</title>
<para>
Before proceeding to read the rest of this document, it should be
@ -91,7 +80,7 @@
<para>
As an example of the above, where it is explicit, the text assumes
that PAM loadable object files (the
<emphasis remap='B'>modules</emphasis>) are to be located in
<emphasis remap="B">modules</emphasis>) are to be located in
the following directory: <filename>/lib/security/</filename> or
<filename>/lib64/security</filename> depending on the architecture.
This is generally the location that seems to be compatible with the
@ -103,7 +92,7 @@
</para>
</chapter>
<chapter id="sag-overview">
<chapter xml:id="sag-overview">
<title>Overview</title>
<para>
For the uninitiated, we begin by considering an example. We take an
@ -121,16 +110,16 @@
password and then verifying that it agrees with that located on
the system; hence verifying that as far as the system is concerned
the user is who they claim to be. This is the task that is delegated
to <emphasis remap='B'>Linux-PAM</emphasis>.
to <emphasis remap="B">Linux-PAM</emphasis>.
</para>
<para>
From the perspective of the application programmer (in this case
the person that wrote the <command>login</command> application),
<emphasis remap='B'>Linux-PAM</emphasis> takes care of this
<emphasis remap="B">Linux-PAM</emphasis> takes care of this
authentication task -- verifying the identity of the user.
</para>
<para>
The flexibility of <emphasis remap='B'>Linux-PAM</emphasis> is
The flexibility of <emphasis remap="B">Linux-PAM</emphasis> is
that <emphasis>you</emphasis>, the system administrator, have
the freedom to stipulate which authentication scheme is to be
used. You have the freedom to set the scheme for any/all
@ -152,7 +141,7 @@
authentication can be upgraded to include (long) division!
</para>
<para>
<emphasis remap='B'>Linux-PAM</emphasis> deals with four
<emphasis remap="B">Linux-PAM</emphasis> deals with four
separate types of (management) task. These are:
<emphasis>authentication management</emphasis>;
<emphasis>account management</emphasis>;
@ -160,15 +149,15 @@
<emphasis>password management</emphasis>.
The association of the preferred management scheme with the behavior
of an application is made with entries in the relevant
<emphasis remap='B'>Linux-PAM</emphasis> configuration file.
<emphasis remap="B">Linux-PAM</emphasis> configuration file.
The management functions are performed by <emphasis>modules</emphasis>
specified in the configuration file. The syntax for this
file is discussed in the section
<link linkend="sag-configuration">below</link>.
<link linkend="sag-configuration">below</link>.
</para>
<para>
Here is a figure that describes the overall organization of
<emphasis remap='B'>Linux-PAM</emphasis>:
<emphasis remap="B">Linux-PAM</emphasis>:
<programlisting>
+----------------+
| application: X |
@ -193,14 +182,14 @@
</programlisting>
By way of explanation, the left of the figure represents the
application; application X. Such an application interfaces with the
<emphasis remap='B'>Linux-PAM</emphasis> library and knows none of
<emphasis remap="B">Linux-PAM</emphasis> library and knows none of
the specifics of its configured authentication method. The
<emphasis remap='B'>Linux-PAM</emphasis> library (in the center)
<emphasis remap="B">Linux-PAM</emphasis> library (in the center)
consults the contents of the PAM configuration file and loads the
modules that are appropriate for application-X. These modules fall
into one of four management groups (lower-center) and are stacked in
the order they appear in the configuration file. These modules, when
called by <emphasis remap='B'>Linux-PAM</emphasis>, perform the
called by <emphasis remap="B">Linux-PAM</emphasis>, perform the
various authentication tasks for the application. Textual information,
required from/or offered to the user, can be exchanged through the
use of the application-supplied <emphasis>conversation</emphasis>
@ -216,34 +205,28 @@
</para>
</chapter>
<chapter id="sag-configuration">
<chapter xml:id="sag-configuration">
<title>The Linux-PAM configuration file</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam.conf-desc.xml"
xpointer='xpointer(//section[@id = "pam.conf-desc"]/*)' />
<section id='sag-configuration-file'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam.conf-desc.xml" xpointer='xpointer(id("pam.conf-desc")/*)'/>
<section xml:id="sag-configuration-file">
<title>Configuration file syntax</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam.conf-syntax.xml"
xpointer='xpointer(//section[@id = "pam.conf-syntax"]/*)' />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam.conf-syntax.xml" xpointer='xpointer(id("pam.conf-syntax")/*)'/>
</section>
<section id='sag-configuration-directory'>
<section xml:id="sag-configuration-directory">
<title>Directory based configuration</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../man/pam.conf-dir.xml"
xpointer='xpointer(//section[@id = "pam.conf-dir"]/*)' />
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../man/pam.conf-dir.xml" xpointer='xpointer(id("pam.conf-dir")/*)'/>
</section>
<section id='sag-configuration-example'>
<section xml:id="sag-configuration-example">
<title>Example configuration file entries</title>
<para>
In this section, we give some examples of entries that can
be present in the <emphasis remap='B'>Linux-PAM</emphasis>
be present in the <emphasis remap="B">Linux-PAM</emphasis>
configuration file. As a first attempt at configuring your
system you could do worse than to implement these.
</para>
<para>
If a system is to be considered secure, it had better have a
reasonably secure '<emphasis remap='B'>other</emphasis> entry.
reasonably secure '<emphasis remap="B">other</emphasis> entry.
The following is a paranoid setting (which is not a bad place
to start!):
</para>
@ -311,7 +294,7 @@ session required pam_deny.so
<para>
On a less sensitive computer, one on which the system
administrator wishes to remain ignorant of much of the
power of <emphasis remap='B'>Linux-PAM</emphasis>, the
power of <emphasis remap="B">Linux-PAM</emphasis>, the
following selection of lines (in
<filename>/etc/pam.d/other</filename>) is likely to
mimic the historically familiar Linux setup.
@ -331,21 +314,21 @@ session required pam_unix.so
</section>
</chapter>
<chapter id='sag-security-issues'>
<chapter xml:id="sag-security-issues">
<title>Security issues</title>
<section id='sag-security-issues-wrong'>
<section xml:id="sag-security-issues-wrong">
<title>If something goes wrong</title>
<para>
<emphasis remap='B'>Linux-PAM</emphasis> has the potential
<emphasis remap="B">Linux-PAM</emphasis> has the potential
to seriously change the security of your system. You can
choose to have no security or absolute security (no access
permitted). In general, <emphasis remap='B'>Linux-PAM</emphasis>
permitted). In general, <emphasis remap="B">Linux-PAM</emphasis>
errs towards the latter. Any number of configuration errors
can disable access to your system partially, or completely.
</para>
<para>
The most dramatic problem that is likely to be encountered when
configuring <emphasis remap='B'>Linux-PAM</emphasis> is that of
configuring <emphasis remap="B">Linux-PAM</emphasis> is that of
<emphasis>deleting</emphasis> the configuration file(s):
<filename>/etc/pam.d/*</filename> and/or
<filename>/etc/pam.conf</filename>. This will lock you out of
@ -357,11 +340,11 @@ session required pam_unix.so
things from there.
</para>
</section>
<section id='sag-security-issues-other'>
<section xml:id="sag-security-issues-other">
<title>Avoid having a weak `other' configuration</title>
<para>
It is not a good thing to have a weak default
(<emphasis remap='B'>other</emphasis>) entry.
(<emphasis remap="B">other</emphasis>) entry.
This service is the default configuration for all PAM aware
applications and if it is weak, your system is likely to be
vulnerable to attack.
@ -388,93 +371,57 @@ session required pam_warn.so
</section>
</chapter>
<chapter id='sag-module-reference'>
<chapter xml:id="sag-module-reference">
<title>A reference guide for available modules</title>
<para>
Here, we collect together the descriptions of the various modules
coming with Linux-PAM.
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_access.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_debug.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_deny.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_echo.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_env.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_exec.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_faildelay.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_faillock.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_filter.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_ftp.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_group.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_issue.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_keyinit.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_lastlog.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_limits.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_listfile.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_localuser.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_loginuid.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_mail.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_mkhomedir.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_motd.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_namespace.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_nologin.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_permit.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_pwhistory.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_rhosts.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_rootok.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_securetty.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_selinux.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_shells.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_succeed_if.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_time.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_timestamp.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_umask.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_unix.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_userdb.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_warn.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_wheel.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="pam_xauth.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_access.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_debug.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_deny.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_echo.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_env.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_exec.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_faildelay.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_faillock.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_filter.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_ftp.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_group.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_issue.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_keyinit.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_lastlog.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_limits.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_listfile.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_localuser.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_loginuid.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_mail.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_mkhomedir.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_motd.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_namespace.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_nologin.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_permit.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_pwhistory.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_rhosts.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_rootok.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_securetty.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_selinux.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_sepermit.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_setquota.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_shells.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_succeed_if.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_time.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_timestamp.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_tty_audit.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_umask.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_unix.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_userdb.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_warn.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_wheel.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="pam_xauth.xml"/>
</chapter>
<chapter id="sag-see-also">
<chapter xml:id="sag-see-also">
<title>See also</title>
<itemizedlist>
<listitem>
@ -497,7 +444,7 @@ session required pam_warn.so
</itemizedlist>
</chapter>
<chapter id='sag-author'>
<chapter xml:id="sag-author">
<title>Author/acknowledgments</title>
<para>
This document was written by Andrew G. Morgan (morgan@kernel.org)
@ -518,14 +465,14 @@ session required pam_warn.so
<para>
Thanks are also due to Sun Microsystems, especially to Vipin Samar and
Charlie Lai for their advice. At an early stage in the development of
<emphasis remap='B'>Linux-PAM</emphasis>, Sun graciously made the
<emphasis remap="B">Linux-PAM</emphasis>, Sun graciously made the
documentation for their implementation of PAM available. This act
greatly accelerated the development of
<emphasis remap='B'>Linux-PAM</emphasis>.
<emphasis remap="B">Linux-PAM</emphasis>.
</para>
</chapter>
<chapter id='sag-copyright'>
<chapter xml:id="sag-copyright">
<title>Copyright information for this document</title>
<programlisting>
Copyright (c) 2006 Thorsten Kukuk &lt;kukuk@thkukuk.de&gt;
@ -569,4 +516,4 @@ TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
</programlisting>
</chapter>
</book>
</book>

7
doc/sag/Makefile.am
View File

@ -7,7 +7,6 @@ CLEANFILES = Linux-PAM_SAG.fo *~
EXTRA_DIST = $(XMLS)
XMLS = Linux-PAM_SAG.xml $(shell ls $(srcdir)/pam_*.xml)
DEP_XMLS = $(shell ls $(top_srcdir)/modules/pam_*/pam_*.xml)
if ENABLE_REGENERATE_MAN
@ -17,7 +16,7 @@ all: Linux-PAM_SAG.txt html/Linux-PAM_SAG.html Linux-PAM_SAG.pdf
Linux-PAM_SAG.pdf: $(XMLS) $(DEP_XMLS)
if ENABLE_GENERATE_PDF
$(XMLLINT) --nonet --xinclude --postvalid --noent --noout $<
$(XMLLINT) --nonet --xinclude --relaxng $(DOCBOOK_RNG) --noent --noout $<
$(XSLTPROC) --stringparam generate.toc "book toc" \
--stringparam section.autolabel 1 \
--stringparam section.label.includes.component.label 1 \
@ -29,7 +28,7 @@ else
endif
Linux-PAM_SAG.txt: $(XMLS) $(DEP_XMLS)
$(XMLLINT) --nonet --xinclude --postvalid --noent --noout $<
$(XMLLINT) --nonet --xinclude --relaxng $(DOCBOOK_RNG) --noent --noout $<
$(XSLTPROC) --stringparam generate.toc "book toc" \
--stringparam section.autolabel 1 \
--stringparam section.label.includes.component.label 1 \
@ -38,7 +37,7 @@ Linux-PAM_SAG.txt: $(XMLS) $(DEP_XMLS)
html/Linux-PAM_SAG.html: $(XMLS) $(DEP_XMLS)
@test -d html || mkdir -p html
$(XMLLINT) --nonet --xinclude --postvalid --noent --noout $<
$(XMLLINT) --nonet --xinclude --relaxng $(DOCBOOK_RNG) --noent --noout $<
$(XSLTPROC) --stringparam base.dir html/ \
--stringparam root.filename Linux-PAM_SAG \
--stringparam use.id.as.filename 1 \

52
doc/sag/pam_access.xml
View File

@ -1,42 +1,30 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='sag-pam_access'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="sag-pam_access">
<title>pam_access - logdaemon style login access control</title>
<cmdsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_access/pam_access.8.xml" xpointer='xpointer(//cmdsynopsis[@id = "pam_access-cmdsynopsis"]/*)'/>
<cmdsynopsis sepchar=" ">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_access/pam_access.8.xml" xpointer='xpointer(id("pam_access-cmdsynopsis")/*)'/>
</cmdsynopsis>
<section id='sag-pam_access-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_access/pam_access.8.xml" xpointer='xpointer(//refsect1[@id = "pam_access-description"]/*)'/>
<section xml:id="sag-pam_access-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_access/pam_access.8.xml" xpointer='xpointer(id("pam_access-description")/*)'/>
</section>
<section id='sag-access.conf-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_access/access.conf.5.xml" xpointer='xpointer(//refsect1[@id = "access.conf-description"]/*)'/>
<section xml:id="sag-access.conf-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_access/access.conf.5.xml" xpointer='xpointer(id("access.conf-description")/*)'/>
</section>
<section id='sag-pam_access-options'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_access/pam_access.8.xml" xpointer='xpointer(//refsect1[@id = "pam_access-options"]/*)'/>
<section xml:id="sag-pam_access-options">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_access/pam_access.8.xml" xpointer='xpointer(id("pam_access-options")/*)'/>
</section>
<section id='sag-pam_access-types'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_access/pam_access.8.xml" xpointer='xpointer(//refsect1[@id = "pam_access-types"]/*)'/>
<section xml:id="sag-pam_access-types">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_access/pam_access.8.xml" xpointer='xpointer(id("pam_access-types")/*)'/>
</section>
<section id='sag-pam_access-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_access/pam_access.8.xml" xpointer='xpointer(//refsect1[@id = "pam_access-return_values"]/*)'/>
<section xml:id="sag-pam_access-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_access/pam_access.8.xml" xpointer='xpointer(id("pam_access-return_values")/*)'/>
</section>
<section id='sag-pam_access-files'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_access/pam_access.8.xml" xpointer='xpointer(//refsect1[@id = "pam_access-files"]/*)'/>
<section xml:id="sag-pam_access-files">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_access/pam_access.8.xml" xpointer='xpointer(id("pam_access-files")/*)'/>
</section>
<section id='sag-access.conf-examples'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_access/access.conf.5.xml" xpointer='xpointer(//refsect1[@id = "access.conf-examples"]/*)'/>
<section xml:id="sag-access.conf-examples">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_access/access.conf.5.xml" xpointer='xpointer(id("access.conf-examples")/*)'/>
</section>
<section id='sag-pam_access-authors'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_access/pam_access.8.xml" xpointer='xpointer(//refsect1[@id = "pam_access-authors"]/*)'/>
<section xml:id="sag-pam_access-authors">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_access/pam_access.8.xml" xpointer='xpointer(id("pam_access-authors")/*)'/>
</section>
</section>
</section>

42
doc/sag/pam_debug.xml
View File

@ -1,34 +1,24 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='sag-pam_debug'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="sag-pam_debug">
<title>pam_debug - debug the PAM stack</title>
<cmdsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_debug/pam_debug.8.xml" xpointer='xpointer(//cmdsynopsis[@id = "pam_debug-cmdsynopsis"]/*)'/>
<cmdsynopsis sepchar=" ">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_debug/pam_debug.8.xml" xpointer='xpointer(id("pam_debug-cmdsynopsis")/*)'/>
</cmdsynopsis>
<section id='sag-pam_debug-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_debug/pam_debug.8.xml" xpointer='xpointer(//refsect1[@id = "pam_debug-description"]/*)'/>
<section xml:id="sag-pam_debug-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_debug/pam_debug.8.xml" xpointer='xpointer(id("pam_debug-description")/*)'/>
</section>
<section id='sag-pam_debug-options'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_debug/pam_debug.8.xml" xpointer='xpointer(//refsect1[@id = "pam_debug-options"]/*)'/>
<section xml:id="sag-pam_debug-options">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_debug/pam_debug.8.xml" xpointer='xpointer(id("pam_debug-options")/*)'/>
</section>
<section id='sag-pam_debug-types'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_debug/pam_debug.8.xml" xpointer='xpointer(//refsect1[@id = "pam_debug-types"]/*)'/>
<section xml:id="sag-pam_debug-types">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_debug/pam_debug.8.xml" xpointer='xpointer(id("pam_debug-types")/*)'/>
</section>
<section id='sag-pam_debug-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_debug/pam_debug.8.xml" xpointer='xpointer(//refsect1[@id = "pam_debug-return_values"]/*)'/>
<section xml:id="sag-pam_debug-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_debug/pam_debug.8.xml" xpointer='xpointer(id("pam_debug-return_values")/*)'/>
</section>
<section id='sag-pam_debug-examples'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_debug/pam_debug.8.xml" xpointer='xpointer(//refsect1[@id = "pam_debug-examples"]/*)'/>
<section xml:id="sag-pam_debug-examples">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_debug/pam_debug.8.xml" xpointer='xpointer(id("pam_debug-examples")/*)'/>
</section>
<section id='sag-pam_debug-author'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_debug/pam_debug.8.xml" xpointer='xpointer(//refsect1[@id = "pam_debug-author"]/*)'/>
<section xml:id="sag-pam_debug-author">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_debug/pam_debug.8.xml" xpointer='xpointer(id("pam_debug-author")/*)'/>
</section>
</section>
</section>

42
doc/sag/pam_deny.xml
View File

@ -1,34 +1,24 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='sag-pam_deny'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="sag-pam_deny">
<title>pam_deny - locking-out PAM module</title>
<cmdsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_deny/pam_deny.8.xml" xpointer='xpointer(//cmdsynopsis[@id = "pam_deny-cmdsynopsis"]/*)'/>
<cmdsynopsis sepchar=" ">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_deny/pam_deny.8.xml" xpointer='xpointer(id("pam_deny-cmdsynopsis")/*)'/>
</cmdsynopsis>
<section id='sag-pam_deny-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_deny/pam_deny.8.xml" xpointer='xpointer(//refsect1[@id = "pam_deny-description"]/*)'/>
<section xml:id="sag-pam_deny-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_deny/pam_deny.8.xml" xpointer='xpointer(id("pam_deny-description")/*)'/>
</section>
<section id='sag-pam_deny-options'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_deny/pam_deny.8.xml" xpointer='xpointer(//refsect1[@id = "pam_deny-options"]/*)'/>
<section xml:id="sag-pam_deny-options">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_deny/pam_deny.8.xml" xpointer='xpointer(id("pam_deny-options")/*)'/>
</section>
<section id='sag-pam_deny-types'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_deny/pam_deny.8.xml" xpointer='xpointer(//refsect1[@id = "pam_deny-types"]/*)'/>
<section xml:id="sag-pam_deny-types">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_deny/pam_deny.8.xml" xpointer='xpointer(id("pam_deny-types")/*)'/>
</section>
<section id='sag-pam_deny-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_deny/pam_deny.8.xml" xpointer='xpointer(//refsect1[@id = "pam_deny-return_values"]/*)'/>
<section xml:id="sag-pam_deny-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_deny/pam_deny.8.xml" xpointer='xpointer(id("pam_deny-return_values")/*)'/>
</section>
<section id='sag-pam_deny-examples'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_deny/pam_deny.8.xml" xpointer='xpointer(//refsect1[@id = "pam_deny-examples"]/*)'/>
<section xml:id="sag-pam_deny-examples">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_deny/pam_deny.8.xml" xpointer='xpointer(id("pam_deny-examples")/*)'/>
</section>
<section id='sag-pam_deny-author'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_deny/pam_deny.8.xml" xpointer='xpointer(//refsect1[@id = "pam_deny-author"]/*)'/>
<section xml:id="sag-pam_deny-author">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_deny/pam_deny.8.xml" xpointer='xpointer(id("pam_deny-author")/*)'/>
</section>
</section>
</section>

42
doc/sag/pam_echo.xml
View File

@ -1,34 +1,24 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='sag-pam_echo'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="sag-pam_echo">
<title>pam_echo - print text messages</title>
<cmdsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_echo/pam_echo.8.xml" xpointer='xpointer(//cmdsynopsis[@id = "pam_echo-cmdsynopsis"]/*)'/>
<cmdsynopsis sepchar=" ">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_echo/pam_echo.8.xml" xpointer='xpointer(id("pam_echo-cmdsynopsis")/*)'/>
</cmdsynopsis>
<section id='sag-pam_echo-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_echo/pam_echo.8.xml" xpointer='xpointer(//refsect1[@id = "pam_echo-description"]/*)'/>
<section xml:id="sag-pam_echo-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_echo/pam_echo.8.xml" xpointer='xpointer(id("pam_echo-description")/*)'/>
</section>
<section id='sag-pam_echo-options'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_echo/pam_echo.8.xml" xpointer='xpointer(//refsect1[@id = "pam_echo-options"]/*)'/>
<section xml:id="sag-pam_echo-options">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_echo/pam_echo.8.xml" xpointer='xpointer(id("pam_echo-options")/*)'/>
</section>
<section id='sag-pam_echo-types'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_echo/pam_echo.8.xml" xpointer='xpointer(//refsect1[@id = "pam_echo-types"]/*)'/>
<section xml:id="sag-pam_echo-types">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_echo/pam_echo.8.xml" xpointer='xpointer(id("pam_echo-types")/*)'/>
</section>
<section id='sag-pam_echo-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_echo/pam_echo.8.xml" xpointer='xpointer(//refsect1[@id = "pam_echo-return_values"]/*)'/>
<section xml:id="sag-pam_echo-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_echo/pam_echo.8.xml" xpointer='xpointer(id("pam_echo-return_values")/*)'/>
</section>
<section id='sag-pam_echo-examples'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_echo/pam_echo.8.xml" xpointer='xpointer(//refsect1[@id = "pam_echo-examples"]/*)'/>
<section xml:id="sag-pam_echo-examples">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_echo/pam_echo.8.xml" xpointer='xpointer(id("pam_echo-examples")/*)'/>
</section>
<section id='sag-pam_echo-author'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_echo/pam_echo.8.xml" xpointer='xpointer(//refsect1[@id = "pam_echo-author"]/*)'/>
<section xml:id="sag-pam_echo-author">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_echo/pam_echo.8.xml" xpointer='xpointer(id("pam_echo-author")/*)'/>
</section>
</section>
</section>

52
doc/sag/pam_env.xml
View File

@ -1,42 +1,30 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='sag-pam_env'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="sag-pam_env">
<title>pam_env - set/unset environment variables</title>
<cmdsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_env/pam_env.8.xml" xpointer='xpointer(//cmdsynopsis[@id = "pam_env-cmdsynopsis"]/*)'/>
<cmdsynopsis sepchar=" ">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_env/pam_env.8.xml" xpointer='xpointer(id("pam_env-cmdsynopsis")/*)'/>
</cmdsynopsis>
<section id='sag-pam_env-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_env/pam_env.8.xml" xpointer='xpointer(//refsect1[@id = "pam_env-description"]/*)'/>
<section xml:id="sag-pam_env-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_env/pam_env.8.xml" xpointer='xpointer(id("pam_env-description")/*)'/>
</section>
<section id='sag-pam_env.conf-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_env/pam_env.conf.5.xml" xpointer='xpointer(//refsect1[@id = "pam_env.conf-description"]/*)'/>
<section xml:id="sag-pam_env.conf-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_env/pam_env.conf.5.xml" xpointer='xpointer(id("pam_env.conf-description")/*)'/>
</section>
<section id='sag-pam_env-options'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_env/pam_env.8.xml" xpointer='xpointer(//refsect1[@id = "pam_env-options"]/*)'/>
<section xml:id="sag-pam_env-options">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_env/pam_env.8.xml" xpointer='xpointer(id("pam_env-options")/*)'/>
</section>
<section id='sag-pam_env-types'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_env/pam_env.8.xml" xpointer='xpointer(//refsect1[@id = "pam_env-types"]/*)'/>
<section xml:id="sag-pam_env-types">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_env/pam_env.8.xml" xpointer='xpointer(id("pam_env-types")/*)'/>
</section>
<section id='sag-pam_env-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_env/pam_env.8.xml" xpointer='xpointer(//refsect1[@id = "pam_env-return_values"]/*)'/>
<section xml:id="sag-pam_env-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_env/pam_env.8.xml" xpointer='xpointer(id("pam_env-return_values")/*)'/>
</section>
<section id='sag-pam_env-files'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_env/pam_env.8.xml" xpointer='xpointer(//refsect1[@id = "pam_env-files"]/*)'/>
<section xml:id="sag-pam_env-files">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_env/pam_env.8.xml" xpointer='xpointer(id("pam_env-files")/*)'/>
</section>
<section id='sag-pam_env.conf-examples'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_env/pam_env.conf.5.xml" xpointer='xpointer(//refsect1[@id = "pam_env.conf-examples"]/*)'/>
<section xml:id="sag-pam_env.conf-examples">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_env/pam_env.conf.5.xml" xpointer='xpointer(id("pam_env.conf-examples")/*)'/>
</section>
<section id='sag-pam_env-authors'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_env/pam_env.8.xml" xpointer='xpointer(//refsect1[@id = "pam_env-authors"]/*)'/>
<section xml:id="sag-pam_env-authors">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_env/pam_env.8.xml" xpointer='xpointer(id("pam_env-authors")/*)'/>
</section>
</section>
</section>

42
doc/sag/pam_exec.xml
View File

@ -1,34 +1,24 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='sag-pam_exec'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="sag-pam_exec">
<title>pam_exec - call an external command</title>
<cmdsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_exec/pam_exec.8.xml" xpointer='xpointer(//cmdsynopsis[@id = "pam_exec-cmdsynopsis"]/*)'/>
<cmdsynopsis sepchar=" ">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_exec/pam_exec.8.xml" xpointer='xpointer(id("pam_exec-cmdsynopsis")/*)'/>
</cmdsynopsis>
<section id='sag-pam_exec-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_exec/pam_exec.8.xml" xpointer='xpointer(//refsect1[@id = "pam_exec-description"]/*)'/>
<section xml:id="sag-pam_exec-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_exec/pam_exec.8.xml" xpointer='xpointer(id("pam_exec-description")/*)'/>
</section>
<section id='sag-pam_exec-options'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_exec/pam_exec.8.xml" xpointer='xpointer(//refsect1[@id = "pam_exec-options"]/*)'/>
<section xml:id="sag-pam_exec-options">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_exec/pam_exec.8.xml" xpointer='xpointer(id("pam_exec-options")/*)'/>
</section>
<section id='sag-pam_exec-types'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_exec/pam_exec.8.xml" xpointer='xpointer(//refsect1[@id = "pam_exec-types"]/*)'/>
<section xml:id="sag-pam_exec-types">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_exec/pam_exec.8.xml" xpointer='xpointer(id("pam_exec-types")/*)'/>
</section>
<section id='sag-pam_exec-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_exec/pam_exec.8.xml" xpointer='xpointer(//refsect1[@id = "pam_exec-return_values"]/*)'/>
<section xml:id="sag-pam_exec-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_exec/pam_exec.8.xml" xpointer='xpointer(id("pam_exec-return_values")/*)'/>
</section>
<section id='sag-pam_exec-examples'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_exec/pam_exec.8.xml" xpointer='xpointer(//refsect1[@id = "pam_exec-examples"]/*)'/>
<section xml:id="sag-pam_exec-examples">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_exec/pam_exec.8.xml" xpointer='xpointer(id("pam_exec-examples")/*)'/>
</section>
<section id='sag-pam_exec-author'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_exec/pam_exec.8.xml" xpointer='xpointer(//refsect1[@id = "pam_exec-author"]/*)'/>
<section xml:id="sag-pam_exec-author">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_exec/pam_exec.8.xml" xpointer='xpointer(id("pam_exec-author")/*)'/>
</section>
</section>
</section>

42
doc/sag/pam_faildelay.xml
View File

@ -1,34 +1,24 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='sag-pam_faildelay'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="sag-pam_faildelay">
<title>pam_faildelay - change the delay on failure per-application</title>
<cmdsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_faildelay/pam_faildelay.8.xml" xpointer='xpointer(//cmdsynopsis[@id = "pam_faildelay-cmdsynopsis"]/*)'/>
<cmdsynopsis sepchar=" ">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_faildelay/pam_faildelay.8.xml" xpointer='xpointer(id("pam_faildelay-cmdsynopsis")/*)'/>
</cmdsynopsis>
<section id='sag-pam_faildelay-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_faildelay/pam_faildelay.8.xml" xpointer='xpointer(//refsect1[@id = "pam_faildelay-description"]/*)'/>
<section xml:id="sag-pam_faildelay-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_faildelay/pam_faildelay.8.xml" xpointer='xpointer(id("pam_faildelay-description")/*)'/>
</section>
<section id='sag-pam_faildelay-options'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_faildelay/pam_faildelay.8.xml" xpointer='xpointer(//refsect1[@id = "pam_faildelay-options"]/*)'/>
<section xml:id="sag-pam_faildelay-options">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_faildelay/pam_faildelay.8.xml" xpointer='xpointer(id("pam_faildelay-options")/*)'/>
</section>
<section id='sag-pam_faildelay-types'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_faildelay/pam_faildelay.8.xml" xpointer='xpointer(//refsect1[@id = "pam_faildelay-types"]/*)'/>
<section xml:id="sag-pam_faildelay-types">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_faildelay/pam_faildelay.8.xml" xpointer='xpointer(id("pam_faildelay-types")/*)'/>
</section>
<section id='sag-pam_faildelay-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_faildelay/pam_faildelay.8.xml" xpointer='xpointer(//refsect1[@id = "pam_faildelay-return_values"]/*)'/>
<section xml:id="sag-pam_faildelay-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_faildelay/pam_faildelay.8.xml" xpointer='xpointer(id("pam_faildelay-return_values")/*)'/>
</section>
<section id='sag-pam_faildelay-examples'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_faildelay/pam_faildelay.8.xml" xpointer='xpointer(//refsect1[@id = "pam_faildelay-examples"]/*)'/>
<section xml:id="sag-pam_faildelay-examples">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_faildelay/pam_faildelay.8.xml" xpointer='xpointer(id("pam_faildelay-examples")/*)'/>
</section>
<section id='sag-pam_faildelay-author'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_faildelay/pam_faildelay.8.xml" xpointer='xpointer(//refsect1[@id = "pam_faildelay-author"]/*)'/>
<section xml:id="sag-pam_faildelay-author">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_faildelay/pam_faildelay.8.xml" xpointer='xpointer(id("pam_faildelay-author")/*)'/>
</section>
</section>
</section>

47
doc/sag/pam_faillock.xml
View File

@ -1,38 +1,27 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='sag-pam_faillock'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="sag-pam_faillock">
<title>pam_faillock - temporarily locking access based on failed authentication attempts during an interval</title>
<cmdsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(//cmdsynopsis[@id = "pam_faillock-cmdsynopsisauth"]/*)'/>
<cmdsynopsis sepchar=" ">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(id("pam_faillock-cmdsynopsisauth")/*)'/>
</cmdsynopsis>
<cmdsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(//cmdsynopsis[@id = "pam_faillock-cmdsynopsisacct"]/*)'/>
<cmdsynopsis sepchar=" ">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(id("pam_faillock-cmdsynopsisacct")/*)'/>
</cmdsynopsis>
<section id='sag-pam_faillock-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(//refsect1[@id = "pam_faillock-description"]/*)'/>
<section xml:id="sag-pam_faillock-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(id("pam_faillock-description")/*)'/>
</section>
<section id='sag-pam_faillock-options'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(//refsect1[@id = "pam_faillock-options"]/*)'/>
<section xml:id="sag-pam_faillock-options">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(id("pam_faillock-options")/*)'/>
</section>
<section id='sag-pam_faillock-types'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(//refsect1[@id = "pam_faillock-types"]/*)'/>
<section xml:id="sag-pam_faillock-types">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(id("pam_faillock-types")/*)'/>
</section>
<section id='sag-pam_faillock-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(//refsect1[@id = "pam_faillock-return_values"]/*)'/>
<section xml:id="sag-pam_faillock-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(id("pam_faillock-return_values")/*)'/>
</section>
<section id='sag-pam_faillock-examples'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(//refsect1[@id = "pam_faillock-examples"]/*)'/>
<section xml:id="sag-pam_faillock-examples">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(id("pam_faillock-examples")/*)'/>
</section>
<section id='sag-pam_faillock-author'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(//refsect1[@id = "pam_faillock-author"]/*)'/>
<section xml:id="sag-pam_faillock-author">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_faillock/pam_faillock.8.xml" xpointer='xpointer(id("pam_faillock-author")/*)'/>
</section>
</section>
</section>

42
doc/sag/pam_filter.xml
View File

@ -1,34 +1,24 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='sag-pam_filter'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="sag-pam_filter">
<title>pam_filter - filter module</title>
<cmdsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_filter/pam_filter.8.xml" xpointer='xpointer(//cmdsynopsis[@id = "pam_filter-cmdsynopsis"]/*)'/>
<cmdsynopsis sepchar=" ">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_filter/pam_filter.8.xml" xpointer='xpointer(id("pam_filter-cmdsynopsis")/*)'/>
</cmdsynopsis>
<section id='sag-pam_filter-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_filter/pam_filter.8.xml" xpointer='xpointer(//refsect1[@id = "pam_filter-description"]/*)'/>
<section xml:id="sag-pam_filter-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_filter/pam_filter.8.xml" xpointer='xpointer(id("pam_filter-description")/*)'/>
</section>
<section id='sag-pam_filter-options'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_filter/pam_filter.8.xml" xpointer='xpointer(//refsect1[@id = "pam_filter-options"]/*)'/>
<section xml:id="sag-pam_filter-options">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_filter/pam_filter.8.xml" xpointer='xpointer(id("pam_filter-options")/*)'/>
</section>
<section id='sag-pam_filter-types'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_filter/pam_filter.8.xml" xpointer='xpointer(//refsect1[@id = "pam_filter-types"]/*)'/>
<section xml:id="sag-pam_filter-types">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_filter/pam_filter.8.xml" xpointer='xpointer(id("pam_filter-types")/*)'/>
</section>
<section id='sag-pam_filter-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_filter/pam_filter.8.xml" xpointer='xpointer(//refsect1[@id = "pam_filter-return_values"]/*)'/>
<section xml:id="sag-pam_filter-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_filter/pam_filter.8.xml" xpointer='xpointer(id("pam_filter-return_values")/*)'/>
</section>
<section id='sag-pam_filter-examples'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_filter/pam_filter.8.xml" xpointer='xpointer(//refsect1[@id = "pam_filter-examples"]/*)'/>
<section xml:id="sag-pam_filter-examples">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_filter/pam_filter.8.xml" xpointer='xpointer(id("pam_filter-examples")/*)'/>
</section>
<section id='sag-pam_filter-author'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_filter/pam_filter.8.xml" xpointer='xpointer(//refsect1[@id = "pam_filter-author"]/*)'/>
<section xml:id="sag-pam_filter-author">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_filter/pam_filter.8.xml" xpointer='xpointer(id("pam_filter-author")/*)'/>
</section>
</section>
</section>

42
doc/sag/pam_ftp.xml
View File

@ -1,34 +1,24 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='sag-pam_ftp'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="sag-pam_ftp">
<title>pam_ftp - module for anonymous access</title>
<cmdsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_ftp/pam_ftp.8.xml" xpointer='xpointer(//cmdsynopsis[@id = "pam_ftp-cmdsynopsis"]/*)'/>
<cmdsynopsis sepchar=" ">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_ftp/pam_ftp.8.xml" xpointer='xpointer(id("pam_ftp-cmdsynopsis")/*)'/>
</cmdsynopsis>
<section id='sag-pam_ftp-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_ftp/pam_ftp.8.xml" xpointer='xpointer(//refsect1[@id = "pam_ftp-description"]/*)'/>
<section xml:id="sag-pam_ftp-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_ftp/pam_ftp.8.xml" xpointer='xpointer(id("pam_ftp-description")/*)'/>
</section>
<section id='sag-pam_ftp-options'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_ftp/pam_ftp.8.xml" xpointer='xpointer(//refsect1[@id = "pam_ftp-options"]/*)'/>
<section xml:id="sag-pam_ftp-options">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_ftp/pam_ftp.8.xml" xpointer='xpointer(id("pam_ftp-options")/*)'/>
</section>
<section id='sag-pam_ftp-types'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_ftp/pam_ftp.8.xml" xpointer='xpointer(//refsect1[@id = "pam_ftp-types"]/*)'/>
<section xml:id="sag-pam_ftp-types">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_ftp/pam_ftp.8.xml" xpointer='xpointer(id("pam_ftp-types")/*)'/>
</section>
<section id='sag-pam_ftp-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_ftp/pam_ftp.8.xml" xpointer='xpointer(//refsect1[@id = "pam_ftp-return_values"]/*)'/>
<section xml:id="sag-pam_ftp-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_ftp/pam_ftp.8.xml" xpointer='xpointer(id("pam_ftp-return_values")/*)'/>
</section>
<section id='sag-pam_ftp-examples'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_ftp/pam_ftp.8.xml" xpointer='xpointer(//refsect1[@id = "pam_ftp-examples"]/*)'/>
<section xml:id="sag-pam_ftp-examples">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_ftp/pam_ftp.8.xml" xpointer='xpointer(id("pam_ftp-examples")/*)'/>
</section>
<section id='sag-pam_ftp-author'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_ftp/pam_ftp.8.xml" xpointer='xpointer(//refsect1[@id = "pam_ftp-author"]/*)'/>
<section xml:id="sag-pam_ftp-author">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_ftp/pam_ftp.8.xml" xpointer='xpointer(id("pam_ftp-author")/*)'/>
</section>
</section>
</section>

52
doc/sag/pam_group.xml
View File

@ -1,42 +1,30 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<section id='sag-pam_group'>
<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="sag-pam_group">
<title>pam_group - module to modify group access</title>
<cmdsynopsis>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_group/pam_group.8.xml" xpointer='xpointer(//cmdsynopsis[@id = "pam_group-cmdsynopsis"]/*)'/>
<cmdsynopsis sepchar=" ">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_group/pam_group.8.xml" xpointer='xpointer(id("pam_group-cmdsynopsis")/*)'/>
</cmdsynopsis>
<section id='sag-pam_group-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_group/pam_group.8.xml" xpointer='xpointer(//refsect1[@id = "pam_group-description"]/*)'/>
<section xml:id="sag-pam_group-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_group/pam_group.8.xml" xpointer='xpointer(id("pam_group-description")/*)'/>
</section>
<section id='sag-group.conf-description'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_group/group.conf.5.xml" xpointer='xpointer(//refsect1[@id = "group.conf-description"]/*)'/>
<section xml:id="sag-group.conf-description">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_group/group.conf.5.xml" xpointer='xpointer(id("group.conf-description")/*)'/>
</section>
<section id='sag-pam_group-options'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_group/pam_group.8.xml" xpointer='xpointer(//refsect1[@id = "pam_group-options"]/*)'/>
<section xml:id="sag-pam_group-options">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_group/pam_group.8.xml" xpointer='xpointer(id("pam_group-options")/*)'/>
</section>
<section id='sag-pam_group-types'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_group/pam_group.8.xml" xpointer='xpointer(//refsect1[@id = "pam_group-types"]/*)'/>
<section xml:id="sag-pam_group-types">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_group/pam_group.8.xml" xpointer='xpointer(id("pam_group-types")/*)'/>
</section>
<section id='sag-pam_group-return_values'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_group/pam_group.8.xml" xpointer='xpointer(//refsect1[@id = "pam_group-return_values"]/*)'/>
<section xml:id="sag-pam_group-return_values">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_group/pam_group.8.xml" xpointer='xpointer(id("pam_group-return_values")/*)'/>
</section>
<section id='sag-pam_group-files'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_group/pam_group.8.xml" xpointer='xpointer(//refsect1[@id = "pam_group-files"]/*)'/>
<section xml:id="sag-pam_group-files">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_group/pam_group.8.xml" xpointer='xpointer(id("pam_group-files")/*)'/>
</section>
<section id='sag-group.conf-examples'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_group/group.conf.5.xml" xpointer='xpointer(//refsect1[@id = "group.conf-examples"]/*)'/>
<section xml:id="sag-group.conf-examples">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_group/group.conf.5.xml" xpointer='xpointer(id("group.conf-examples")/*)'/>
</section>
<section id='sag-pam_group-authors'>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../modules/pam_group/pam_group.8.xml" xpointer='xpointer(//refsect1[@id = "pam_group-authors"]/*)'/>
<section xml:id="sag-pam_group-authors">
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="../../modules/pam_group/pam_group.8.xml" xpointer='xpointer(id("pam_group-authors")/*)'/>
</section>
</section>
</section>

Some files were not shown because too many files have changed in this diff Show More