krb5_get_krbhst()--Get List of KDC Hosts

Syntax

 #include <krb5.h>

 krb5_error_code krb5_get_krbhst(
     krb5_context     context,
     krb5_const krb5_data *   realm,   
     char ***       hostlist);

  Service Program Name: QSYS/QKRBGSS

  Default Public Authority: *USE

  Threadsafe: Yes

The krb5_get_krbhst() function returns a list of Kerberos Key Distribution Center (KDC) server hosts for a Kerberos realm. The list is obtained from the [realms] section of the Kerberos configuration file.

Authorities

No authorities are required.

Parameters

context (Input): The Kerberos context.
realm (Input): The Kerberos realm.
hostlist (Output): The KDC host list. The last entry in the list is a NULL pointer. The krb5_free_krbhst() routine should be called to release the host 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 ]