summaryrefslogtreecommitdiff
path: root/modules/pam_succeed_if
diff options
context:
space:
mode:
authorThorsten Kukuk <kukuk@thkukuk.de>2006-06-02 15:37:38 +0000
committerThorsten Kukuk <kukuk@thkukuk.de>2006-06-02 15:37:38 +0000
commitbad0ed8d159cb77466ed81a624355b1e80ead0dc (patch)
treec1115143eded6faa7e8fe0abc42fc50d4e28fe17 /modules/pam_succeed_if
parent29a98911d9cb5e9187c1afe4e161c6861fac4f2b (diff)
Relevant BUGIDs: 1427738
Purpose of commit: new feature/bugfix Commit summary: --------------- 2006-06-02 Thorsten Kukuk <kukuk@thkukuk.de> * doc/man/PAM.8: Regenerate with DocBook XSL Stylesheets v1.70.1. * doc/man/pam.3: Likewise. * doc/man/pam.conf.5: Likewise. * doc/man/pam_acct_mgmt.3: Likewise. * doc/man/pam_authenticate.3: Likewise. * doc/man/pam_chauthtok.3: Likewise. * doc/man/pam_close_session.3: Likewise. * doc/man/pam_conv.3: Likewise. * doc/man/pam_end.3: Likewise. * doc/man/pam_error.3: Likewise. * doc/man/pam_fail_delay.3: Likewise. * doc/man/pam_get_data.3: Likewise. * doc/man/pam_get_item.3: Likewise. * doc/man/pam_get_user.3: Likewise. * doc/man/pam_getenv.3: Likewise. * doc/man/pam_getenvlist.3: Likewise. * doc/man/pam_info.3: Likewise. * doc/man/pam_open_session.3: Likewise. * doc/man/pam_prompt.3: Likewise. * doc/man/pam_putenv.3: Likewise. * doc/man/pam_set_data.3: Likewise. * doc/man/pam_set_item.3: Likewise. * doc/man/pam_setcred.3: Likewise. * doc/man/pam_sm_acct_mgmt.3: Likewise. * doc/man/pam_start.3: Likewise. * doc/man/pam_strerror.3: Likewise. * doc/man/pam_syslog.3: Likewise. * modules/pam_access/access.conf.5: Likewise. * modules/pam_access/pam_access.8: Likewise. * modules/pam_cracklib/pam_cracklib.8: Likewise. * modules/pam_deny/pam_deny.8: Likewise. * modules/pam_echo/pam_echo.8: Likewise. * modules/pam_env/pam_env.8: Likewise. * modules/pam_env/pam_env.conf.5: Likewise. * modules/pam_exec/pam_exec.8: Likewise. * modules/pam_filter/pam_filter.8: Likewise. * modules/pam_ftp/pam_ftp.8: Likewise. * modules/pam_group/group.conf.5: Likewise. * modules/pam_group/pam_group.8: Likewise. * modules/pam_issue/pam_issue.8: Likewise. * modules/pam_lastlog/pam_lastlog.8: Likewise. * modules/pam_mkhomedir/pam_mkhomedir.8: Likewise. * modules/pam_succeed_if/pam_succeed_if.8: Likewise. * modules/pam_umask/pam_umask.8: Likewise. * modules/pam_unix/pam_unix_acct.c (pam_sm_acct_mgmt): Use dngettext if available [#1427738]. * configure.in: Check for dngettext [#1427738]. * po/*.po: Update to dngettext usage. * modules/pam_listfile/Makefile.am: Include Make.xml.rules. * modules/pam_listfile/pam_listfile.8.xml: New. * modules/pam_listfile/pam_listfile.8: New, generated from xml file. * modules/pam_listfile/README.xml: New. * modules/pam_listfile/README: Regenerated from xml file.
Diffstat (limited to 'modules/pam_succeed_if')
-rw-r--r--modules/pam_succeed_if/pam_succeed_if.859
1 files changed, 34 insertions, 25 deletions
diff --git a/modules/pam_succeed_if/pam_succeed_if.8 b/modules/pam_succeed_if/pam_succeed_if.8
index 70c4f8d2..3b63034e 100644
--- a/modules/pam_succeed_if/pam_succeed_if.8
+++ b/modules/pam_succeed_if/pam_succeed_if.8
@@ -1,8 +1,11 @@
-.\" ** 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_SUCCEED_IF" "8" "02/24/2006" "Linux\-PAM" "Linux\-PAM"
+.\" Title: pam_succeed_if
+.\" Author:
+.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
+.\" Date: 06/02/2006
+.\" Manual: Linux\-PAM
+.\" Source: Linux\-PAM
+.\"
+.TH "PAM_SUCCEED_IF" "8" "06/02/2006" "Linux\-PAM" "Linux\-PAM"
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
@@ -21,22 +24,23 @@ The module should be given one or more conditions as module arguments, and authe
.PP
The following
\fIflag\fRs are supported:
-.TP
+.TP 3n
\fBdebug\fR
Turns on debugging messages sent to syslog.
-.TP
+.TP 3n
\fBuse_uid\fR
Evaluate conditions using the account of the user whose UID the application is running under instead of the user being authenticated.
-.TP
+.TP 3n
\fBquiet\fR
Don't log failure or success to the system log.
-.TP
+.TP 3n
\fBquiet_fail\fR
Don't log failure to the system log.
-.TP
+.TP 3n
\fBquiet_success\fR
Don't log success to the system log.
.PP
+
\fICondition\fRs are three words: a field, a test, and a value to test for.
.PP
Available fields are
@@ -46,50 +50,50 @@ Available fields are
\fIshell\fR
and
\fIhome\fR:
-.TP
+.TP 3n
\fBfield < number\fR
Field has a value numerically less than number.
-.TP
+.TP 3n
\fBfield <= number\fR
Field has a value numerically less than or equal to number.
-.TP
+.TP 3n
\fBfield eq number\fR
Field has a value numerically less equal to number.
-.TP
+.TP 3n
\fBfield >= number\fR
Field has a value numerically greater than or equal to number.
-.TP
+.TP 3n
\fBfield > number\fR
Field has a value numerically greater than number.
-.TP
+.TP 3n
\fBfield ne number\fR
Field has a value numerically different from number.
-.TP
+.TP 3n
\fBfield = string\fR
Field exactly matches the given string.
-.TP
+.TP 3n
\fBfield != string\fR
Field does not match the given string.
-.TP
+.TP 3n
\fBfield =~ glob\fR
Field matches the given glob.
-.TP
+.TP 3n
\fBfield !~ glob\fR
Field does not match the given glob.
-.TP
+.TP 3n
\fBuser ingroup group\fR
User is in given group.
-.TP
+.TP 3n
\fBuser notingroup group\fR
User is not in given group.
.SH "RETURN VALUES"
-.TP
+.TP 3n
PAM_SUCCESS
The condition was true.
-.TP
+.TP 3n
PAM_AUTH_ERR
The condition was false.
-.TP
+.TP 3n
PAM_SERVICE_ERR
A service error occured or the arguments can't be parsed as numbers.
.SH "EXAMPLES"
@@ -97,22 +101,27 @@ A service error occured or the arguments can't be parsed as numbers.
To emulate the behaviour of
\fIpam_wheel\fR, except there is no fallback to group 0:
.sp
+.RS 3n
.nf
auth required pam_succeed_if.so quiet user ingroup wheel
.fi
+.RE
.sp
.PP
Given that the type matches, only loads the othermodule rule if the UID is over 500. Adjust the number after default to skip several rules.
.sp
+.RS 3n
.nf
type [default=1 success=ignore] pam_succeed_if.so quiet uid > 500
type required othermodule.so arguments...
.fi
+.RE
.sp
.SH "SEE ALSO"
.PP
+
\fBglob\fR(7),
\fBpam\fR(8)
.SH "AUTHOR"