util-linux/login-utils/nologin.8

84 lines
1.8 KiB
Groff

.TH NOLOGIN 8 "November 2019" "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
.IR /etc/nologin.txt exists ,
.B nologin
displays its contents to the
user instead of the default message.
.PP
The exit status returned by
.B nologin
is always 1.
.SH OPTIONS
\fB\-c\fR, \fB\-\-command\fR \fIcommand\fR
.br
\fB\-\-init-file\fR
.br
\fB\-i\fR \fB\-\-interactive\fR
.br
\fB\-\-init-file\fR \fIfile\fR
.br
\fB\-i\fR, \fB\-\-interactive\fR
.br
\fB\-l\fR, \fB\-\-login\fR
.br
\fB\-\-noprofile\fR
.br
\fB\-\-norc\fR
.br
\fB\-\-posix\fR
.br
\fB\-\-rcfile\fR \fIfile\fR
.br
\fB\-r\fR, \fB\-\-restricted\fR
.IP
These shell command-line options are ignored to avoid nologin error.
.IP "\fB\-h\fR, \fB\-\-help\fR"
Display help text and exit.
.IP "\fB\-V\fR, \fB\-\-version\fR"
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
.I /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
.I /var/run/nologin
or the
.I /etc/nologin
file.
.SH HISTORY
The
.B nologin
command appeared in 4.4BSD.
.SH AUTHORS
.UR kzak@redhat.com
Karel Zak
.UE
.SH SEE ALSO
.BR login (1),
.BR passwd (5),
.BR pam_nologin (8)
.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 .