docs: add list of expected PAM config files

Signed-off-by: Karel Zak <kzak@redhat.com>

diff --git a/Documentation/PAM-configuration.txt b/Documentation/PAM-configuration.txt
new file mode 100644 (file)
index 0000000..046a177
--- /dev/null
+++ b/Documentation/PAM-configuration.txt
@@ -0,0 +1,31 @@
+
+ PAM configuration is very distribution specific. This is reason why upstream
+ util-linux package does not install any PAM config files.
+
+
+ Expected PAM config files:
+
+ login(1):
+    /etc/pam.d/remote - for -h command line option
+    /etc/pam.d/login  - regular login
+
+
+ su(1):
+    /etc/pam.d/su-l   - for --login command line option
+    /etc/pam.d/su     - regular su
+
+
+ runuser(1):
+    /etc/pam.d/runuser-l   - for --login command line option
+    /etc/pam.d/runuser     - regular su
+
+    Note that runuser requires only "session" setting (and for example
+    "auth sufficient pam_rootok.so" dummy line).
+
+
+ chfn(1):
+    /etc/pam.d/chfn
+
+
+ chsh(1):
+    /etc/pam.d/chsh