aboutsummaryrefslogtreecommitdiff
path: root/src/include/krb5/krb5.hin
diff options
context:
space:
mode:
authorFraser Tweedale <ftweedal@redhat.com>2021-02-05 11:00:24 +1100
committerGreg Hudson <ghudson@mit.edu>2021-02-11 13:57:25 -0500
commit457ce648b654990cb101f66255b4a87b7339efc1 (patch)
treeb90ad8a2e41cae3e0d4280aec28ddd5640db80ff /src/include/krb5/krb5.hin
parent13ae08e70a05768d4f65978ce1a8d4e16fec0d35 (diff)
downloadkrb5-457ce648b654990cb101f66255b4a87b7339efc1.zip
krb5-457ce648b654990cb101f66255b4a87b7339efc1.tar.gz
krb5-457ce648b654990cb101f66255b4a87b7339efc1.tar.bz2
Infer name type when creating principals
In the krb5_parse_name() and krb5_build_principal() families, infer the name type if the principal is a TGS name or has first component WELLKNOWN. Revert commit 0d5df56ea6d4a05c31b7e513ee9ec1542a4b5dce and part of commit 5994d8928b8ff88751b14bc60c7d7bfce8b30e57 since that responsibility now lies with krb5_build_principal_ext(). [ghudson@mit.edu: made editorial changes; added removal of no-longer-needed code; added documentation; rewrote commit message] ticket: 8983 (new)
Diffstat (limited to 'src/include/krb5/krb5.hin')
-rw-r--r--src/include/krb5/krb5.hin12
1 files changed, 12 insertions, 0 deletions
diff --git a/src/include/krb5/krb5.hin b/src/include/krb5/krb5.hin
index 6a01ed1..4af545f 100644
--- a/src/include/krb5/krb5.hin
+++ b/src/include/krb5/krb5.hin
@@ -3450,6 +3450,10 @@ krb5_rd_priv(krb5_context context, krb5_auth_context auth_context,
* @note The realm in a Kerberos @a name cannot contain slash, colon,
* or NULL characters.
*
+ * Beginning with release 1.20, the name type of the principal will be inferred
+ * as @c KRB5_NT_SRV_INST or @c KRB5_NT_WELLKNOWN based on the principal name.
+ * The type will be @c KRB5_NT_PRINCIPAL if a type cannot be inferred.
+ *
* Use krb5_free_principal() to free @a principal_out when it is no longer
* needed.
*
@@ -4013,6 +4017,10 @@ krb5_get_server_rcache(krb5_context context, const krb5_data *piece,
* empty component with this function). Call krb5_free_principal() to free
* allocated memory for principal when it is no longer needed.
*
+ * Beginning with release 1.20, the name type of the principal will be inferred
+ * as @c KRB5_NT_SRV_INST or @c KRB5_NT_WELLKNOWN based on the principal name.
+ * The type will be @c KRB5_NT_PRINCIPAL if a type cannot be inferred.
+ *
* @code
* Example of how to build principal WELLKNOWN/ANONYMOUS@R
* krb5_build_principal_ext(context, &principal, strlen("R"), "R",
@@ -4042,6 +4050,10 @@ krb5_build_principal_ext(krb5_context context, krb5_principal * princ,
*
* Call krb5_free_principal() to free @a princ when it is no longer needed.
*
+ * Beginning with release 1.20, the name type of the principal will be inferred
+ * as @c KRB5_NT_SRV_INST or @c KRB5_NT_WELLKNOWN based on the principal name.
+ * The type will be @c KRB5_NT_PRINCIPAL if a type cannot be inferred.
+ *
* @note krb5_build_principal() and krb5_build_principal_alloc_va() perform the
* same task. krb5_build_principal() takes variadic arguments.
* krb5_build_principal_alloc_va() takes a pre-computed @a varargs pointer.