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 ]