From 333284ed2ed3d4afa6c4dc582d1564597c683de0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Love=20H=C3=B6rnquist=20=C3=85strand?= <lha@kth.se>
Date: Tue, 1 Nov 2005 09:40:23 +0000
Subject: [PATCH] Document krb5_cc_get_full_name.

git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@16274 ec53bebd-3082-4978-b11e-865c3cabbd6b
---
 lib/krb5/krb5_ccache.3 | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/lib/krb5/krb5_ccache.3 b/lib/krb5/krb5_ccache.3
index c5463ba54..cae4be8bd 100644
--- a/lib/krb5/krb5_ccache.3
+++ b/lib/krb5/krb5_ccache.3
@@ -48,6 +48,7 @@
 .Nm krb5_cc_destroy ,
 .Nm krb5_cc_end_seq_get ,
 .Nm krb5_cc_gen_new ,
+.Nm krb5_cc_get_full_name ,
 .Nm krb5_cc_get_name ,
 .Nm krb5_cc_get_ops ,
 .Nm krb5_cc_get_prefix_ops ,
@@ -123,6 +124,12 @@ Kerberos 5 Library (libkrb5, -lkrb5)
 .Fa "const krb5_cc_ops *ops"
 .Fa "krb5_ccache *id"
 .Fc
+.Ft krb5_error_code
+.Fo krb5_cc_get_full_name
+.Fa "krb5_context context"
+.Fa "krb5_ccache id"
+.Fa "char **str"
+.Fc
 .Ft "const char *"
 .Fo krb5_cc_get_name
 .Fa "krb5_context context"
@@ -339,6 +346,19 @@ copys the contents of
 to
 .Fa to .
 .Pp
+.Fn krb5_cc_get_full_name
+returns the complete resolvable name of the credential cache
+.Fa id
+in
+.Fa str .
+.Fa str
+should be freed with
+.Xr free 3 .
+Returns 0 or an error, on error
+.Fa *str
+is set to
+.Dv NULL .
+.Pp
 .Fn krb5_cc_get_name
 returns the name of the credential cache
 .Fa id .