From 3d4847835f29ae383cb80cec69b7984ddb5f6777 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Love=20H=C3=B6rnquist=20=C3=85strand?= <lha@kth.se>
Date: Sun, 16 Mar 2003 18:33:27 +0000
Subject: [PATCH] add documention for krb5_kt_get_type

git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@11787 ec53bebd-3082-4978-b11e-865c3cabbd6b
---
 lib/krb5/krb5_keytab.3 | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/lib/krb5/krb5_keytab.3 b/lib/krb5/krb5_keytab.3
index 6310196ec..bbf30bd04 100644
--- a/lib/krb5/krb5_keytab.3
+++ b/lib/krb5/krb5_keytab.3
@@ -1,4 +1,4 @@
-.\" Copyright (c) 2001 Kungliga Tekniska Högskolan
+.\" Copyright (c) 2001 - 2003 Kungliga Tekniska Högskolan
 .\" (Royal Institute of Technology, Stockholm, Sweden). 
 .\" All rights reserved. 
 .\"
@@ -48,6 +48,7 @@
 .Nm krb5_kt_free_entry ,
 .Nm krb5_kt_get_entry ,
 .Nm krb5_kt_get_name ,
+.Nm krb5_kt_get_type ,
 .Nm krb5_kt_next_entry ,
 .Nm krb5_kt_read_service_key ,
 .Nm krb5_kt_register ,
@@ -124,6 +125,13 @@ Kerberos 5 Library (libkrb5, -lkrb5)
 .Fa "size_t namesize"
 .Fc
 .Ft krb5_error_code
+.Fo krb5_kt_get_type
+.Fa "krb5_context context"
+.Fa "krb5_keytab keytab"
+.Fa "char *prefix"
+.Fa "size_t prefixsize"
+.Fc
+.Ft krb5_error_code
 .Fo krb5_kt_next_entry
 .Fa "krb5_context context"
 .Fa "krb5_keytab id"
@@ -291,6 +299,18 @@ into
 .Fa namesize .
 Returns 0 or an error.
 .Pp
+.Fn krb5_kt_get_type
+retrieves the type of the keytab
+.Fa keytab
+and store the prefix/name for type of the keytab into
+.Fa prefix ,
+.Fa prefixsize .
+The prefix will have the maximum length of
+.Dv KRB5_KT_PREFIX_MAX_LEN 
+(including terminating
+.Dv NUL ) .
+Returns 0 or an error.
+.Pp
 .Fn krb5_kt_free_entry
 frees the contents of
 .Fa entry .