From 9a611ad9d88dfe3950889277881aa2057c9429d3 Mon Sep 17 00:00:00 2001 From: Thorsten Kukuk Date: Tue, 30 May 2006 07:48:36 +0000 Subject: Relevant BUGIDs: Purpose of commit: new feature Commit summary: --------------- 2006-05-30 Thorsten Kukuk * modules/pam_umask/Makefile.am: Include Make.xml.rules. * modules/pam_umask/pam_umask.8.xml: New. * modules/pam_umask/pam_umask.8: New, generated from xml file. * modules/pam_umask/README.xml: New. * modules/pam_umask/README: Regenerated from xml file. --- ChangeLog | 8 ++ NEWS | 2 +- modules/pam_umask/Makefile.am | 13 ++- modules/pam_umask/README | 66 +++++++++--- modules/pam_umask/README.xml | 41 ++++++++ modules/pam_umask/pam_umask.8 | 85 ++++++++++++++++ modules/pam_umask/pam_umask.8.xml | 208 ++++++++++++++++++++++++++++++++++++++ 7 files changed, 408 insertions(+), 15 deletions(-) create mode 100644 modules/pam_umask/README.xml create mode 100644 modules/pam_umask/pam_umask.8 create mode 100644 modules/pam_umask/pam_umask.8.xml diff --git a/ChangeLog b/ChangeLog index 6a402b37..c635f968 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,11 @@ +2006-05-30 Thorsten Kukuk + + * modules/pam_umask/Makefile.am: Include Make.xml.rules. + * modules/pam_umask/pam_umask.8.xml: New. + * modules/pam_umask/pam_umask.8: New, generated from xml file. + * modules/pam_umask/README.xml: New. + * modules/pam_umask/README: Regenerated from xml file. + 2006-05-29 Thorsten Kukuk * modules/pam_mkhomedir/Makefile.am: Include Make.xml.rules. diff --git a/NEWS b/NEWS index 1b91099d..5c55617f 100644 --- a/NEWS +++ b/NEWS @@ -3,7 +3,7 @@ Linux-PAM NEWS -- history of user-visible changes. * pam_tally: Fix support for large UIDs * Fixed all problems found by Coverity -* pam_mkhomedir: Add manual page +* Add manual page for pam_mkhomedir, pam_umask Release 0.99.4.0 diff --git a/modules/pam_umask/Makefile.am b/modules/pam_umask/Makefile.am index dc2a3a3b..56fa63b4 100644 --- a/modules/pam_umask/Makefile.am +++ b/modules/pam_umask/Makefile.am @@ -4,7 +4,11 @@ CLEANFILES = *~ -EXTRA_DIST = README tst-pam_umask +EXTRA_DIST = README $(MANS) $(XMLS) tst-pam_umask + +man_MANS = pam_umask.8 + +XMLS = README.xml pam_umask.8.xml TESTS = tst-pam_umask @@ -19,3 +23,10 @@ if HAVE_VERSIONING endif securelib_LTLIBRARIES = pam_umask.la + +if ENABLE_REGENERATE_MAN +noinst_DATA = README +README: pam_umask.8.xml +-include $(top_srcdir)/Make.xml.rules +endif + diff --git a/modules/pam_umask/README b/modules/pam_umask/README index 3fd4f7f0..2a4f2641 100644 --- a/modules/pam_umask/README +++ b/modules/pam_umask/README @@ -1,14 +1,54 @@ -This is the README for pam_umask --------------------------------- - -pam_umask sets the set the file mode creation mask of the current -environment. It tries to get the umask value from the following -files in the following priority: - -- umask= argument -- umask= entry of the users GECOS field -- pri= entry of the users GECOS field -- ulimit= entry of the users GECOS field -- UMASK= entry from /etc/default/login -- UMASK entry from /etc/login.defs +pam_umask — PAM module to set the file mode creation mask + +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + +DESCRIPTION + +pam_umask is a PAM module to set the file mode creation mask of the current +environment. The umask affects the default permissions assigned to newly +created files. + +The PAM module tries to get the umask value from the following places in the +following order: + + ● umask= argument + + ● umask= entry of the users GECOS field + + ● pri= entry of the users GECOS field + + ● ulimit= entry of the users GECOS field + + ● UMASK= entry from /etc/default/login + + ● UMASK entry from /etc/login.defs + +OPTIONS + +debug + + Print debug information. + +usergroups + + If the user is not root, and the user ID is equal to the group ID, and the + username is the same as primary group name, the umask group bits are set to + be the same as owner bits (examples: 022 -> 002, 077 -> 007). + +umask=mask + + Sets the calling process's file mode creation mask (umask) to mask & 0777. + The value is interpreted as Octal. + +EXAMPLES + +Add the following line to /etc/pam.d/login to set the user specific umask at +login: + + session optional pam_umask.so umask=0022 + + +AUTHOR + +pam_umask was written by Thorsten Kukuk . diff --git a/modules/pam_umask/README.xml b/modules/pam_umask/README.xml new file mode 100644 index 00000000..9afbe543 --- /dev/null +++ b/modules/pam_umask/README.xml @@ -0,0 +1,41 @@ + + +--> +]> + +
+ + + + + <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" + href="pam_umask.8.xml" xpointer='xpointer(//refnamediv[@id = "pam_umask-name"]/*)'/> + + + + +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
diff --git a/modules/pam_umask/pam_umask.8 b/modules/pam_umask/pam_umask.8 new file mode 100644 index 00000000..8e0cbb7c --- /dev/null +++ b/modules/pam_umask/pam_umask.8 @@ -0,0 +1,85 @@ +.\" ** 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_UMASK" "8" "05/30/2006" "Linux\-PAM Manual" "Linux\-PAM Manual" +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.SH "NAME" +pam_umask \- PAM module to set the file mode creation mask +.SH "SYNOPSIS" +.HP 13 +\fBpam_umask.so\fR [debug] [usergroups] [umask=\fImask\fR] +.SH "DESCRIPTION" +.PP +pam_umask is a PAM module to set the file mode creation mask of the current environment. The umask affects the default permissions assigned to newly created files. +.PP +The PAM module tries to get the umask value from the following places in the following order: +.TP 3 +\(bu +umask= argument +.TP +\(bu +umask= entry of the users GECOS field +.TP +\(bu +pri= entry of the users GECOS field +.TP +\(bu +ulimit= entry of the users GECOS field +.TP +\(bu +UMASK= entry from /etc/default/login +.TP +\(bu +UMASK entry from /etc/login.defs +.SH "OPTIONS" +.PP +.TP +\fBdebug\fR +Print debug information. +.TP +\fBusergroups\fR +If the user is not root, and the user ID is equal to the group ID, and the username is the same as primary group name, the umask group bits are set to be the same as owner bits (examples: 022 \-> 002, 077 \-> 007). +.TP +\fBumask=\fR\fB\fImask\fR\fR +Sets the calling process's file mode creation mask (umask) to +\fBmask\fR +& 0777. The value is interpreted as Octal. +.SH "MODULE SERVICES PROVIDED" +.PP +Only the +\fBsession\fR +service is supported. +.SH "RETURN VALUES" +.PP +.TP +PAM_SUCCESS +The new umask was set successfull. +.TP +PAM_SERVICE_ERR +No username was given. +.TP +PAM_USER_UNKNOWN +User not known. +.SH "EXAMPLES" +.PP +Add the following line to +\fI/etc/pam.d/login\fR +to set the user specific umask at login: +.sp +.nf + session optional pam_umask.so umask=0022 + +.fi +.sp +.SH "SEE ALSO" +.PP +\fBpam.conf\fR(5), +\fBpam.d\fR(8), +\fBpam\fR(8) +.SH "AUTHOR" +.PP +pam_umask was written by Thorsten Kukuk . diff --git a/modules/pam_umask/pam_umask.8.xml b/modules/pam_umask/pam_umask.8.xml new file mode 100644 index 00000000..4edbb18e --- /dev/null +++ b/modules/pam_umask/pam_umask.8.xml @@ -0,0 +1,208 @@ + + + + + + + pam_umask + 8 + Linux-PAM Manual + + + + pam_umask + PAM module to set the file mode creation mask + + + + + pam_umask.so + + debug + + + usergroups + + + umask=mask + + + + + + + DESCRIPTION + + + pam_umask is a PAM module to set the file mode creation mask + of the current environment. The umask affects the default + permissions assigned to newly created files. + + + The PAM module tries to get the umask value from the + following places in the following order: + + + + umask= argument + + + + + umask= entry of the users GECOS field + + + + + pri= entry of the users GECOS field + + + + + ulimit= entry of the users GECOS field + + + + + UMASK= entry from /etc/default/login + + + + + UMASK entry from /etc/login.defs + + + + + + + + + + OPTIONS + + + + + + + + + + Print debug information. + + + + + + + + + + + If the user is not root, and the user ID is equal to the + group ID, and the username is the same as primary group name, + the umask group bits are set to be the same as + owner bits (examples: 022 -> 002, 077 -> 007). + + + + + + + + + + + Sets the calling process's file mode creation mask (umask) + to & 0777. The value is interpreted + as Octal. + + + + + + + + + + + MODULE SERVICES PROVIDED + + Only the service is supported. + + + + + RETURN VALUES + + + + + PAM_SUCCESS + + + The new umask was set successfull. + + + + + + PAM_SERVICE_ERR + + + No username was given. + + + + + + PAM_USER_UNKNOWN + + + User not known. + + + + + + + + + + EXAMPLES + + Add the following line to /etc/pam.d/login to + set the user specific umask at login: + + session optional pam_umask.so umask=0022 + + + + + + SEE ALSO + + + pam.conf5 + , + + pam.d8 + , + + pam8 + + + + + + AUTHOR + + pam_umask was written by Thorsten Kukuk <kukuk@thkukuk.de>. + + + + + -- cgit v1.2.3