]> git.ipfire.org Git - thirdparty/util-linux.git/blame - login-utils/nologin.8
scriptreplay: cleanup usage()
[thirdparty/util-linux.git] / login-utils / nologin.8
CommitLineData
88407b93
KZ
1.TH NOLOGIN 8 "September 2013" "util-linux" "System Administration"
2.SH NAME
3nologin \- politely refuse a login
4.SH SYNOPSIS
5.B nologin
6.RB [ \-V ]
7.RB [ \-h ]
8.SH DESCRIPTION
9.B nologin
10displays a message that an account is not available and exits non-zero. It is
fd2e45b7 11intended as a replacement shell field to deny login access to an account.
88407b93 12.PP
3a60b1c2 13If the file /etc/nologin.txt exists, nologin displays its contents to the
88407b93
KZ
14user instead of the default message.
15.PP
16The exit code returned by
17.B nologin
18is always 1.
19.PP
20.SH OPTIONS
21.IP "\fB\-h, \-\-help\fP"
b4362b6f 22Display help text and exit.
88407b93 23.IP "\fB-V, \-\-version"
b4362b6f 24Display version information and exit.
88407b93
KZ
25.SH NOTES
26.B nologin
fd2e45b7 27is a per-account way to disable login (usually used for system accounts like http or ftp).
88407b93 28.BR nologin (8)
fd2e45b7
OO
29uses /etc/nologin.txt as an optional source for a non-default message, the login
30access is always refused independently of the file.
88407b93
KZ
31.PP
32.BR pam_nologin (8)
33PAM module usually prevents all non-root users from logging into the system.
34.BR pam_nologin (8)
fd2e45b7 35functionality is controlled by /var/run/nologin or the /etc/nologin file.
88407b93
KZ
36.SH AUTHORS
37.UR kzak@redhat.com
38Karel Zak
39.UE
40.SH SEE ALSO
41.BR login (1),
42.BR passwd (5),
43.BR pam_nologin (8)
44.SH HISTORY
45The
46.B nologin
47command appeared in 4.4BSD.
48.SH AVAILABILITY
49The nologin command is part of the util-linux package and is available from
d673b74e 50.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
88407b93
KZ
51Linux Kernel Archive
52.UE .