FreeBSD manual

download PDF document: krb5_string_to_key.3.pdf

KRB5_STRING_TO_KEY(3) FreeBSD Library Functions Manual KRB5_STRING_TO_KEY(3)
NAME krb5_string_to_key, krb5_string_to_key_data, krb5_string_to_key_data_salt, krb5_string_to_key_data_salt_opaque, krb5_string_to_key_salt, krb5_string_to_key_salt_opaque, krb5_get_pw_salt, krb5_free_salt - turns a string to a Kerberos key
LIBRARY Kerberos 5 Library (libkrb5, -lkrb5)
SYNOPSIS #include <krb5.h>
krb5_error_code krb5_string_to_key(krb5_context context, krb5_enctype enctype, const char *password, krb5_principal principal, krb5_keyblock *key);
krb5_error_code krb5_string_to_key_data(krb5_context context, krb5_enctype enctype, krb5_data password, krb5_principal principal, krb5_keyblock *key);
krb5_error_code krb5_string_to_key_data_salt(krb5_context context, krb5_enctype enctype, krb5_data password, krb5_salt salt, krb5_keyblock *key);
krb5_error_code krb5_string_to_key_data_salt_opaque(krb5_context context, krb5_enctype enctype, krb5_data password, krb5_salt salt, krb5_data opaque, krb5_keyblock *key);
krb5_error_code krb5_string_to_key_salt(krb5_context context, krb5_enctype enctype, const char *password, krb5_salt salt, krb5_keyblock *key);
krb5_error_code krb5_string_to_key_salt_opaque(krb5_context context, krb5_enctype enctype, const char *password, krb5_salt salt, krb5_data opaque, krb5_keyblock *key);
krb5_error_code krb5_get_pw_salt(krb5_context context, krb5_const_principal principal, krb5_salt *salt);
krb5_error_code krb5_free_salt(krb5_context context, krb5_salt salt);
DESCRIPTION The string to key functions convert a string to a kerberos key.
krb5_string_to_key_data_salt_opaque() is the function that does all the work, the rest of the functions are just wrappers around krb5_string_to_key_data_salt_opaque() that calls it with default values.
krb5_string_to_key_data_salt_opaque() transforms the password with the given salt-string salt and the opaque, encryption type specific parameter opaque to a encryption key key according to the string to key function associated with enctype.

krb5_free_salt() frees the content of salt.
SEE ALSO krb5(3), krb5_data(3), krb5_keyblock(3), kerberos(8)
HEIMDAL July 10, 2006 HEIMDAL