/usr/man/cat.3/krb5_expand_hostname.3.Z(/usr/man/cat.3/krb5_expand_hostname.3.Z)

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
See also krb5_expand_hostname_realms(3)