1 .\" Copyright (c) 2001 Kungliga Tekniska Högskolan
2 .\" $Id: krb5_get_krbhst.3,v 1.4 2002/08/28 15:30:53 joda Exp $
8 .Nm krb5_get_krb_admin_hst
9 .Nm krb5_get_krb_changepw_hst
10 .Nm krb5_get_krb524hst
12 .Nd lookup Kerberos KDC hosts
14 Kerberos 5 Library (libkrb5, -lkrb5)
18 .Fn krb5_get_krbhst "krb5_context context" "const krb5_realm *realm" "char ***hostlist"
20 .Fn krb5_get_krb_admin_hst "krb5_context context" "const krb5_realm *realm" "char ***hostlist"
22 .Fn krb5_get_krb_changepw_hst "krb5_context context" "const krb5_realm *realm" "char ***hostlist"
24 .Fn krb5_get_krb524hst "krb5_context context" "const krb5_realm *realm" "char ***hostlist"
26 .Fn krb5_free_krbhst "krb5_context context" "char **hostlist"
28 These functions implement the old API to get a list of Kerberos hosts,
29 and are thus similar to the
31 functions. However, since these functions returns
33 hosts in one go, they potentially have to do more lookups than
34 necessary. These functions remain for compatibility reasons.
36 After a call to one of these functions,
40 terminated list of strings, pointing to the requested Kerberos hosts. These should be freed with
44 The following code will print the KDCs of the realm
46 .Bd -literal -offset indent
48 krb5_get_krbhst(context, "MY.REALM", &hosts);
49 for(p = hosts; *p; p++)
51 krb5_free_krbhst(context, hosts);
55 .Xr krb5_krbhst_init 3