From 88407b93212275759e8a54f5d43f4cf7da67fcdf Mon Sep 17 00:00:00 2001 From: Karel Zak Date: Mon, 30 Sep 2013 13:36:26 +0200 Subject: nologin: add new command Currently it's maintained as distro specific (or people use impolite /bin/false way). Signed-off-by: Karel Zak --- login-utils/nologin.8 | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 login-utils/nologin.8 (limited to 'login-utils/nologin.8') 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 . -- cgit v1.2.3-55-g7522