krb5_os_hostaddr()--Get Network Addresses Used by Specific Host System

 #include <krb5.h>

 krb5_error_code krb5_os_hostaddr(
     krb5_context       context,  
     krb5_const char *      host,
     krb5_address ***     addrs);  

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