DOKK / manpages / debian 12 / heimdal-dev / krb5_get_krb_changepw_hst.3.en
KRB5_GET_KRBHST(3) Library Functions Manual KRB5_GET_KRBHST(3)

krb5_get_krbhst, krb5_get_krb_admin_hst, krb5_get_krb_changepw_hst, krb5_get_krb524hst, krb5_free_krbhstlookup Kerberos KDC hosts

Kerberos 5 Library (libkrb5, -lkrb5)

#include <krb5.h>

krb5_get_krbhst(krb5_context context, const krb5_realm *realm, char ***hostlist);

krb5_get_krb_admin_hst(krb5_context context, const krb5_realm *realm, char ***hostlist);

krb5_get_krb_changepw_hst(krb5_context context, const krb5_realm *realm, char ***hostlist);

krb5_get_krb524hst(krb5_context context, const krb5_realm *realm, char ***hostlist);

krb5_free_krbhst(krb5_context context, char **hostlist);

These functions implement the old API to get a list of Kerberos hosts, and are thus similar to the () functions. However, since these functions returns hosts in one go, they potentially have to do more lookups than necessary. These functions remain for compatibility reasons.

After a call to one of these functions, hostlist is a NULL terminated list of strings, pointing to the requested Kerberos hosts. These should be freed with () when done with.

The following code will print the KDCs of the realm “MY.REALM”.

char **hosts, **p;
krb5_get_krbhst(context, "MY.REALM", &hosts);
for(p = hosts; *p; p++)
    printf("%s\n", *p);
krb5_free_krbhst(context, hosts);


April 24, 2005 HEIMDAL