summaryrefslogtreecommitdiffstats
path: root/login-utils/nologin.8
blob: ee59484430291aa647fc119d1f698abe1b8183c2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
.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 an 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"
Display help text and exit.
.IP "\fB-V, \-\-version"
Display version information and exit.
.SH NOTES
.B nologin
is a per-account way to disable login (usually used for system accounts like http or ftp).
.BR nologin (8)
uses /etc/nologin.txt as an optional source for a non-default message, the login
access is always refused independently of 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 controlled by /var/run/nologin or the /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 https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
Linux Kernel Archive
.UE .