summaryrefslogtreecommitdiff
path: root/cifscreds.pod
diff options
context:
space:
mode:
authorJeff Layton <jlayton@samba.org>2012-07-20 10:30:50 -0400
committerJeff Layton <jlayton@samba.org>2012-07-20 10:30:50 -0400
commitc44d290f3b5f221e7617bdb409bb8e44ceafef3e (patch)
tree4b54fd2d23627313532fc0f3995fd3192d94bd04 /cifscreds.pod
parent877701f3cc23df3cb2a293c060bdbf05a87bff6a (diff)
downloadcifs-utils-c44d290f3b5f221e7617bdb409bb8e44ceafef3e.tar.gz
cifs-utils-c44d290f3b5f221e7617bdb409bb8e44ceafef3e.tar.bz2
cifs-utils-c44d290f3b5f221e7617bdb409bb8e44ceafef3e.zip
cifscreds: add a check and warnings for session keyring problems
Many distros do not call into pam_keyinit to set up the session keyring properly at login time. When cifscreds add is used in such a session, the kernel will spawn a new session keyring in which to install the credentials. That keyring will then go away once the cifscreds process exits. Check for this situation by looking to see if the session and user-session keyrings are the same. Throw a warning if so, and add some verbiage to the cifscreds manpage that explains the issue. Also, if the session keyring can't be queried for any reason, then cause the program to error out. Acked-by: David Howells <dhowells@redhat.com> Reported-by: Milan Knížek <knizek.confy@gmail.com> Signed-off-by: Jeff Layton <jlayton@samba.org>
Diffstat (limited to 'cifscreds.pod')
-rw-r--r--cifscreds.pod8
1 files changed, 8 insertions, 0 deletions
diff --git a/cifscreds.pod b/cifscreds.pod
index 17e453f..c3bafb5 100644
--- a/cifscreds.pod
+++ b/cifscreds.pod
@@ -79,6 +79,14 @@ The cifscreds utility requires a kernel built with support for the
B<login> key type. That key type was added in v3.3 in mainline Linux
kernels.
+Since B<cifscreds> adds keys to the session keyring, it is highly
+recommended that one use B<pam_keyinit> to ensure that a session keyring
+is established at login time.
+
+=head1 SEE ALSO
+
+pam_keyinit(8)
+
=head1 AUTHORS
The cifscreds program was originally developed by Igor Druzhinin