From e3f6e6a5f97e3bcaa6dcf3e23f2e2f796ac23ffd Mon Sep 17 00:00:00 2001
From: Bruce Dubbs <bdubbs@linuxfromscratch.org>
Date: Thu, 2 Nov 2023 19:39:56 -0500
Subject: [PATCH] Add a warning when updating shadow. The shadow installation
 procedure overwrites many files in /etc/pam.d/ which will render system login
 and su commands (among others) inoperative.

This update adds a warning at the beginning of the build instructions
so it will be hard to miss.
---
 postlfs/security/shadow.xml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/postlfs/security/shadow.xml b/postlfs/security/shadow.xml
index fab6046f6a..52068741f0 100644
--- a/postlfs/security/shadow.xml
+++ b/postlfs/security/shadow.xml
@@ -122,6 +122,15 @@
 <screen role="nodump"><userinput>sed -i 's@DICTPATH.*@DICTPATH\t/lib/cracklib/pw_dict@' etc/login.defs</userinput></screen>
     </important>
 
+    <warning>
+      <para>
+        If reinstalling shadow for a version update, be sure to 
+        reaccomplish the Linux-PAM configuration below.  The installation
+        of shadow overwrites many of the files in 
+        <filename class="directory">/etc/pam.d/</filename>.
+      </para>
+    </warning>
+
     <para>
       Reinstall <application>Shadow</application> by running the following
       commands: