From b742a50cf7af331e31538a228a667ecf4dfcf4d7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Love=20H=C3=B6rnquist=20=C3=85strand?= <lha@kth.se>
Date: Wed, 26 Oct 2005 11:29:34 +0000
Subject: [PATCH] Document gss_krb5_import_ccache

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

diff --git a/lib/gssapi/gss_acquire_cred.3 b/lib/gssapi/gss_acquire_cred.3
index 412f94043..138ef9cee 100644
--- a/lib/gssapi/gss_acquire_cred.3
+++ b/lib/gssapi/gss_acquire_cred.3
@@ -1,4 +1,4 @@
-.\" Copyright (c) 2003 - 2004 Kungliga Tekniska Högskolan
+.\" Copyright (c) 2003 - 2005 Kungliga Tekniska Högskolan
 .\" (Royal Institute of Technology, Stockholm, Sweden).
 .\" All rights reserved.
 .\"
@@ -31,7 +31,7 @@
 .\"
 .\" $Id$
 .\"
-.Dd September  9, 2003
+.Dd October 26, 2005
 .Dt GSS_ACQUIRE_CRED 3
 .Os HEIMDAL
 .Sh NAME
@@ -63,6 +63,7 @@
 .Nm gss_krb5_compat_des3_mic ,
 .Nm gss_krb5_copy_ccache ,
 .Nm gsskrb5_extract_authz_data_from_sec_context ,
+.Nm gss_krb5_import_ccache ,
 .Nm gss_krb5_get_tkt_flags ,
 .Nm gss_process_context_token ,
 .Nm gss_release_buffer ,
@@ -306,6 +307,12 @@ GSS-API library (libgssapi, -lgssapi)
 .Fa "gss_buffer_t ad_data"
 .Fc
 .Ft OM_uint32
+.Fo gss_krb5_import_ccache
+.Fa "OM_uint32 *minor"
+.Fa "krb5_ccache out"
+.Fa "gss_cred_id_t *cred"
+.Fc
+.Ft OM_uint32
 .Fo gss_krb5_get_tkt_flags
 .Fa "OM_uint32 *minor_status"
 .Fa "gss_ctx_id_t context_handle"
@@ -613,6 +620,10 @@ mechanism.
 The acceptor receives the delegated token in the last argument to
 .Fn gss_accept_sec_context .
 .Pp
+.Fn gss_krb5_import_ccache
+will import the krb5 credentials into gss credential so it can be used
+withing GSS-API.
+.Pp
 .Fn gsskrb5_register_acceptor_identity
 sets the Kerberos 5 principal that the acceptor will use.
 .Pp
diff --git a/lib/gssapi/krb5/gss_acquire_cred.3 b/lib/gssapi/krb5/gss_acquire_cred.3
index 412f94043..138ef9cee 100644
--- a/lib/gssapi/krb5/gss_acquire_cred.3
+++ b/lib/gssapi/krb5/gss_acquire_cred.3
@@ -1,4 +1,4 @@
-.\" Copyright (c) 2003 - 2004 Kungliga Tekniska Högskolan
+.\" Copyright (c) 2003 - 2005 Kungliga Tekniska Högskolan
 .\" (Royal Institute of Technology, Stockholm, Sweden).
 .\" All rights reserved.
 .\"
@@ -31,7 +31,7 @@
 .\"
 .\" $Id$
 .\"
-.Dd September  9, 2003
+.Dd October 26, 2005
 .Dt GSS_ACQUIRE_CRED 3
 .Os HEIMDAL
 .Sh NAME
@@ -63,6 +63,7 @@
 .Nm gss_krb5_compat_des3_mic ,
 .Nm gss_krb5_copy_ccache ,
 .Nm gsskrb5_extract_authz_data_from_sec_context ,
+.Nm gss_krb5_import_ccache ,
 .Nm gss_krb5_get_tkt_flags ,
 .Nm gss_process_context_token ,
 .Nm gss_release_buffer ,
@@ -306,6 +307,12 @@ GSS-API library (libgssapi, -lgssapi)
 .Fa "gss_buffer_t ad_data"
 .Fc
 .Ft OM_uint32
+.Fo gss_krb5_import_ccache
+.Fa "OM_uint32 *minor"
+.Fa "krb5_ccache out"
+.Fa "gss_cred_id_t *cred"
+.Fc
+.Ft OM_uint32
 .Fo gss_krb5_get_tkt_flags
 .Fa "OM_uint32 *minor_status"
 .Fa "gss_ctx_id_t context_handle"
@@ -613,6 +620,10 @@ mechanism.
 The acceptor receives the delegated token in the last argument to
 .Fn gss_accept_sec_context .
 .Pp
+.Fn gss_krb5_import_ccache
+will import the krb5 credentials into gss credential so it can be used
+withing GSS-API.
+.Pp
 .Fn gsskrb5_register_acceptor_identity
 sets the Kerberos 5 principal that the acceptor will use.
 .Pp