KRB5_EXPAND_HOSTNAME(3) NetBSD Library Functions ManualKRB5_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/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)

NetBSD 5.0_STABLE                 May 5, 2006                NetBSD 5.0_STABLE
