Relevant BUGIDs:

Purpose of commit: new feature

Commit summary:
---------------
        * modules/pam_keyinit/pam_keyinit.c: New module.
        * modules/pam_keyinit/pam_keyinit.8: New.
        * modules/pam_keyinit/pam_keyinit.8.xml: New.
        * modules/pam_keyinit/README: New.
        * modules/pam_keyinit/README.xml: New.
        * modules/pam_keyinit/Makefile.am: New.
        * modules/pam_keyinit/tst_pam_keyinit: New.
        * modules/Makefile.am: Added pam_keyinit.
        * configure.in: Added test for the key mgmt syscall.

1 files changed, 24 insertions, 0 deletions

diff --git a/modules/pam_keyinit/README b/modules/pam_keyinit/README
new file mode 100644
index 00000000..a27077b3
--- /dev/null
+++ b/modules/pam_keyinit/README
@@ -0,0 +1,24 @@
+# $Id$ -*- text -*-
+#
+
+This module makes sure the calling process has its own session keyring rather
+than using the default per-user session keyring.
+
+The following words may be supplied as arguments to the module through the PAM
+configuration scripts:
+
+ (*) "force"
+
+     This will cause the process's current session keyring to be replaced with
+     a new one. If this isn't supplied, a session keyring will only be created
+     if the process doesn't already have its own.
+
+ (*) "revoke"
+
+     If the module actually created a keyring, this will cause that keyring to
+     be revoked on session closure.
+
+ (*) "debug"
+
+     This will cause the module to write some debugging information to the
+     syslog.