svn commit: r363554 - stable/12/usr.sbin/nologin

[Mateusz Piotrowski]

Author: 0mp (doc,ports committer)
Date: Sun Jul 26 10:04:02 2020
New Revision: 363554
URL: https://svnweb.freebsd.org/changeset/base/363554

Log:
  MFC 359967:
  
  Document the exit status and the stdout message of nologin(8)
  
  Reviewed by:	debdrup (earlier version)
  Differential Revision:	https://reviews.freebsd.org/D24196

Modified:
  stable/12/usr.sbin/nologin/nologin.8
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/usr.sbin/nologin/nologin.8
==============================================================================
--- stable/12/usr.sbin/nologin/nologin.8	Sun Jul 26 10:01:27 2020	(r363553)
+++ stable/12/usr.sbin/nologin/nologin.8	Sun Jul 26 10:04:02 2020	(r363554)
@@ -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