krb5_expand_hostname(3)

NAME

krb5_expand_hostname, krb5_expand_hostname_realms - Kerberos 5 host name canonicalization functions

LIBRARY

Kerberos 5 Library (libkrb5, -lkrb5)

SYNOPSIS

#include <krb5.h>
krb5_error_code
krb5_expand_hostname(krb5_context context, const char *orig_hostname,
        char **new_hostname);
krb5_error_code
krb5_expand_hostname_realms(krb5_context context,
        const char *orig_hostname, char **new_hostname, char ***realms);

DESCRIPTION

krb5_expand_hostname() tries to make orig_hostname into a more canonical one in the newly allocated space returned in new_hostname. Caller must free the hostname with free(3).

krb5_expand_hostname_realms() expands orig_hostname to a name we believe to be a hostname in newly allocated space in new_hostname and return the realms new_hostname is belive to belong to in realms. Realms is a array terminated with NULL. Caller must free the realms with
krb5_free_host_realm() and new_hostname with free(3).

SEE ALSO

krb5(3), krb5_free_host_realm(3), krb5_get_host_realm(3), kerberos(8)

HEIMDAL May 5, 2006 HEIMDAL