From 069a5f19a22cf89e7fe04faedfb2a0ee22e2c871 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Love=20H=C3=B6rnquist=20=C3=85strand?= <lha@kth.se>
Date: Mon, 31 Oct 2005 16:07:23 +0000
Subject: [PATCH] Document that gss_krb5_import_ccache is copy by reference.

git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@16268 ec53bebd-3082-4978-b11e-865c3cabbd6b
---
 lib/gssapi/gss_acquire_cred.3      | 10 ++++++++++
 lib/gssapi/krb5/gss_acquire_cred.3 | 10 ++++++++++
 2 files changed, 20 insertions(+)

diff --git a/lib/gssapi/gss_acquire_cred.3 b/lib/gssapi/gss_acquire_cred.3
index 138ef9cee..5166b5cfe 100644
--- a/lib/gssapi/gss_acquire_cred.3
+++ b/lib/gssapi/gss_acquire_cred.3
@@ -623,6 +623,16 @@ The acceptor receives the delegated token in the last argument to
 .Fn gss_krb5_import_ccache
 will import the krb5 credentials into gss credential so it can be used
 withing GSS-API.
+The
+.Fa ccache
+is copied by reference and thus shared, so if the credential is destroyed
+with
+.Fa krb5_cc_destroy ,
+all users of thep
+.Fa gss_cred_id_t
+returned by
+.Fn gss_krb5_import_ccache
+will fail.
 .Pp
 .Fn gsskrb5_register_acceptor_identity
 sets the Kerberos 5 principal that the acceptor will use.
diff --git a/lib/gssapi/krb5/gss_acquire_cred.3 b/lib/gssapi/krb5/gss_acquire_cred.3
index 138ef9cee..5166b5cfe 100644
--- a/lib/gssapi/krb5/gss_acquire_cred.3
+++ b/lib/gssapi/krb5/gss_acquire_cred.3
@@ -623,6 +623,16 @@ The acceptor receives the delegated token in the last argument to
 .Fn gss_krb5_import_ccache
 will import the krb5 credentials into gss credential so it can be used
 withing GSS-API.
+The
+.Fa ccache
+is copied by reference and thus shared, so if the credential is destroyed
+with
+.Fa krb5_cc_destroy ,
+all users of thep
+.Fa gss_cred_id_t
+returned by
+.Fn gss_krb5_import_ccache
+will fail.
 .Pp
 .Fn gsskrb5_register_acceptor_identity
 sets the Kerberos 5 principal that the acceptor will use.