krb5_v4compat(3)

✨ krb5_v4compat ✨

okay bestie, so this is a page from the Heimdal Kerberos 5 library manual — krb5_v4compat(3), the v4 compatibility girlies 💖. It's short, it's deprecated, and it's here to shuttle your Kerberos 5 creds into old-school Kerberos 4 land. Let's get into it 🫶

---

🌸 NAME 🌸

krb5_v4compat — Heimdal Kerberos 4 compatiblity functions

(yes, "compatiblity", that's literally what it says, we don't edit the source bestie 😭)

---

✨ SYNOPSIS ✨

💅 Functions

KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb524_convert_creds_kdc
    (krb5_context context, krb5_creds *in_cred, struct credentials
    *v4creds) KRB5_DEPRECATED_FUNCTION('Use X instead')
KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
    krb524_convert_creds_kdc_ccache (krb5_context context, krb5_ccache
    ccache, krb5_creds *in_cred, struct credentials *v4creds)
    KRB5_DEPRECATED_FUNCTION('Use X instead')

both of these are marked KRB5_DEPRECATED_FUNCTION('Use X instead') — that's the library itself telling you to move on. the way that it literally has a placeholder where the replacement should be 💀 still, they're documented here, so here we are 🌈

---

🦋 Detailed Description 🦋

so… there is none. that's it. that's the section. nothing under it. a moment of silence 🎀

---

👑 Function Documentation 👑

⭐ KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb524_convert_creds_kdc (krb5_context context, krb5_creds * in_cred, struct credentials * v4creds)

Convert the v5 credentials in in_cred to v4-dito in v4creds. This is done by sending them to the 524 function in the KDC. If in_cred doesn't contain a DES session key, then a new one is gotten from the KDC and stored in the cred cache ccache.

🫧 Parameters

• context — Kerberos 5 context.
• in_cred — the credential to convert
• v4creds — the converted credential

🫧 Returns

Returns 0 to indicate success. Otherwise an kerberos et error code is returned, see krb5_get_error_message().

(no, "an kerberos et error code" is not me being unserious, that's the actual text, i would never 🙈)

---

⭐ KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb524_convert_creds_kdc_ccache (krb5_context context, krb5_ccache ccache, krb5_creds * in_cred, struct credentials * v4creds)

Convert the v5 credentials in in_cred to v4-dito in v4creds, check the credential cache ccache before checking with the KDC.

like the other one but it peeks at your cache first before bothering the KDC, lowkey considerate 💅

🫧 Parameters

• context — Kerberos 5 context.
• ccache — credential cache used to check for des-ticket.
• in_cred — the credential to convert
• v4creds — the converted credential

🫧 Returns

Returns 0 to indicate success. Otherwise an kerberos et error code is returned, see krb5_get_error_message().

---

💖 Author 💖

Generated automatically by Doxygen for Heimdal Kerberos 5 library from the source code.

---

okay that's the whole page, no cap ✨ it's Version 7.8.0, dated Tue Nov 15 2022, straight from the Heimdal Kerberos 5 library manual — 524 conversion stays serving in the v4-compat corner of the repo, deprecated but iconic 💜 go call krb5_get_error_message() if things go sideways, bestie, mwah 🎀💖