May 5, 2006 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

```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)