| KRB5_KRBHST_INIT(3) | Library Functions Manual | KRB5_KRBHST_INIT(3) | 
krb5_krbhst_init,
  krb5_krbhst_init_flags,
  krb5_krbhst_next,
  krb5_krbhst_next_as_string,
  krb5_krbhst_reset,
  krb5_krbhst_free,
  krb5_krbhst_format_string,
  krb5_krbhst_get_addrinfo —
#include <krb5/krb5.h>
krb5_error_code
  
  krb5_krbhst_init(krb5_context
    context, const char
    *realm, unsigned int
    type, krb5_krbhst_handle
    *handle);
krb5_error_code
  
  krb5_krbhst_init_flags(krb5_context
    context, const char
    *realm, unsigned int
    type, int flags,
    krb5_krbhst_handle
    *handle);
krb5_error_code
  
  krb5_krbhst_next(krb5_context
    context,
    krb5_krbhst_handle
    handle, krb5_krbhst_info
    **host);
krb5_error_code
  
  krb5_krbhst_next_as_string(krb5_context
    context,
    krb5_krbhst_handle
    handle, char
    *hostname, size_t
    hostlen);
void
  
  krb5_krbhst_reset(krb5_context
    context,
    krb5_krbhst_handle
    handle);
void
  
  krb5_krbhst_free(krb5_context
    context,
    krb5_krbhst_handle
    handle);
krb5_error_code
  
  krb5_krbhst_format_string(krb5_context
    context, const
    krb5_krbhst_info *host,
    char *hostname,
    size_t hostlen);
krb5_error_code
  
  krb5_krbhst_get_addrinfo(krb5_context
    context, krb5_krbhst_info
    *host, struct addrinfo
    **ai);
First a handle to a particular service is obtained by calling
    krb5_krbhst_init() (or
    krb5_krbhst_init_flags()) with the
    realm of interest and the type of service to lookup.
    The type can be one of:
The handle is returned to the caller, and should be passed to the other functions.
The flag argument to
    krb5_krbhst_init_flags is the same flags as
    krb5_send_to_kdc_flags() uses. Possible values
  are:
For each call to krb5_krbhst_next()
    information on a new host is returned. The former function returns in
    host a pointer to a structure containing information
    about the host, such as protocol, hostname, and port:
typedef struct krb5_krbhst_info {
    enum { KRB5_KRBHST_UDP,
	   KRB5_KRBHST_TCP,
	   KRB5_KRBHST_HTTP } proto;
    unsigned short port;
    struct addrinfo *ai;
    struct krb5_krbhst_info *next;
    char hostname[1];
} krb5_krbhst_info;
The related function,
    krb5_krbhst_next_as_string(), return the same
    information as a URL-like string.
When there are no more hosts, these functions return
    KRB5_KDC_UNREACH.
To re-iterate over all hosts, call
    krb5_krbhst_reset() and the next call to
    krb5_krbhst_next() will return the first host.
When done with the handle,
    krb5_krbhst_free() should be called.
To use a krb5_krbhst_info, there are two
    functions: krb5_krbhst_format_string() that will
    return a printable representation of that struct and
    krb5_krbhst_get_addrinfo() that will return a
    struct addrinfo that can then be used for
    communicating with the server mentioned.
krb5_krbhst_handle handle;
char host[MAXHOSTNAMELEN];
krb5_krbhst_init(context, "MY.REALM", KRB5_KRBHST_KDC, &handle);
while(krb5_krbhst_next_as_string(context, handle,
				 host, sizeof(host)) == 0)
    printf("%s\n", host);
krb5_krbhst_free(context, handle);
| May 10, 2005 | NetBSD 9.3 |