krb5_get_host_realm()--Get Kerberos Realm Name for Host Name

 #include <krb5.h>

 krb5_error_code krb5_get_host_realm(  
     krb5_context     context,
     krb5_const char *      host,
     char ***       realm_list);   

The krb5_get_host_realm() function returns a list of Kerberos realm names for the specified host name. The entries in the [domain_realm] section of the Kerberos configuration file are used. A direct match takes precedence over a suffix match. The current implementation of this routine returns a single realm name. If no realm name is found, the uppercased host domain is returned as the realm name.

Authorities

No authorities are required.

Parameters

context  (Input)

The Kerberos context.

host  (Input)

The host name. The local host name is used if NULL is specified for this parameter.

realm  (Output)

An array of realm names. The last entry in the array will be a NULL pointer. The krb5_free_host_realm() routine should be called to release the realm list when it is no longer needed.

Return Value

If no errors occur, the return value is 0. Otherwise, a Kerberos error code is returned.

Error Messages

[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]