From 393585017d45cf174384530f57cb8bc5cec1b457 Mon Sep 17 00:00:00 2001 From: Thorsten Kukuk Date: Fri, 9 Jun 2006 16:44:06 +0000 Subject: Relevant BUGIDs: Purpose of commit: new feature Commit summary: --------------- 2006-06-09 Thorsten Kukuk * modules/pam_wheel/Makefile.am: Include Make.xml.rules. * modules/pam_wheel/pam_wheel.8.xml: New. * modules/pam_wheel/pam_wheel.8: New, generated from xml file. * modules/pam_wheel/README.xml: New. * modules/pam_wheel/README: Regenerated from xml file. * modules/pam_xauth/Makefile.am: Include Make.xml.rules. * modules/pam_xauth/pam_xauth.8.xml: New. * modules/pam_xauth/pam_xauth.8: Regenerated from xml file. * modules/pam_xauth/README.xml: New. * modules/pam_xauth/README: Regenerated from xml file. * modules/pam_deny/pam_deny.8.xml: Fix syntax errors. * modules/pam_deny/pam_deny.8: Regenerate from xml file. * modules/pam_deny/README: Likewise. * modules/pam_warn/Makefile.am: Include Make.xml.rules. * modules/pam_warn/pam_warn.8.xml: New. * modules/pam_warn/pam_warn.8: New, generated from xml file. * modules/pam_warn/README.xml: New. * modules/pam_warn/README: Regenerated from xml file. * modules/pam_userdb/Makefile.am: Include Make.xml.rules. * modules/pam_userdb/pam_userdb.8.xml: New. * modules/pam_userdb/pam_userdb.8: New, generated from xml file. * modules/pam_userdb/README.xml: New. * modules/pam_userdb/README: Regenerated from xml file. --- modules/pam_warn/Makefile.am | 12 ++++- modules/pam_warn/README | 46 +++++++++++------- modules/pam_warn/README.xml | 41 ++++++++++++++++ modules/pam_warn/pam_warn.8 | 67 ++++++++++++++++++++++++++ modules/pam_warn/pam_warn.8.xml | 104 ++++++++++++++++++++++++++++++++++++++++ 5 files changed, 251 insertions(+), 19 deletions(-) create mode 100644 modules/pam_warn/README.xml create mode 100644 modules/pam_warn/pam_warn.8 create mode 100644 modules/pam_warn/pam_warn.8.xml (limited to 'modules/pam_warn') diff --git a/modules/pam_warn/Makefile.am b/modules/pam_warn/Makefile.am index 49916d0f..6ecc1362 100644 --- a/modules/pam_warn/Makefile.am +++ b/modules/pam_warn/Makefile.am @@ -4,7 +4,10 @@ CLEANFILES = *~ -EXTRA_DIST = README tst-pam_warn +EXTRA_DIST = README $(MANS) $(XMLS) tst-pam_warn + +man_MANS = pam_warn.8 +XMLS = README.xml pam_warn.8.xml TESTS = tst-pam_warn @@ -19,3 +22,10 @@ if HAVE_VERSIONING endif securelib_LTLIBRARIES = pam_warn.la + +if ENABLE_REGENERATE_MAN +noinst_DATA = README +README: pam_warn.8.xml +-include $(top_srcdir)/Make.xml.rules +endif + diff --git a/modules/pam_warn/README b/modules/pam_warn/README index 6d484bdf..d9619b53 100644 --- a/modules/pam_warn/README +++ b/modules/pam_warn/README @@ -1,26 +1,36 @@ -# $Id$ -# +pam_warn — PAM module which logs all PAM items if called + +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + +DESCRIPTION -This module is an authentication module that does not authenticate. -Instead it always returns PAM_IGNORE, indicating that it does not want -to affect the authentication process. +pam_warn is a PAM module that logs the service, terminal, user, remote user and +remote host to syslog(3). The items are not probed for, but instead obtained +from the standard PAM items. The module always returns PAM_IGNORE, indicating +that it does not want to affect the authentication process. -Its purpose is to log a message to the syslog indicating the -pam_item's available at the time it was invoked. It is a diagnostic -tool. +OPTIONS -Recognized arguments: +This module does not recognice any options. - +EXAMPLES + +#%PAM-1.0 +# +# If we don't have config entries for a service, the +# OTHER entries are used. To be secure, warn and deny +# access to everything. +other auth required pam_warn.so +other auth required pam_deny.so +other account required pam_warn.so +other account required pam_deny.so +other password required pam_warn.so +other password required pam_deny.so +other session required pam_warn.so +other session required pam_deny.so -module services provided: - auth _authenticate and _setcred (blank) - acct _acct_mgmt [mapped to _authenticate] - session _open_session and - _close_session [mapped to _authenticate ] - password _chauthtok [mapped to _authenticate] +AUTHOR +pam_warn was written by Andrew G. Morgan . -Andrew Morgan -1996/11/14 diff --git a/modules/pam_warn/README.xml b/modules/pam_warn/README.xml new file mode 100644 index 00000000..4367c28f --- /dev/null +++ b/modules/pam_warn/README.xml @@ -0,0 +1,41 @@ + + +--> +]> + +
+ + + + + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" + href="pam_warn.8.xml" xpointer='xpointer(//refnamediv[@id = "pam_warn-name"]/*)'/> + + + + +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
diff --git a/modules/pam_warn/pam_warn.8 b/modules/pam_warn/pam_warn.8 new file mode 100644 index 00000000..4e2c67c5 --- /dev/null +++ b/modules/pam_warn/pam_warn.8 @@ -0,0 +1,67 @@ +.\" Title: pam_warn +.\" Author: +.\" Generator: DocBook XSL Stylesheets v1.70.1 +.\" Date: 06/09/2006 +.\" Manual: Linux\-PAM Manual +.\" Source: Linux\-PAM Manual +.\" +.TH "PAM_WARN" "8" "06/09/2006" "Linux\-PAM Manual" "Linux\-PAM Manual" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" +pam_warn \- PAM module which logs all PAM items if called +.SH "SYNOPSIS" +.HP 12 +\fBpam_warn.so\fR +.SH "DESCRIPTION" +.PP +pam_warn is a PAM module that logs the service, terminal, user, remote user and remote host to +\fBsyslog\fR(3). The items are not probed for, but instead obtained from the standard PAM items. The module always returns +\fBPAM_IGNORE\fR, indicating that it does not want to affect the authentication process. +.SH "OPTIONS" +.PP +This module does not recognice any options. +.SH "MODULE SERVICES PROVIDED" +.PP +The services +\fBauth\fR, +\fBaccount\fR, +\fBpassword\fR +and +\fBsession\fR +are supported. +.SH "RETURN VALUES" +.TP 3n +PAM_IGNORE +This module always returns PAM_IGNORE. +.SH "EXAMPLES" +.sp +.RS 3n +.nf +#%PAM\-1.0 +# +# If we don't have config entries for a service, the +# OTHER entries are used. To be secure, warn and deny +# access to everything. +other auth required pam_warn.so +other auth required pam_deny.so +other account required pam_warn.so +other account required pam_deny.so +other password required pam_warn.so +other password required pam_deny.so +other session required pam_warn.so +other session required pam_deny.so + +.fi +.RE +.SH "SEE ALSO" +.PP + +\fBpam.conf\fR(5), +\fBpam.d\fR(8), +\fBpam\fR(8) +.SH "AUTHOR" +.PP +pam_warn was written by Andrew G. Morgan . diff --git a/modules/pam_warn/pam_warn.8.xml b/modules/pam_warn/pam_warn.8.xml new file mode 100644 index 00000000..1aa70f59 --- /dev/null +++ b/modules/pam_warn/pam_warn.8.xml @@ -0,0 +1,104 @@ + + + + + + + pam_warn + 8 + Linux-PAM Manual + + + pam_warn + PAM module which logs all PAM items if called + + + + pam_warn.so + + + + + DESCRIPTION + + pam_warn is a PAM module that logs the service, terminal, user, + remote user and remote host to + + syslog3 + . The items are not probed for, but instead obtained + from the standard PAM items. The module always returns + PAM_IGNORE, indicating that it + does not want to affect the authentication process. + + + + + OPTIONS + This module does not recognice any options. + + + + MODULE SERVICES PROVIDED + + The services , , + and are supported. + + + + + RETURN VALUES + + + PAM_IGNORE + + + This module always returns PAM_IGNORE. + + + + + + + + EXAMPLES + +#%PAM-1.0 +# +# If we don't have config entries for a service, the +# OTHER entries are used. To be secure, warn and deny +# access to everything. +other auth required pam_warn.so +other auth required pam_deny.so +other account required pam_warn.so +other account required pam_deny.so +other password required pam_warn.so +other password required pam_deny.so +other session required pam_warn.so +other session required pam_deny.so + + + + + SEE ALSO + + + pam.conf5 + , + + pam.d8 + , + + pam8 + + + + + + AUTHOR + + pam_warn was written by Andrew G. Morgan <morgan@kernel.org>. + + + + -- cgit v1.2.3