krb5_wrap: Document smb_krb5_kt_get_name()
authorAndreas Schneider <asn@samba.org>
Mon, 29 Aug 2016 09:10:30 +0000 (11:10 +0200)
committerAndrew Bartlett <abartlet@samba.org>
Wed, 31 Aug 2016 18:59:15 +0000 (20:59 +0200)
Signed-off-by: Andreas Schneider <asn@samba.org>
Reviewed-by: Andrew Bartlett <abartlet@samba.org>
lib/krb5_wrap/krb5_samba.c

index 4416e3b6dad7d40ba3c4bfca0980719f74d819c6..189797f264a532aa26be18b2c3351f2819a61589 100644 (file)
@@ -1151,6 +1151,21 @@ krb5_error_code smb_krb5_kt_open(krb5_context context,
                                         keytab);
 }
 
+/**
+ * @brief Get a key table name.
+ *
+ * @param[in]  mem_ctx The talloc context to use for allocation.
+ *
+ * @param[in]  context The library context.
+ *
+ * @param[in]  keytab The key table to get the name from.
+ *
+ * @param[in]  keytab_name A talloc'ed string of the key table name.
+ *
+ * The talloc'ed name string needs to be freed with talloc_free().
+ *
+ * @return 0 on success, a Kerberos error code otherwise.
+ */
 krb5_error_code smb_krb5_kt_get_name(TALLOC_CTX *mem_ctx,
                                     krb5_context context,
                                     krb5_keytab keytab,