krb5_os_hostaddr()--Get Network Addresses Used by Specific Host System
Syntax
#include <krb5.h> krb5_error_code krb5_os_hostaddr( krb5_context context, krb5_const char * host, krb5_address *** addrs);Service Program Name: QSYS/QKRBGSS
Default Public Authority: *USE
Threadsafe: Yes
The krb5_os_hostaddr() function returns the network addresses used by a specific host system. At the present time, only the AF_INET address family is supported, and the gethostbyname_r() system function is used to search for the addresses assigned to the specified host.
Authorities
No authorities are required.
Parameters
- context (Input)
- The Kerberos context.
- host (Input)
- The name of the host system. The name must be acceptable for use with the
gethostbyname_r() system function.
- addrs (Output)
- An array of krb5_address pointers. The last entry in the array is a NULL pointer. The krb5_free_addresses() routine should be called to release the address array 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 ]