krb5_get_host_realm()--Get Kerberos Realm Name for Host Name
Syntax
#include <krb5.h> krb5_error_code krb5_get_host_realm( krb5_context context, krb5_const char * host, char *** realm_list);Service Program Name: QSYS/QKRBGSS
Default Public Authority: *USE
Threadsafe: Yes
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
Message ID | Error Message Text |
---|---|
CPE3418 E | Possible APAR condition or hardware failure. |
API introduced: V5R1
[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]