From deda060dfbfb989de28235617fc3a9149aaee1e3 Mon Sep 17 00:00:00 2001 From: Thorsten Kukuk Date: Tue, 6 Jun 2006 16:03:10 +0000 Subject: Relevant BUGIDs: Purpose of commit: new feature Commit summary: --------------- 2006-06-06 Thorsten Kukuk * modules/pam_shells/Makefile.am: Include Make.xml.rules. * modules/pam_shells/pam_shells.8.xml: New. * modules/pam_shells/pam_shells.8: New, generated from xml file. * modules/pam_shells/README.xml: New. * modules/pam_shells/README: Regenerated from xml file. --- ChangeLog | 8 +++ NEWS | 2 +- modules/pam_shells/Makefile.am | 12 +++- modules/pam_shells/README | 29 ++++++--- modules/pam_shells/README.xml | 41 +++++++++++++ modules/pam_shells/pam_shells.8 | 59 ++++++++++++++++++ modules/pam_shells/pam_shells.8.xml | 117 ++++++++++++++++++++++++++++++++++++ 7 files changed, 259 insertions(+), 9 deletions(-) create mode 100644 modules/pam_shells/README.xml create mode 100644 modules/pam_shells/pam_shells.8 create mode 100644 modules/pam_shells/pam_shells.8.xml diff --git a/ChangeLog b/ChangeLog index 67555b28..88dc40a0 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2006-06-06 Thorsten Kukuk + + * modules/pam_shells/Makefile.am: Include Make.xml.rules. + * modules/pam_shells/pam_shells.8.xml: New. + * modules/pam_shells/pam_shells.8: New, generated from xml file. + * modules/pam_shells/README.xml: New. + * modules/pam_shells/README: Regenerated from xml file. + 2006-06-06 Thorsten Kukuk * libpam/include/security/pam_malloc.h: Add missing license diff --git a/NEWS b/NEWS index c68e0865..fa5cd79c 100644 --- a/NEWS +++ b/NEWS @@ -6,7 +6,7 @@ Linux-PAM NEWS -- history of user-visible changes. * Add manual page for pam_mkhomedir, pam_umask, pam_filter, pam_issue, pam_ftp, pam_group, pam_lastlog, pam_listfile, pam_localuser, pam_mail, pam_motd, pam_nologin, pam_permit, - pam_rootok, pam_securetty + pam_rootok, pam_securetty, pam_shells Release 0.99.4.0 diff --git a/modules/pam_shells/Makefile.am b/modules/pam_shells/Makefile.am index 06e1421b..03ac8b15 100644 --- a/modules/pam_shells/Makefile.am +++ b/modules/pam_shells/Makefile.am @@ -4,7 +4,10 @@ CLEANFILES = *~ -EXTRA_DIST = README tst-pam_shells +EXTRA_DIST = README $(MANS) $(XMLS) tst-pam_shells + +man_MANS = pam_shells.8 +XMLS = README.xml pam_shells.8.xml TESTS = tst-pam_shells @@ -19,3 +22,10 @@ if HAVE_VERSIONING endif securelib_LTLIBRARIES = pam_shells.la + +if ENABLE_REGENERATE_MAN +noinst_DATA = README +README: pam_shells.8.xml +-include $(top_srcdir)/Make.xml.rules +endif + diff --git a/modules/pam_shells/README b/modules/pam_shells/README index aa63a827..38e6484c 100644 --- a/modules/pam_shells/README +++ b/modules/pam_shells/README @@ -1,9 +1,24 @@ -pam_shells: - Authentication is granted if the users shell is listed in - /etc/shells. +pam_shells — PAM module to check for valid login shell - Also checks to make sure that /etc/shells is a plain - file and not world writable. +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + +DESCRIPTION + +pam_shells is a PAM module that only allows access to the system if the users +shell is listed in /etc/shells. + +It also checks if /etc/shells is a plain file and not world writable. + +OPTIONS + +This module does not recognice any options. + +EXAMPLES + +auth required pam_shells.so + + +AUTHOR + +pam_shells was written by Erik Troan . - - Erik Troan , Red Hat Software. - August 5, 1996. diff --git a/modules/pam_shells/README.xml b/modules/pam_shells/README.xml new file mode 100644 index 00000000..154b97b5 --- /dev/null +++ b/modules/pam_shells/README.xml @@ -0,0 +1,41 @@ + + +--> +]> + +
+ + + + + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" + href="pam_shells.8.xml" xpointer='xpointer(//refnamediv[@id = "pam_shells-name"]/*)'/> + + + + +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
diff --git a/modules/pam_shells/pam_shells.8 b/modules/pam_shells/pam_shells.8 new file mode 100644 index 00000000..f41a1ed4 --- /dev/null +++ b/modules/pam_shells/pam_shells.8 @@ -0,0 +1,59 @@ +.\" ** You probably do not want to edit this file directly ** +.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1). +.\" Instead of manually editing it, you probably should edit the DocBook XML +.\" source for it and then use the DocBook XSL Stylesheets to regenerate it. +.TH "PAM_SHELLS" "8" "06/06/2006" "Linux\-PAM Manual" "Linux\-PAM Manual" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" +pam_shells \- PAM module to check for valid login shell +.SH "SYNOPSIS" +.HP 14 +\fBpam_shells.so\fR +.SH "DESCRIPTION" +.PP +pam_shells is a PAM module that only allows access to the system if the users shell is listed in +\fI/etc/shells\fR. +.PP +It also checks if +\fI/etc/shells\fR +is a plain file and not world writable. +.SH "OPTIONS" +.PP +This module does not recognice any options. +.SH "MODULE SERVICES PROVIDED" +.PP +The services +\fBauth\fR +and +\fBaccount\fR +are supported. +.SH "RETURN VALUES" +.TP +PAM_AUTH_ERR +Access to the system was denied. +.TP +PAM_SUCCESS +The users login shell was listed as valid shell in +\fI/etc/shells\fR. +.TP +PAM_SERVICE_ERR +The module was not able to get the name of the user. +.SH "EXAMPLES" +.PP +.nf +auth required pam_shells.so + +.fi +.sp +.SH "SEE ALSO" +.PP +\fBshells\fR(5), +\fBpam.conf\fR(5), +\fBpam.d\fR(8), +\fBpam\fR(8) +.SH "AUTHOR" +.PP +pam_shells was written by Erik Troan . diff --git a/modules/pam_shells/pam_shells.8.xml b/modules/pam_shells/pam_shells.8.xml new file mode 100644 index 00000000..604e3572 --- /dev/null +++ b/modules/pam_shells/pam_shells.8.xml @@ -0,0 +1,117 @@ + + + + + + + pam_shells + 8 + Linux-PAM Manual + + + + pam_shells + PAM module to check for valid login shell + + + + + pam_shells.so + + + + + + DESCRIPTION + + + pam_shells is a PAM module that only allows access to the + system if the users shell is listed in /etc/shells. + + + It also checks if /etc/shells is a plain + file and not world writable. + + + + + + OPTIONS + This module does not recognice any options. + + + + MODULE SERVICES PROVIDED + + The services and + are supported. + + + + + RETURN VALUES + + + PAM_AUTH_ERR + + + Access to the system was denied. + + + + + PAM_SUCCESS + + + The users login shell was listed as valid shell in + /etc/shells. + + + + + PAM_SERVICE_ERR + + + The module was not able to get the name of the user. + + + + + + + + EXAMPLES + + +auth required pam_shells.so + + + + + + SEE ALSO + + + shells5 + , + + pam.conf5 + , + + pam.d8 + , + + pam8 + + + + + + AUTHOR + + pam_shells was written by Erik Troan <ewt@redhat.com>. + + + + -- cgit v1.2.3