krb5_kt_get_entry - Get an entry from a key table. — MIT Kerberos Documentation

# MIT Kerberos Documentation

Contents | previous | next | index | Search | feedback

# krb5_kt_get_entry - Get an entry from a key table.

krb5_error_code `krb5_kt_get_entry`(krb5_context context, krb5_keytab keytab, krb5_const_principal principal, krb5_kvno vno, krb5_enctype enctype, krb5_keytab_entry * entry)

param: | [in] context - Library context [in] keytab - Key table handle [in] principal - Principal name [in] vno - Key version number (0 for highest available) [in] enctype - Encryption type (0 zero for any enctype) [out] entry - Returned entry from key table

retval: | 0 Success Kerberos error codes on failure

Retrieve an entry from a key table which matches the keytab , principal , vno , and enctype . If vno is zero, retrieve the highest-numbered kvno matching the other fields. If enctype is 0, match any enctype.

Use `krb5_free_keytab_entry_contents()` to free entry when it is no longer needed.

Note

If vno is zero, the function retrieves the highest-numbered-kvno entry that matches the specified principal.