pam_nologin (8)
Leading comments
Title: pam_nologin
Author: [see the "AUTHOR" section]
Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
Date: 09/19/2013
Manual: Linux-PAM Manual
Source: Linux-PAM Manual
Language: English
NAME
pam_nologin - Prevent non-root users from loginSYNOPSIS
- pam_nologin.so [file=/path/nologin] [successok]
DESCRIPTION
OPTIONS
file=/path/nologin
- Use this file instead the default /var/run/nologin or /etc/nologin.
successok
- Return PAM_SUCCESS if no file exists, the default is PAM_IGNORE.
MODULE TYPES PROVIDED
The auth and acct module types are provided.
RETURN VALUES
PAM_AUTH_ERR
- The user is not root and /etc/nologin exists, so the user is not permitted to log in.
PAM_BUF_ERR
- Memory buffer error.
PAM_IGNORE
- This is the default return value.
PAM_SUCCESS
- Success: either the user is root or the nologin file does not exist.
PAM_USER_UNKNOWN
- User not known to the underlying authentication module.
EXAMPLES
The suggested usage for /etc/pam.d/login is:
-
auth required pam_nologin.so
NOTES
In order to make this module effective, all login methods should be secured by it. It should be used as a required method listed before any sufficient methods in order to get standard Unix nologin semantics. Note, the use of successok module argument causes the module to return PAM_SUCCESS and as such would break such a configuration - failing sufficient modules would lead to a successful login because the nologin module succeeded.
SEE ALSO
nologin(5), pam.conf(5), pam.d(5), pam(7)
AUTHOR
pam_nologin was written by Michael K. Johnson <johnsonm@redhat.com>.