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 ]