1 files changed, 60 insertions, 0 deletions
diff --git a/doc/html/_sources/appdev/refs/api/krb5_build_principal_ext.txt b/doc/html/_sources/appdev/refs/api/krb5_build_principal_ext.txt
new file mode 100644
index 000000000000..e1b6397853f5
--- /dev/null
+++ b/doc/html/_sources/appdev/refs/api/krb5_build_principal_ext.txt
@@ -0,0 +1,60 @@
+krb5_build_principal_ext -  Build a principal name using length-counted strings. 
+=================================================================================
+
+..
+
+.. c:function:: krb5_error_code krb5_build_principal_ext(krb5_context context, krb5_principal * princ, unsigned int rlen, const char * realm, ... )
+
+..
+
+
+:param:
+
+	          **[in]** **context** - Library context
+
+	          **[out]** **princ** - Principal name
+
+	          **[in]** **rlen** - Realm name length
+
+	          **[in]** **realm** - Realm name
+
+
+..
+
+
+:retval:
+         -   0   Success
+
+
+:return:
+         -  Kerberos error codes 
+
+..
+
+
+
+
+
+
+
+This function creates a principal from a length-counted string and a variable-length list of length-counted components. The list of components ends with the first 0 length argument (so it is not possible to specify an empty component with this function). Call :c:func:`krb5_free_principal()` to free allocated memory for principal when it is no longer needed.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+..
+
+
+
+
+