From: Greg Hudson <ghudson@mit.edu>
Date: Thu, 25 Oct 2012 19:50:06 +0000 (-0400)
Subject: Correctly document krb5_unparse_name_ext
X-Git-Tag: krb5-1.12-alpha1~495
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=671c84a37521a4f62be300af00790fc5aed9cbfd;p=thirdparty%2Fkrb5.git

Correctly document krb5_unparse_name_ext

ticket: 7431
target_version: 1.11
tags: pullup
---

diff --git a/src/include/krb5/krb5.hin b/src/include/krb5/krb5.hin
index dd2b85be65..7db3787c8b 100644
--- a/src/include/krb5/krb5.hin
+++ b/src/include/krb5/krb5.hin
@@ -3507,13 +3507,19 @@ krb5_unparse_name(krb5_context context, krb5_const_principal principal,
 /**
  * Convert krb5_principal structure to string and length.
  *
- * @param [in]  context         Library context
- * @param [in]  principal       Principal
- * @param [out] name            String representation of principal name
- * @param [out] size            Size of unparsed name
- *
- * This function is similar to krb5_unparse_name(), but also returns the length
- * of the string representation.
+ * @param [in]     context      Library context
+ * @param [in]     principal    Principal
+ * @param [in,out] name         String representation of principal name
+ * @param [in,out] size         Size of unparsed name
+ *
+ * This function is similar to krb5_unparse_name(), but allows the use of an
+ * existing buffer for the result.  If size is not NULL, then *name must be
+ * either NULL or an existing buffer of at least size *size.  The buffer will
+ * be allocated or resized if necessary, with the new pointer stored into
+ * *name.  Whether or not the buffer is resized, the necessary space for the
+ * result, including null terminator, will be stored into *size.
+ *
+ * If size is NULL, this function behaves exactly as krb5_unparse_name().
  *
  * @retval
  * 0 Success