From: Alejandro Colomar <alx@kernel.org>
Date: Tue, 31 Mar 2026 12:50:00 +0000 (+0200)
Subject: man/passwd.5.xml: CAVEATS: Add section
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=4a5ca8909a1ff123ace40a36e491e604e4f6f33e;p=thirdparty%2Fshadow.git

man/passwd.5.xml: CAVEATS: Add section

Document that when reading passwd(5), the C locale should be used.

Cc: Iker Pedrosa <ipedrosa@redhat.com>
Cc: Mantas Mikulėnas <grawity@gmail.com>
Cc: KhaelK-Praetorian <khael.kugler@praetorian.com>
Cc: Tobias Stoeckmann <tobias@stoeckmann.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>
---

diff --git a/man/passwd.5.xml b/man/passwd.5.xml
index c528e6977..37b136222 100644
--- a/man/passwd.5.xml
+++ b/man/passwd.5.xml
@@ -163,6 +163,20 @@
     </variablelist>
   </refsect1>
 
+  <refsect1 id='caveats'>
+    <title>CAVEATS</title>
+    <para>
+      Unprivileged users may write
+      arbitrary non-ASCII characters
+      in the GECOS field,
+      notably including C1 control characters.
+      When reading this file,
+      use the C locale.
+      Otherwise,
+      the contents may look different than they are.
+    </para>
+  </refsect1>
+
   <refsect1 id='see_also'>
     <title>SEE ALSO</title>
     <para>