2 * Copyright (c) 2001 - 2003 Kungliga Tekniska Högskolan
3 * (Royal Institute of Technology, Stockholm, Sweden).
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
17 * 3. Neither the name of the Institute nor the names of its contributors
18 * may be used to endorse or promote products derived from this software
19 * without specific prior written permission.
21 * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
22 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
25 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 #include "krb5_locl.h"
36 #include "locate_plugin.h"
41 string_to_proto(const char *string)
43 if(strcasecmp(string, "udp") == 0)
44 return KRB5_KRBHST_UDP;
45 else if(strcasecmp(string, "tcp") == 0)
46 return KRB5_KRBHST_TCP;
47 else if(strcasecmp(string, "http") == 0)
48 return KRB5_KRBHST_HTTP;
53 * set `res' and `count' to the result of looking up SRV RR in DNS for
54 * `proto', `proto', `realm' using `dns_type'.
55 * if `port' != 0, force that port number
58 static krb5_error_code
59 srv_find_realm(krb5_context context, krb5_krbhst_info ***res, int *count,
60 const char *realm, const char *dns_type,
61 const char *proto, const char *service, int port)
65 struct resource_record *rr;
73 proto_num = string_to_proto(proto);
75 krb5_set_error_message(context, EINVAL,
76 N_("unknown protocol `%s' to lookup", ""),
81 if(proto_num == KRB5_KRBHST_HTTP)
82 def_port = ntohs(krb5_getportbyname (context, "http", "tcp", 80));
84 def_port = ntohs(krb5_getportbyname (context, service, proto, 88));
88 snprintf(domain, sizeof(domain), "_%s._%s.%s.", service, proto, realm);
90 r = dns_lookup(domain, dns_type);
92 return KRB5_KDC_UNREACH;
94 for(num_srv = 0, rr = r->head; rr; rr = rr->next)
98 *res = malloc(num_srv * sizeof(**res));
101 krb5_set_error_message(context, ENOMEM,
102 N_("malloc: out of memory", ""));
108 for(num_srv = 0, rr = r->head; rr; rr = rr->next)
109 if(rr->type == T_SRV) {
110 krb5_krbhst_info *hi;
111 size_t len = strlen(rr->u.srv->target);
113 hi = calloc(1, sizeof(*hi) + len);
116 while(--num_srv >= 0)
117 free((*res)[num_srv]);
122 (*res)[num_srv++] = hi;
124 hi->proto = proto_num;
126 hi->def_port = def_port;
130 hi->port = rr->u.srv->port;
132 strlcpy(hi->hostname, rr->u.srv->target, len + 1);
142 struct krb5_krbhst_data {
146 int port; /* hardwired port number if != 0 */
150 #define KD_SRV_HTTP 8
151 #define KD_FALLBACK 16
152 #define KD_CONFIG_EXISTS 32
153 #define KD_LARGE_MSG 64
154 #define KD_PLUGIN 128
155 krb5_error_code (*get_next)(krb5_context, struct krb5_krbhst_data *,
158 unsigned int fallback_count;
160 struct krb5_krbhst_info *hosts, **index, **end;
164 krbhst_empty(const struct krb5_krbhst_data *kd)
166 return kd->index == &kd->hosts;
170 * Return the default protocol for the `kd' (either TCP or UDP)
174 krbhst_get_default_proto(struct krb5_krbhst_data *kd)
176 if (kd->flags & KD_LARGE_MSG)
177 return KRB5_KRBHST_TCP;
178 return KRB5_KRBHST_UDP;
183 * parse `spec' into a krb5_krbhst_info, defaulting the port to `def_port'
184 * and forcing it to `port' if port != 0
187 static struct krb5_krbhst_info*
188 parse_hostspec(krb5_context context, struct krb5_krbhst_data *kd,
189 const char *spec, int def_port, int port)
191 const char *p = spec;
192 struct krb5_krbhst_info *hi;
194 hi = calloc(1, sizeof(*hi) + strlen(spec));
198 hi->proto = krbhst_get_default_proto(kd);
200 if(strncmp(p, "http://", 7) == 0){
201 hi->proto = KRB5_KRBHST_HTTP;
203 } else if(strncmp(p, "http/", 5) == 0) {
204 hi->proto = KRB5_KRBHST_HTTP;
206 def_port = ntohs(krb5_getportbyname (context, "http", "tcp", 80));
207 }else if(strncmp(p, "tcp/", 4) == 0){
208 hi->proto = KRB5_KRBHST_TCP;
210 } else if(strncmp(p, "udp/", 4) == 0) {
214 if(strsep_copy(&p, ":", hi->hostname, strlen(spec) + 1) < 0) {
218 /* get rid of trailing /, and convert to lower case */
219 hi->hostname[strcspn(hi->hostname, "/")] = '\0';
220 strlwr(hi->hostname);
222 hi->port = hi->def_port = def_port;
225 hi->port = strtol(p, &end, 0);
237 _krb5_free_krbhst_info(krb5_krbhst_info *hi)
240 freeaddrinfo(hi->ai);
245 _krb5_krbhost_info_move(krb5_context context,
246 krb5_krbhst_info *from,
247 krb5_krbhst_info **to)
249 size_t hostnamelen = strlen(from->hostname);
250 /* trailing NUL is included in structure */
251 *to = calloc(1, sizeof(**to) + hostnamelen);
253 krb5_set_error_message(context, ENOMEM,
254 N_("malloc: out of memory", ""));
258 (*to)->proto = from->proto;
259 (*to)->port = from->port;
260 (*to)->def_port = from->def_port;
261 (*to)->ai = from->ai;
264 memcpy((*to)->hostname, from->hostname, hostnamelen + 1);
270 append_host_hostinfo(struct krb5_krbhst_data *kd, struct krb5_krbhst_info *host)
272 struct krb5_krbhst_info *h;
274 for(h = kd->hosts; h; h = h->next)
275 if(h->proto == host->proto &&
276 h->port == host->port &&
277 strcmp(h->hostname, host->hostname) == 0) {
278 _krb5_free_krbhst_info(host);
282 kd->end = &host->next;
285 static krb5_error_code
286 append_host_string(krb5_context context, struct krb5_krbhst_data *kd,
287 const char *host, int def_port, int port)
289 struct krb5_krbhst_info *hi;
291 hi = parse_hostspec(context, kd, host, def_port, port);
295 append_host_hostinfo(kd, hi);
300 * return a readable representation of `host' in `hostname, hostlen'
303 krb5_error_code KRB5_LIB_FUNCTION
304 krb5_krbhst_format_string(krb5_context context, const krb5_krbhst_info *host,
305 char *hostname, size_t hostlen)
307 const char *proto = "";
308 char portstr[7] = "";
309 if(host->proto == KRB5_KRBHST_TCP)
311 else if(host->proto == KRB5_KRBHST_HTTP)
313 if(host->port != host->def_port)
314 snprintf(portstr, sizeof(portstr), ":%d", host->port);
315 snprintf(hostname, hostlen, "%s%s%s", proto, host->hostname, portstr);
320 * create a getaddrinfo `hints' based on `proto'
324 make_hints(struct addrinfo *hints, int proto)
326 memset(hints, 0, sizeof(*hints));
327 hints->ai_family = AF_UNSPEC;
329 case KRB5_KRBHST_UDP :
330 hints->ai_socktype = SOCK_DGRAM;
332 case KRB5_KRBHST_HTTP :
333 case KRB5_KRBHST_TCP :
334 hints->ai_socktype = SOCK_STREAM;
340 * return an `struct addrinfo *' in `ai' corresponding to the information
341 * in `host'. free:ing is handled by krb5_krbhst_free.
344 krb5_error_code KRB5_LIB_FUNCTION
345 krb5_krbhst_get_addrinfo(krb5_context context, krb5_krbhst_info *host,
346 struct addrinfo **ai)
348 struct addrinfo hints;
349 char portstr[NI_MAXSERV];
352 if (host->ai == NULL) {
353 make_hints(&hints, host->proto);
354 snprintf (portstr, sizeof(portstr), "%d", host->port);
355 ret = getaddrinfo(host->hostname, portstr, &hints, &host->ai);
357 return krb5_eai_to_heim_errno(ret, errno);
364 get_next(struct krb5_krbhst_data *kd, krb5_krbhst_info **host)
366 struct krb5_krbhst_info *hi = *kd->index;
369 kd->index = &(*kd->index)->next;
376 srv_get_hosts(krb5_context context, struct krb5_krbhst_data *kd,
377 const char *proto, const char *service)
379 krb5_krbhst_info **res;
382 if (srv_find_realm(context, &res, &count, kd->realm, "SRV", proto, service,
385 for(i = 0; i < count; i++)
386 append_host_hostinfo(kd, res[i]);
391 * read the configuration for `conf_string', defaulting to kd->def_port and
392 * forcing it to `kd->port' if kd->port != 0
396 config_get_hosts(krb5_context context, struct krb5_krbhst_data *kd,
397 const char *conf_string)
402 hostlist = krb5_config_get_strings(context, NULL,
403 "realms", kd->realm, conf_string, NULL);
407 kd->flags |= KD_CONFIG_EXISTS;
408 for(i = 0; hostlist && hostlist[i] != NULL; i++)
409 append_host_string(context, kd, hostlist[i], kd->def_port, kd->port);
411 krb5_config_free_strings(hostlist);
415 * as a fallback, look for `serv_string.kd->realm' (typically
416 * kerberos.REALM, kerberos-1.REALM, ...
417 * `port' is the default port for the service, and `proto' the
421 static krb5_error_code
422 fallback_get_hosts(krb5_context context, struct krb5_krbhst_data *kd,
423 const char *serv_string, int port, int proto)
428 struct addrinfo hints;
429 char portstr[NI_MAXSERV];
432 * Don't try forever in case the DNS server keep returning us
433 * entries (like wildcard entries or the .nu TLD)
435 if(kd->fallback_count >= 5) {
436 kd->flags |= KD_FALLBACK;
440 if(kd->fallback_count == 0)
441 asprintf(&host, "%s.%s.", serv_string, kd->realm);
443 asprintf(&host, "%s-%d.%s.",
444 serv_string, kd->fallback_count, kd->realm);
449 make_hints(&hints, proto);
450 snprintf(portstr, sizeof(portstr), "%d", port);
451 ret = getaddrinfo(host, portstr, &hints, &ai);
453 /* no more hosts, so we're done here */
455 kd->flags |= KD_FALLBACK;
457 struct krb5_krbhst_info *hi;
458 size_t hostlen = strlen(host);
460 hi = calloc(1, sizeof(*hi) + hostlen);
467 hi->port = hi->def_port = port;
469 memmove(hi->hostname, host, hostlen);
470 hi->hostname[hostlen] = '\0';
472 append_host_hostinfo(kd, hi);
473 kd->fallback_count++;
479 * Fetch hosts from plugin
482 static krb5_error_code
483 add_locate(void *ctx, int type, struct sockaddr *addr)
485 struct krb5_krbhst_info *hi;
486 struct krb5_krbhst_data *kd = ctx;
487 char host[NI_MAXHOST], port[NI_MAXSERV];
488 struct addrinfo hints, *ai;
493 socklen = socket_sockaddr_size(addr);
495 ret = getnameinfo(addr, socklen, host, sizeof(host), port, sizeof(port),
496 NI_NUMERICHOST|NI_NUMERICSERV);
500 make_hints(&hints, krbhst_get_default_proto(kd));
501 ret = getaddrinfo(host, port, &hints, &ai);
505 hostlen = strlen(host);
507 hi = calloc(1, sizeof(*hi) + hostlen);
511 hi->proto = krbhst_get_default_proto(kd);
512 hi->port = hi->def_port = socket_get_port(addr);
514 memmove(hi->hostname, host, hostlen);
515 hi->hostname[hostlen] = '\0';
516 append_host_hostinfo(kd, hi);
522 plugin_get_hosts(krb5_context context,
523 struct krb5_krbhst_data *kd,
524 enum locate_service_type type)
526 struct krb5_plugin *list = NULL, *e;
529 ret = _krb5_plugin_find(context, PLUGIN_TYPE_DATA,
530 KRB5_PLUGIN_LOCATE, &list);
531 if(ret != 0 || list == NULL)
534 for (e = list; e != NULL; e = _krb5_plugin_get_next(e)) {
535 krb5plugin_service_locate_ftable *service;
538 service = _krb5_plugin_get_symbol(e);
539 if (service->minor_version != 0)
542 (*service->init)(context, &ctx);
543 ret = (*service->lookup)(ctx, type, kd->realm, 0, 0, add_locate, kd);
544 (*service->fini)(ctx);
545 if (ret && ret != KRB5_PLUGIN_NO_HANDLE) {
546 krb5_set_error_message(context, ret,
547 N_("Locate plugin failed to lookup realm %s: %d", ""),
551 kd->flags |= KD_CONFIG_EXISTS;
554 _krb5_plugin_free(list);
561 static krb5_error_code
562 kdc_get_next(krb5_context context,
563 struct krb5_krbhst_data *kd,
564 krb5_krbhst_info **host)
568 if ((kd->flags & KD_PLUGIN) == 0) {
569 plugin_get_hosts(context, kd, locate_service_kdc);
570 kd->flags |= KD_PLUGIN;
571 if(get_next(kd, host))
575 if((kd->flags & KD_CONFIG) == 0) {
576 config_get_hosts(context, kd, "kdc");
577 kd->flags |= KD_CONFIG;
578 if(get_next(kd, host))
582 if (kd->flags & KD_CONFIG_EXISTS)
583 return KRB5_KDC_UNREACH; /* XXX */
585 if(context->srv_lookup) {
586 if((kd->flags & KD_SRV_UDP) == 0 && (kd->flags & KD_LARGE_MSG) == 0) {
587 srv_get_hosts(context, kd, "udp", "kerberos");
588 kd->flags |= KD_SRV_UDP;
589 if(get_next(kd, host))
593 if((kd->flags & KD_SRV_TCP) == 0) {
594 srv_get_hosts(context, kd, "tcp", "kerberos");
595 kd->flags |= KD_SRV_TCP;
596 if(get_next(kd, host))
599 if((kd->flags & KD_SRV_HTTP) == 0) {
600 srv_get_hosts(context, kd, "http", "kerberos");
601 kd->flags |= KD_SRV_HTTP;
602 if(get_next(kd, host))
607 while((kd->flags & KD_FALLBACK) == 0) {
608 ret = fallback_get_hosts(context, kd, "kerberos",
610 krbhst_get_default_proto(kd));
613 if(get_next(kd, host))
617 return KRB5_KDC_UNREACH; /* XXX */
620 static krb5_error_code
621 admin_get_next(krb5_context context,
622 struct krb5_krbhst_data *kd,
623 krb5_krbhst_info **host)
627 if ((kd->flags & KD_PLUGIN) == 0) {
628 plugin_get_hosts(context, kd, locate_service_kadmin);
629 kd->flags |= KD_PLUGIN;
630 if(get_next(kd, host))
634 if((kd->flags & KD_CONFIG) == 0) {
635 config_get_hosts(context, kd, "admin_server");
636 kd->flags |= KD_CONFIG;
637 if(get_next(kd, host))
641 if (kd->flags & KD_CONFIG_EXISTS)
642 return KRB5_KDC_UNREACH; /* XXX */
644 if(context->srv_lookup) {
645 if((kd->flags & KD_SRV_TCP) == 0) {
646 srv_get_hosts(context, kd, "tcp", "kerberos-adm");
647 kd->flags |= KD_SRV_TCP;
648 if(get_next(kd, host))
654 && (kd->flags & KD_FALLBACK) == 0) {
655 ret = fallback_get_hosts(context, kd, "kerberos",
657 krbhst_get_default_proto(kd));
660 kd->flags |= KD_FALLBACK;
661 if(get_next(kd, host))
665 return KRB5_KDC_UNREACH; /* XXX */
668 static krb5_error_code
669 kpasswd_get_next(krb5_context context,
670 struct krb5_krbhst_data *kd,
671 krb5_krbhst_info **host)
675 if ((kd->flags & KD_PLUGIN) == 0) {
676 plugin_get_hosts(context, kd, locate_service_kpasswd);
677 kd->flags |= KD_PLUGIN;
678 if(get_next(kd, host))
682 if((kd->flags & KD_CONFIG) == 0) {
683 config_get_hosts(context, kd, "kpasswd_server");
684 kd->flags |= KD_CONFIG;
685 if(get_next(kd, host))
689 if (kd->flags & KD_CONFIG_EXISTS)
690 return KRB5_KDC_UNREACH; /* XXX */
692 if(context->srv_lookup) {
693 if((kd->flags & KD_SRV_UDP) == 0) {
694 srv_get_hosts(context, kd, "udp", "kpasswd");
695 kd->flags |= KD_SRV_UDP;
696 if(get_next(kd, host))
699 if((kd->flags & KD_SRV_TCP) == 0) {
700 srv_get_hosts(context, kd, "tcp", "kpasswd");
701 kd->flags |= KD_SRV_TCP;
702 if(get_next(kd, host))
707 /* no matches -> try admin */
709 if (krbhst_empty(kd)) {
711 kd->port = kd->def_port;
712 kd->get_next = admin_get_next;
713 ret = (*kd->get_next)(context, kd, host);
715 (*host)->proto = krbhst_get_default_proto(kd);
719 return KRB5_KDC_UNREACH; /* XXX */
722 static krb5_error_code
723 krb524_get_next(krb5_context context,
724 struct krb5_krbhst_data *kd,
725 krb5_krbhst_info **host)
727 if ((kd->flags & KD_PLUGIN) == 0) {
728 plugin_get_hosts(context, kd, locate_service_krb524);
729 kd->flags |= KD_PLUGIN;
730 if(get_next(kd, host))
734 if((kd->flags & KD_CONFIG) == 0) {
735 config_get_hosts(context, kd, "krb524_server");
736 if(get_next(kd, host))
738 kd->flags |= KD_CONFIG;
741 if (kd->flags & KD_CONFIG_EXISTS)
742 return KRB5_KDC_UNREACH; /* XXX */
744 if(context->srv_lookup) {
745 if((kd->flags & KD_SRV_UDP) == 0) {
746 srv_get_hosts(context, kd, "udp", "krb524");
747 kd->flags |= KD_SRV_UDP;
748 if(get_next(kd, host))
752 if((kd->flags & KD_SRV_TCP) == 0) {
753 srv_get_hosts(context, kd, "tcp", "krb524");
754 kd->flags |= KD_SRV_TCP;
755 if(get_next(kd, host))
760 /* no matches -> try kdc */
762 if (krbhst_empty(kd)) {
764 kd->port = kd->def_port;
765 kd->get_next = kdc_get_next;
766 return (*kd->get_next)(context, kd, host);
769 return KRB5_KDC_UNREACH; /* XXX */
772 static struct krb5_krbhst_data*
773 common_init(krb5_context context,
777 struct krb5_krbhst_data *kd;
779 if((kd = calloc(1, sizeof(*kd))) == NULL)
782 if((kd->realm = strdup(realm)) == NULL) {
787 /* For 'realms' without a . do not even think of going to DNS */
788 if (!strchr(realm, '.'))
789 kd->flags |= KD_CONFIG_EXISTS;
791 if (flags & KRB5_KRBHST_FLAGS_LARGE_MSG)
792 kd->flags |= KD_LARGE_MSG;
793 kd->end = kd->index = &kd->hosts;
798 * initialize `handle' to look for hosts of type `type' in realm `realm'
801 krb5_error_code KRB5_LIB_FUNCTION
802 krb5_krbhst_init(krb5_context context,
805 krb5_krbhst_handle *handle)
807 return krb5_krbhst_init_flags(context, realm, type, 0, handle);
810 krb5_error_code KRB5_LIB_FUNCTION
811 krb5_krbhst_init_flags(krb5_context context,
815 krb5_krbhst_handle *handle)
817 struct krb5_krbhst_data *kd;
818 krb5_error_code (*next)(krb5_context, struct krb5_krbhst_data *,
819 krb5_krbhst_info **);
823 case KRB5_KRBHST_KDC:
825 def_port = ntohs(krb5_getportbyname (context, "kerberos", "udp", 88));
827 case KRB5_KRBHST_ADMIN:
828 next = admin_get_next;
829 def_port = ntohs(krb5_getportbyname (context, "kerberos-adm",
832 case KRB5_KRBHST_CHANGEPW:
833 next = kpasswd_get_next;
834 def_port = ntohs(krb5_getportbyname (context, "kpasswd", "udp",
837 case KRB5_KRBHST_KRB524:
838 next = krb524_get_next;
839 def_port = ntohs(krb5_getportbyname (context, "krb524", "udp", 4444));
842 krb5_set_error_message(context, ENOTTY,
843 N_("unknown krbhst type (%u)", ""), type);
846 if((kd = common_init(context, realm, flags)) == NULL)
849 kd->def_port = def_port;
855 * return the next host information from `handle' in `host'
858 krb5_error_code KRB5_LIB_FUNCTION
859 krb5_krbhst_next(krb5_context context,
860 krb5_krbhst_handle handle,
861 krb5_krbhst_info **host)
863 if(get_next(handle, host))
866 return (*handle->get_next)(context, handle, host);
870 * return the next host information from `handle' as a host name
871 * in `hostname' (or length `hostlen)
874 krb5_error_code KRB5_LIB_FUNCTION
875 krb5_krbhst_next_as_string(krb5_context context,
876 krb5_krbhst_handle handle,
881 krb5_krbhst_info *host;
882 ret = krb5_krbhst_next(context, handle, &host);
885 return krb5_krbhst_format_string(context, host, hostname, hostlen);
889 void KRB5_LIB_FUNCTION
890 krb5_krbhst_reset(krb5_context context, krb5_krbhst_handle handle)
892 handle->index = &handle->hosts;
895 void KRB5_LIB_FUNCTION
896 krb5_krbhst_free(krb5_context context, krb5_krbhst_handle handle)
898 krb5_krbhst_info *h, *next;
903 for (h = handle->hosts; h != NULL; h = next) {
905 _krb5_free_krbhst_info(h);
912 /* backwards compatibility ahead */
914 static krb5_error_code
915 gethostlist(krb5_context context, const char *realm,
916 unsigned int type, char ***hostlist)
920 krb5_krbhst_handle handle;
921 char host[MAXHOSTNAMELEN];
922 krb5_krbhst_info *hostinfo;
924 ret = krb5_krbhst_init(context, realm, type, &handle);
928 while(krb5_krbhst_next(context, handle, &hostinfo) == 0)
931 krb5_set_error_message(context, KRB5_KDC_UNREACH,
932 N_("No KDC found for realm %s", ""), realm);
933 return KRB5_KDC_UNREACH;
935 *hostlist = calloc(nhost + 1, sizeof(**hostlist));
936 if(*hostlist == NULL) {
937 krb5_krbhst_free(context, handle);
941 krb5_krbhst_reset(context, handle);
943 while(krb5_krbhst_next_as_string(context, handle,
944 host, sizeof(host)) == 0) {
945 if(((*hostlist)[nhost++] = strdup(host)) == NULL) {
946 krb5_free_krbhst(context, *hostlist);
947 krb5_krbhst_free(context, handle);
951 (*hostlist)[nhost++] = NULL;
952 krb5_krbhst_free(context, handle);
957 * return an malloced list of kadmin-hosts for `realm' in `hostlist'
960 krb5_error_code KRB5_LIB_FUNCTION
961 krb5_get_krb_admin_hst (krb5_context context,
962 const krb5_realm *realm,
965 return gethostlist(context, *realm, KRB5_KRBHST_ADMIN, hostlist);
969 * return an malloced list of changepw-hosts for `realm' in `hostlist'
972 krb5_error_code KRB5_LIB_FUNCTION
973 krb5_get_krb_changepw_hst (krb5_context context,
974 const krb5_realm *realm,
977 return gethostlist(context, *realm, KRB5_KRBHST_CHANGEPW, hostlist);
981 * return an malloced list of 524-hosts for `realm' in `hostlist'
984 krb5_error_code KRB5_LIB_FUNCTION
985 krb5_get_krb524hst (krb5_context context,
986 const krb5_realm *realm,
989 return gethostlist(context, *realm, KRB5_KRBHST_KRB524, hostlist);
994 * return an malloced list of KDC's for `realm' in `hostlist'
997 krb5_error_code KRB5_LIB_FUNCTION
998 krb5_get_krbhst (krb5_context context,
999 const krb5_realm *realm,
1002 return gethostlist(context, *realm, KRB5_KRBHST_KDC, hostlist);
1006 * free all the memory allocated in `hostlist'
1009 krb5_error_code KRB5_LIB_FUNCTION
1010 krb5_free_krbhst (krb5_context context,
1015 for (p = hostlist; *p; ++p)