From 99c978b8a87f505f569c2290176a6352aea9257c Mon Sep 17 00:00:00 2001
From: Florian Fischer <florian.fischer@muhq.space>
Date: Sun, 28 Jul 2024 11:01:47 +0200
Subject: [PATCH] add man pages for passwd and shadow files

The manual pages are greatly inspired by the ones provided by
the shadow-utils upstream project https://github.com/shadow-maint/shadow.
---
 files/usr/share/man/passwd.man | 28 ++++++++++++++++++++++++++++
 files/usr/share/man/shadow.man | 22 ++++++++++++++++++++++
 2 files changed, 50 insertions(+)
 create mode 100644 files/usr/share/man/passwd.man
 create mode 100644 files/usr/share/man/shadow.man

diff --git a/files/usr/share/man/passwd.man b/files/usr/share/man/passwd.man
new file mode 100644
index 00000000..4cb60045
--- /dev/null
+++ b/files/usr/share/man/passwd.man
@@ -0,0 +1,28 @@
+NAME
+    passwd - the password file
+
+DESCRIPTION
+    /etc/passwd contains one line for each user account, with seven fields
+    delimited by colons (":").
+
+    These fields are:
+        *   login name
+        *   optional encrypted password
+        *   numerical user ID
+        *   numerical group ID
+        *   user name or comment field
+        *   user home directory
+        *   optional user command interpreter
+
+   If the password field is a lower-case "x", then the encrypted password is
+   actually stored in the shadow file instead; there must be a corresponding
+   line in the /etc/shadow file, or else the user account is invalid.
+
+   The home directory field provides the name of the initial working directory.
+   The login program uses this information to set the value of the $HOME
+   environmental variable.
+
+   The command interpreter field provides the name of the user's command
+   language interpreter, or the name of the initial program to execute.
+   The login program uses this information to set the value of the $SHELL
+   environmental variable.
diff --git a/files/usr/share/man/shadow.man b/files/usr/share/man/shadow.man
new file mode 100644
index 00000000..b61d0bcb
--- /dev/null
+++ b/files/usr/share/man/shadow.man
@@ -0,0 +1,22 @@
+NAME
+    shadow - shadowed password file
+
+DESCRIPTION
+    shadow is a file which contains the password information for the
+    system's accounts.
+
+    This file must not be readable by regular users if password security is to
+    be maintained.
+
+    Each line of this file contains 9 fields, separated by colons (“:”), in the
+    following order:
+
+        *   login name
+        *   encrypted password
+        *   date of last password change
+        *   minimum password age
+        *   maximum password age
+        *   password warning period
+        *   password inactivity period
+        *   account expiration date
+        *   reserved field