1
0
mirror of https://git.FreeBSD.org/src.git synced 2024-10-20 02:38:43 +00:00

Document the exit status and the stdout message of nologin(8)

Reviewed by:	debdrup (earlier version)
MFC after:	2 weeks
Differential Revision:	https://reviews.freebsd.org/D24196
This commit is contained in:
Mateusz Piotrowski 2020-04-15 13:13:46 +00:00
parent 0f3bf68212
commit 6f2b877647
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=359967

View File

@ -28,7 +28,7 @@
.\" @(#)nologin.8 8.1 (Berkeley) 6/19/93
.\" $FreeBSD$
.\"
.Dd June 19, 1993
.Dd April 15, 2020
.Dt NOLOGIN 8
.Os
.Sh NAME
@ -39,14 +39,31 @@
.Sh DESCRIPTION
The
.Nm
utility displays a message that an account is not available and
exits non-zero.
It is intended as a replacement shell field for accounts that
is intended as a replacement shell field for accounts that
have been disabled.
.Pp
When executed,
.Nm
first writes about the login attempt to
.Xr syslog 3
and then a displays a message that an account is not available.
.Pp
To disable all logins,
investigate
.Xr nologin 5 .
.Sh EXIT STATUS
The
.Nm
utility always exits non-zero.
.Sh EXAMPLES
Here is a demonstration of executing
.Nm :
.Bd -literal -offset 4n
$ nologin
This account is currently not available.
$ tail -n 1 /var/log/messages
Mar 30 21:53:07 example.org nologin[65992]: Attempted login by beastie on /dev/pts/18
.Ed
.Sh SEE ALSO
.Xr login 1 ,
.Xr nologin 5