f46785
From ea1ad5e7260c770b21e547702b1e0acef9e4854c Mon Sep 17 00:00:00 2001
f46785
From: Karel Zak <kzak@redhat.com>
f46785
Date: Thu, 2 Feb 2023 14:52:35 +0100
f46785
Subject: lslogins: (man) explain password statuses
f46785
f46785
Upstream: http://github.com/util-linux/util-linux/commit/95ea3dd4128b625ab12691229020ebc50d578e71
f46785
Upstream: http://github.com/util-linux/util-linux/commit/8001bffb03eda8d23d6a04a5dc1469cce932ae36
f46785
Addresses: https://bugzilla.redhat.com/show_bug.cgi?id=2159544
f46785
Signed-off-by: Karel Zak <kzak@redhat.com>
f46785
---
f46785
 login-utils/lslogins.1 | 18 ++++++++++++++++++
f46785
 1 file changed, 18 insertions(+)
f46785
f46785
diff --git a/login-utils/lslogins.1 b/login-utils/lslogins.1
f46785
index c831739d9..5c327caf5 100644
f46785
--- a/login-utils/lslogins.1
f46785
+++ b/login-utils/lslogins.1
f46785
@@ -116,6 +116,24 @@ Delimit user entries with a nul character, instead of a newline.
f46785
 
f46785
 .SH NOTES
f46785
 The default UID thresholds are read from /etc/login.defs.
f46785
+.SS "Password status"
f46785
+.sp
f46785
+Multiple fields describe password status.
f46785
+.sp
f46785
+\fB"Login by password disabled"\fP
f46785
+.RS 4
f46785
+\*(Aqyes\*(Aq means that there is no valid password. The password hash is missing, or the hash method is unknown or contains invalid chars.
f46785
+.RE
f46785
+.sp
f46785
+\fB"Password not required (empty)"\fP
f46785
+.RS 4
f46785
+The password is not set (hash is missing); this is common for locked system accounts. Not requiring a password does not mean the user can log\-in without a password. It depends on the password "lock" status.
f46785
+.RE
f46785
+.sp
f46785
+\fB"Password is locked"\fP
f46785
+.RS 4
f46785
+The password is prefixed by \*(Aq!!\*(Aq, and the user cannot login although the password is set or empty. This is common for new accounts without a set password.
f46785
+.RE
f46785
 
f46785
 .SH EXIT STATUS
f46785
 .TP
f46785
-- 
f46785
2.39.1
f46785