summaryrefslogtreecommitdiff
path: root/cifscreds.1
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.1
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.1')
-rw-r--r--cifscreds.19
1 files changed, 8 insertions, 1 deletions
diff --git a/cifscreds.1 b/cifscreds.1
index 44a02a2..83afae6 100644
--- a/cifscreds.1
+++ b/cifscreds.1
@@ -124,7 +124,7 @@
.\" ========================================================================
.\"
.IX Title "CIFSCREDS 1"
-.TH CIFSCREDS 1 "2012-01-24" "" ""
+.TH CIFSCREDS 1 "2012-07-17" "" ""
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -186,6 +186,13 @@ different username.
The cifscreds utility requires a kernel built with support for the
\&\fBlogin\fR key type. That key type was added in v3.3 in mainline Linux
kernels.
+.PP
+Since \fBcifscreds\fR adds keys to the session keyring, it is highly
+recommended that one use \fBpam_keyinit\fR to ensure that a session keyring
+is established at login time.
+.SH "SEE ALSO"
+.IX Header "SEE ALSO"
+\&\fIpam_keyinit\fR\|(8)
.SH "AUTHORS"
.IX Header "AUTHORS"
The cifscreds program was originally developed by Igor Druzhinin