Blame SOURCES/0090-lslogins-man-explain-password-statuses.patch

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