diff options
Diffstat (limited to 'login-utils/nologin.8')
-rw-r--r-- | login-utils/nologin.8 | 53 |
1 files changed, 53 insertions, 0 deletions
diff --git a/login-utils/nologin.8 b/login-utils/nologin.8 new file mode 100644 index 000000000..b4e10704e --- /dev/null +++ b/login-utils/nologin.8 @@ -0,0 +1,53 @@ +.\" -*- nroff -*- +.TH NOLOGIN 8 "September 2013" "util-linux" "System Administration" +.SH NAME +nologin \- politely refuse a login +.SH SYNOPSIS +.B nologin +.RB [ \-V ] +.RB [ \-h ] +.SH DESCRIPTION +.B nologin +displays a message that an account is not available and exits non-zero. It is +intended as a replacement shell field to deny login access to account. +.PP +If the file /etc/nologin.txt exists, nologin displays its contents to the +user instead of the default message. +.PP +The exit code returned by +.B nologin +is always 1. +.PP +.SH OPTIONS +.IP "\fB\-h, \-\-help\fP" +Print help and exit. +.IP "\fB-V, \-\-version" +Print version and exit. +.SH NOTES +.B nologin +is per-account way to disable login (usually used for system accounts like http or ftp). +.BR nologin (8) +uses /etc/nologin.txt as optional source for non-default message, the login +access is always refused independently on the file. +.PP +.BR pam_nologin (8) +PAM module usually prevents all non-root users from logging into the system. +.BR pam_nologin (8) +functionality is controled by /var/run/nologin or /etc/nologin file. +.SH AUTHORS +.UR kzak@redhat.com +Karel Zak +.UE +.SH SEE ALSO +.BR login (1), +.BR passwd (5), +.BR pam_nologin (8) +.SH HISTORY +The +.B nologin +command appeared in 4.4BSD. +.SH AVAILABILITY +The nologin command is part of the util-linux package and is available from +.UR ftp://\:ftp.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ +Linux Kernel Archive +.UE . |