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"
39 string_to_proto(const char *string)
41 if(strcasecmp(string, "udp") == 0)
42 return KRB5_KRBHST_UDP;
43 else if(strcasecmp(string, "tcp") == 0)
44 return KRB5_KRBHST_TCP;
45 else if(strcasecmp(string, "http") == 0)
46 return KRB5_KRBHST_HTTP;
51 * set `res' and `count' to the result of looking up SRV RR in DNS for
52 * `proto', `proto', `realm' using `dns_type'.
53 * if `port' != 0, force that port number
56 static krb5_error_code
57 srv_find_realm(krb5_context context, krb5_krbhst_info ***res, int *count,
58 const char *realm, const char *dns_type,
59 const char *proto, const char *service, int port)
62 struct rk_dns_reply *r;
63 struct rk_resource_record *rr;
71 proto_num = string_to_proto(proto);
73 krb5_set_error_message(context, EINVAL,
74 N_("unknown protocol `%s' to lookup", ""),
79 if(proto_num == KRB5_KRBHST_HTTP)
80 def_port = ntohs(krb5_getportbyname (context, "http", "tcp", 80));
82 def_port = ntohs(krb5_getportbyname (context, service, proto, 88));
86 snprintf(domain, sizeof(domain), "_%s._%s.%s.", service, proto, realm);
88 r = rk_dns_lookup(domain, dns_type);
90 _krb5_debug(context, 0,
91 "DNS lookup failed domain: %s", domain);
92 return KRB5_KDC_UNREACH;
95 for(num_srv = 0, rr = r->head; rr; rr = rr->next)
96 if(rr->type == rk_ns_t_srv)
99 *res = malloc(num_srv * sizeof(**res));
102 krb5_set_error_message(context, ENOMEM,
103 N_("malloc: out of memory", ""));
109 for(num_srv = 0, rr = r->head; rr; rr = rr->next)
110 if(rr->type == rk_ns_t_srv) {
111 krb5_krbhst_info *hi;
112 size_t len = strlen(rr->u.srv->target);
114 hi = calloc(1, sizeof(*hi) + len);
117 while(--num_srv >= 0)
118 free((*res)[num_srv]);
123 (*res)[num_srv++] = hi;
125 hi->proto = proto_num;
127 hi->def_port = def_port;
131 hi->port = rr->u.srv->port;
133 strlcpy(hi->hostname, rr->u.srv->target, len + 1);
143 struct krb5_krbhst_data {
147 int port; /* hardwired port number if != 0 */
151 #define KD_SRV_HTTP 8
152 #define KD_FALLBACK 16
153 #define KD_CONFIG_EXISTS 32
154 #define KD_LARGE_MSG 64
155 #define KD_PLUGIN 128
156 krb5_error_code (*get_next)(krb5_context, struct krb5_krbhst_data *,
159 unsigned int fallback_count;
160 unsigned int try_count;
162 struct krb5_krbhst_info *hosts, **index, **end;
166 krbhst_empty(const struct krb5_krbhst_data *kd)
168 return kd->index == &kd->hosts;
172 * Return the default protocol for the `kd' (either TCP or UDP)
176 krbhst_get_default_proto(struct krb5_krbhst_data *kd)
178 if (kd->flags & KD_LARGE_MSG)
179 return KRB5_KRBHST_TCP;
180 return KRB5_KRBHST_UDP;
188 _krb5_krbhst_get_realm(krb5_krbhst_handle handle)
190 return handle->realm;
194 * parse `spec' into a krb5_krbhst_info, defaulting the port to `def_port'
195 * and forcing it to `port' if port != 0
198 static struct krb5_krbhst_info*
199 parse_hostspec(krb5_context context, struct krb5_krbhst_data *kd,
200 const char *spec, int def_port, int port)
202 const char *p = spec, *q;
203 struct krb5_krbhst_info *hi;
205 hi = calloc(1, sizeof(*hi) + strlen(spec));
209 hi->proto = krbhst_get_default_proto(kd);
211 if(strncmp(p, "http://", 7) == 0){
212 hi->proto = KRB5_KRBHST_HTTP;
214 } else if(strncmp(p, "http/", 5) == 0) {
215 hi->proto = KRB5_KRBHST_HTTP;
217 def_port = ntohs(krb5_getportbyname (context, "http", "tcp", 80));
218 }else if(strncmp(p, "tcp/", 4) == 0){
219 hi->proto = KRB5_KRBHST_TCP;
221 } else if(strncmp(p, "udp/", 4) == 0) {
225 if (p[0] == '[' && (q = strchr(p, ']')) != NULL) {
226 /* if address looks like [foo:bar] or [foo:bar]: its a ipv6
227 adress, strip of [] */
228 memcpy(hi->hostname, &p[1], q - p - 1);
229 hi->hostname[q - p - 1] = '\0';
234 } else if(strsep_copy(&p, ":", hi->hostname, strlen(spec) + 1) < 0) {
235 /* copy everything before : */
239 /* get rid of trailing /, and convert to lower case */
240 hi->hostname[strcspn(hi->hostname, "/")] = '\0';
241 strlwr(hi->hostname);
243 hi->port = hi->def_port = def_port;
244 if(p != NULL && p[0]) {
246 hi->port = strtol(p, &end, 0);
258 _krb5_free_krbhst_info(krb5_krbhst_info *hi)
261 freeaddrinfo(hi->ai);
266 _krb5_krbhost_info_move(krb5_context context,
267 krb5_krbhst_info *from,
268 krb5_krbhst_info **to)
270 size_t hostnamelen = strlen(from->hostname);
271 /* trailing NUL is included in structure */
272 *to = calloc(1, sizeof(**to) + hostnamelen);
274 krb5_set_error_message(context, ENOMEM,
275 N_("malloc: out of memory", ""));
279 (*to)->proto = from->proto;
280 (*to)->port = from->port;
281 (*to)->def_port = from->def_port;
282 (*to)->ai = from->ai;
285 memcpy((*to)->hostname, from->hostname, hostnamelen + 1);
291 append_host_hostinfo(struct krb5_krbhst_data *kd, struct krb5_krbhst_info *host)
293 struct krb5_krbhst_info *h;
295 for(h = kd->hosts; h; h = h->next)
296 if(h->proto == host->proto &&
297 h->port == host->port &&
298 strcmp(h->hostname, host->hostname) == 0) {
299 _krb5_free_krbhst_info(host);
303 kd->end = &host->next;
306 static krb5_error_code
307 append_host_string(krb5_context context, struct krb5_krbhst_data *kd,
308 const char *host, int def_port, int port)
310 struct krb5_krbhst_info *hi;
312 hi = parse_hostspec(context, kd, host, def_port, port);
316 append_host_hostinfo(kd, hi);
321 * return a readable representation of `host' in `hostname, hostlen'
324 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
325 krb5_krbhst_format_string(krb5_context context, const krb5_krbhst_info *host,
326 char *hostname, size_t hostlen)
328 const char *proto = "";
329 char portstr[7] = "";
330 if(host->proto == KRB5_KRBHST_TCP)
332 else if(host->proto == KRB5_KRBHST_HTTP)
334 if(host->port != host->def_port)
335 snprintf(portstr, sizeof(portstr), ":%d", host->port);
336 snprintf(hostname, hostlen, "%s%s%s", proto, host->hostname, portstr);
341 * create a getaddrinfo `hints' based on `proto'
345 make_hints(struct addrinfo *hints, int proto)
347 memset(hints, 0, sizeof(*hints));
348 hints->ai_family = AF_UNSPEC;
350 case KRB5_KRBHST_UDP :
351 hints->ai_socktype = SOCK_DGRAM;
353 case KRB5_KRBHST_HTTP :
354 case KRB5_KRBHST_TCP :
355 hints->ai_socktype = SOCK_STREAM;
361 * Return an `struct addrinfo *' for a KDC host.
363 * Returns an the struct addrinfo in in that corresponds to the
364 * information in `host'. free:ing is handled by krb5_krbhst_free, so
365 * the returned ai must not be released.
370 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
371 krb5_krbhst_get_addrinfo(krb5_context context, krb5_krbhst_info *host,
372 struct addrinfo **ai)
376 if (host->ai == NULL) {
377 struct addrinfo hints;
378 char portstr[NI_MAXSERV];
379 char *hostname = host->hostname;
381 snprintf (portstr, sizeof(portstr), "%d", host->port);
382 make_hints(&hints, host->proto);
385 * First try this as an IP address, this allows us to add a
386 * dot at the end to stop using the search domains.
389 hints.ai_flags |= AI_NUMERICHOST | AI_NUMERICSERV;
391 ret = getaddrinfo(host->hostname, portstr, &hints, &host->ai);
396 * If the hostname contains a dot, assumes it's a FQDN and
397 * don't use search domains since that might be painfully slow
398 * when machine is disconnected from that network.
401 hints.ai_flags &= ~(AI_NUMERICHOST);
403 if (strchr(hostname, '.') && hostname[strlen(hostname) - 1] != '.') {
404 ret = asprintf(&hostname, "%s.", host->hostname);
405 if (ret < 0 || hostname == NULL)
409 ret = getaddrinfo(hostname, portstr, &hints, &host->ai);
410 if (hostname != host->hostname)
413 ret = krb5_eai_to_heim_errno(ret, errno);
423 get_next(struct krb5_krbhst_data *kd, krb5_krbhst_info **host)
425 struct krb5_krbhst_info *hi = *kd->index;
428 kd->index = &(*kd->index)->next;
435 srv_get_hosts(krb5_context context, struct krb5_krbhst_data *kd,
436 const char *proto, const char *service)
439 krb5_krbhst_info **res;
442 ret = srv_find_realm(context, &res, &count, kd->realm, "SRV", proto, service,
444 _krb5_debug(context, 2, "searching DNS for realm %s %s.%s -> %d",
445 kd->realm, proto, service, ret);
448 for(i = 0; i < count; i++)
449 append_host_hostinfo(kd, res[i]);
454 * read the configuration for `conf_string', defaulting to kd->def_port and
455 * forcing it to `kd->port' if kd->port != 0
459 config_get_hosts(krb5_context context, struct krb5_krbhst_data *kd,
460 const char *conf_string)
464 hostlist = krb5_config_get_strings(context, NULL,
465 "realms", kd->realm, conf_string, NULL);
467 _krb5_debug(context, 2, "configuration file for realm %s%s found",
468 kd->realm, hostlist ? "" : " not");
472 kd->flags |= KD_CONFIG_EXISTS;
473 for(i = 0; hostlist && hostlist[i] != NULL; i++)
474 append_host_string(context, kd, hostlist[i], kd->def_port, kd->port);
476 krb5_config_free_strings(hostlist);
480 * as a fallback, look for `serv_string.kd->realm' (typically
481 * kerberos.REALM, kerberos-1.REALM, ...
482 * `port' is the default port for the service, and `proto' the
486 static krb5_error_code
487 fallback_get_hosts(krb5_context context, struct krb5_krbhst_data *kd,
488 const char *serv_string, int port, int proto)
493 struct addrinfo hints;
494 char portstr[NI_MAXSERV];
496 _krb5_debug(context, 2, "fallback lookup %d for realm %s (service %s)",
497 kd->fallback_count, kd->realm, serv_string);
500 * Don't try forever in case the DNS server keep returning us
501 * entries (like wildcard entries or the .nu TLD)
503 if(kd->fallback_count >= 5) {
504 kd->flags |= KD_FALLBACK;
508 if(kd->fallback_count == 0)
509 ret = asprintf(&host, "%s.%s.", serv_string, kd->realm);
511 ret = asprintf(&host, "%s-%d.%s.",
512 serv_string, kd->fallback_count, kd->realm);
514 if (ret < 0 || host == NULL)
517 make_hints(&hints, proto);
518 snprintf(portstr, sizeof(portstr), "%d", port);
519 ret = getaddrinfo(host, portstr, &hints, &ai);
521 /* no more hosts, so we're done here */
523 kd->flags |= KD_FALLBACK;
525 struct krb5_krbhst_info *hi;
526 size_t hostlen = strlen(host);
528 hi = calloc(1, sizeof(*hi) + hostlen);
535 hi->port = hi->def_port = port;
537 memmove(hi->hostname, host, hostlen);
538 hi->hostname[hostlen] = '\0';
540 append_host_hostinfo(kd, hi);
541 kd->fallback_count++;
547 * Fetch hosts from plugin
550 static krb5_error_code
551 add_locate(void *ctx, int type, struct sockaddr *addr)
553 struct krb5_krbhst_info *hi;
554 struct krb5_krbhst_data *kd = ctx;
555 char host[NI_MAXHOST], port[NI_MAXSERV];
556 struct addrinfo hints, *ai;
561 socklen = socket_sockaddr_size(addr);
563 ret = getnameinfo(addr, socklen, host, sizeof(host), port, sizeof(port),
564 NI_NUMERICHOST|NI_NUMERICSERV);
568 make_hints(&hints, krbhst_get_default_proto(kd));
569 ret = getaddrinfo(host, port, &hints, &ai);
573 hostlen = strlen(host);
575 hi = calloc(1, sizeof(*hi) + hostlen);
579 hi->proto = krbhst_get_default_proto(kd);
580 hi->port = hi->def_port = socket_get_port(addr);
582 memmove(hi->hostname, host, hostlen);
583 hi->hostname[hostlen] = '\0';
584 append_host_hostinfo(kd, hi);
590 plugin_get_hosts(krb5_context context,
591 struct krb5_krbhst_data *kd,
592 enum locate_service_type type)
594 struct krb5_plugin *list = NULL, *e;
597 ret = _krb5_plugin_find(context, PLUGIN_TYPE_DATA,
598 KRB5_PLUGIN_LOCATE, &list);
599 if(ret != 0 || list == NULL)
602 for (e = list; e != NULL; e = _krb5_plugin_get_next(e)) {
603 krb5plugin_service_locate_ftable *service;
606 service = _krb5_plugin_get_symbol(e);
607 if (service->minor_version != 0)
610 (*service->init)(context, &ctx);
611 ret = (*service->lookup)(ctx, type, kd->realm, 0, 0, add_locate, kd);
612 (*service->fini)(ctx);
613 if (ret && ret != KRB5_PLUGIN_NO_HANDLE) {
614 krb5_set_error_message(context, ret,
615 N_("Locate plugin failed to lookup realm %s: %d", ""),
618 } else if (ret == 0) {
619 _krb5_debug(context, 2, "plugin found result for realm %s", kd->realm);
620 kd->flags |= KD_CONFIG_EXISTS;
624 _krb5_plugin_free(list);
631 static krb5_error_code
632 kdc_get_next(krb5_context context,
633 struct krb5_krbhst_data *kd,
634 krb5_krbhst_info **host)
638 if ((kd->flags & KD_PLUGIN) == 0) {
639 plugin_get_hosts(context, kd, locate_service_kdc);
640 kd->flags |= KD_PLUGIN;
641 if(get_next(kd, host))
645 if((kd->flags & KD_CONFIG) == 0) {
646 config_get_hosts(context, kd, "kdc");
647 kd->flags |= KD_CONFIG;
648 if(get_next(kd, host))
652 if (kd->flags & KD_CONFIG_EXISTS) {
653 _krb5_debug(context, 1,
654 "Configuration exists for realm %s, wont go to DNS",
656 return KRB5_KDC_UNREACH;
659 if(context->srv_lookup) {
660 if((kd->flags & KD_SRV_UDP) == 0 && (kd->flags & KD_LARGE_MSG) == 0) {
661 srv_get_hosts(context, kd, "udp", "kerberos");
662 kd->flags |= KD_SRV_UDP;
663 if(get_next(kd, host))
667 if((kd->flags & KD_SRV_TCP) == 0) {
668 srv_get_hosts(context, kd, "tcp", "kerberos");
669 kd->flags |= KD_SRV_TCP;
670 if(get_next(kd, host))
673 if((kd->flags & KD_SRV_HTTP) == 0) {
674 srv_get_hosts(context, kd, "http", "kerberos");
675 kd->flags |= KD_SRV_HTTP;
676 if(get_next(kd, host))
681 while((kd->flags & KD_FALLBACK) == 0) {
682 ret = fallback_get_hosts(context, kd, "kerberos",
684 krbhst_get_default_proto(kd));
687 if(get_next(kd, host))
691 _krb5_debug(context, 0, "No KDC entries found for %s", kd->realm);
693 return KRB5_KDC_UNREACH; /* XXX */
696 static krb5_error_code
697 admin_get_next(krb5_context context,
698 struct krb5_krbhst_data *kd,
699 krb5_krbhst_info **host)
703 if ((kd->flags & KD_PLUGIN) == 0) {
704 plugin_get_hosts(context, kd, locate_service_kadmin);
705 kd->flags |= KD_PLUGIN;
706 if(get_next(kd, host))
710 if((kd->flags & KD_CONFIG) == 0) {
711 config_get_hosts(context, kd, "admin_server");
712 kd->flags |= KD_CONFIG;
713 if(get_next(kd, host))
717 if (kd->flags & KD_CONFIG_EXISTS) {
718 _krb5_debug(context, 1,
719 "Configuration exists for realm %s, wont go to DNS",
721 return KRB5_KDC_UNREACH;
724 if(context->srv_lookup) {
725 if((kd->flags & KD_SRV_TCP) == 0) {
726 srv_get_hosts(context, kd, "tcp", "kerberos-adm");
727 kd->flags |= KD_SRV_TCP;
728 if(get_next(kd, host))
734 && (kd->flags & KD_FALLBACK) == 0) {
735 ret = fallback_get_hosts(context, kd, "kerberos",
737 krbhst_get_default_proto(kd));
740 kd->flags |= KD_FALLBACK;
741 if(get_next(kd, host))
745 _krb5_debug(context, 0, "No admin entries found for realm %s", kd->realm);
747 return KRB5_KDC_UNREACH; /* XXX */
750 static krb5_error_code
751 kpasswd_get_next(krb5_context context,
752 struct krb5_krbhst_data *kd,
753 krb5_krbhst_info **host)
757 if ((kd->flags & KD_PLUGIN) == 0) {
758 plugin_get_hosts(context, kd, locate_service_kpasswd);
759 kd->flags |= KD_PLUGIN;
760 if(get_next(kd, host))
764 if((kd->flags & KD_CONFIG) == 0) {
765 config_get_hosts(context, kd, "kpasswd_server");
766 kd->flags |= KD_CONFIG;
767 if(get_next(kd, host))
771 if (kd->flags & KD_CONFIG_EXISTS) {
772 _krb5_debug(context, 1,
773 "Configuration exists for realm %s, wont go to DNS",
775 return KRB5_KDC_UNREACH;
778 if(context->srv_lookup) {
779 if((kd->flags & KD_SRV_UDP) == 0) {
780 srv_get_hosts(context, kd, "udp", "kpasswd");
781 kd->flags |= KD_SRV_UDP;
782 if(get_next(kd, host))
785 if((kd->flags & KD_SRV_TCP) == 0) {
786 srv_get_hosts(context, kd, "tcp", "kpasswd");
787 kd->flags |= KD_SRV_TCP;
788 if(get_next(kd, host))
793 /* no matches -> try admin */
795 if (krbhst_empty(kd)) {
797 kd->port = kd->def_port;
798 kd->get_next = admin_get_next;
799 ret = (*kd->get_next)(context, kd, host);
801 (*host)->proto = krbhst_get_default_proto(kd);
805 _krb5_debug(context, 0, "No kpasswd entries found for realm %s", kd->realm);
807 return KRB5_KDC_UNREACH;
810 static krb5_error_code
811 krb524_get_next(krb5_context context,
812 struct krb5_krbhst_data *kd,
813 krb5_krbhst_info **host)
815 if ((kd->flags & KD_PLUGIN) == 0) {
816 plugin_get_hosts(context, kd, locate_service_krb524);
817 kd->flags |= KD_PLUGIN;
818 if(get_next(kd, host))
822 if((kd->flags & KD_CONFIG) == 0) {
823 config_get_hosts(context, kd, "krb524_server");
824 if(get_next(kd, host))
826 kd->flags |= KD_CONFIG;
829 if (kd->flags & KD_CONFIG_EXISTS) {
830 _krb5_debug(context, 1,
831 "Configuration exists for realm %s, wont go to DNS",
833 return KRB5_KDC_UNREACH;
836 if(context->srv_lookup) {
837 if((kd->flags & KD_SRV_UDP) == 0) {
838 srv_get_hosts(context, kd, "udp", "krb524");
839 kd->flags |= KD_SRV_UDP;
840 if(get_next(kd, host))
844 if((kd->flags & KD_SRV_TCP) == 0) {
845 srv_get_hosts(context, kd, "tcp", "krb524");
846 kd->flags |= KD_SRV_TCP;
847 if(get_next(kd, host))
852 /* no matches -> try kdc */
854 if (krbhst_empty(kd)) {
856 kd->port = kd->def_port;
857 kd->get_next = kdc_get_next;
858 return (*kd->get_next)(context, kd, host);
861 _krb5_debug(context, 0, "No kpasswd entries found for realm %s", kd->realm);
863 return KRB5_KDC_UNREACH;
866 static struct krb5_krbhst_data*
867 common_init(krb5_context context,
872 struct krb5_krbhst_data *kd;
874 if((kd = calloc(1, sizeof(*kd))) == NULL)
877 if((kd->realm = strdup(realm)) == NULL) {
882 _krb5_debug(context, 2, "Trying to find service %s for realm %s flags %x",
883 service, realm, flags);
885 /* For 'realms' without a . do not even think of going to DNS */
886 if (!strchr(realm, '.'))
887 kd->flags |= KD_CONFIG_EXISTS;
889 if (flags & KRB5_KRBHST_FLAGS_LARGE_MSG)
890 kd->flags |= KD_LARGE_MSG;
891 kd->end = kd->index = &kd->hosts;
896 * initialize `handle' to look for hosts of type `type' in realm `realm'
899 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
900 krb5_krbhst_init(krb5_context context,
903 krb5_krbhst_handle *handle)
905 return krb5_krbhst_init_flags(context, realm, type, 0, handle);
908 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
909 krb5_krbhst_init_flags(krb5_context context,
913 krb5_krbhst_handle *handle)
915 struct krb5_krbhst_data *kd;
916 krb5_error_code (*next)(krb5_context, struct krb5_krbhst_data *,
917 krb5_krbhst_info **);
922 case KRB5_KRBHST_KDC:
924 def_port = ntohs(krb5_getportbyname (context, "kerberos", "udp", 88));
927 case KRB5_KRBHST_ADMIN:
928 next = admin_get_next;
929 def_port = ntohs(krb5_getportbyname (context, "kerberos-adm",
933 case KRB5_KRBHST_CHANGEPW:
934 next = kpasswd_get_next;
935 def_port = ntohs(krb5_getportbyname (context, "kpasswd", "udp",
937 service = "change_password";
939 case KRB5_KRBHST_KRB524:
940 next = krb524_get_next;
941 def_port = ntohs(krb5_getportbyname (context, "krb524", "udp", 4444));
945 krb5_set_error_message(context, ENOTTY,
946 N_("unknown krbhst type (%u)", ""), type);
949 if((kd = common_init(context, service, realm, flags)) == NULL)
952 kd->def_port = def_port;
958 * return the next host information from `handle' in `host'
961 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
962 krb5_krbhst_next(krb5_context context,
963 krb5_krbhst_handle handle,
964 krb5_krbhst_info **host)
966 if(get_next(handle, host))
969 return (*handle->get_next)(context, handle, host);
973 * return the next host information from `handle' as a host name
974 * in `hostname' (or length `hostlen)
977 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
978 krb5_krbhst_next_as_string(krb5_context context,
979 krb5_krbhst_handle handle,
984 krb5_krbhst_info *host;
985 ret = krb5_krbhst_next(context, handle, &host);
988 return krb5_krbhst_format_string(context, host, hostname, hostlen);
992 KRB5_LIB_FUNCTION void KRB5_LIB_CALL
993 krb5_krbhst_reset(krb5_context context, krb5_krbhst_handle handle)
995 handle->index = &handle->hosts;
998 KRB5_LIB_FUNCTION void KRB5_LIB_CALL
999 krb5_krbhst_free(krb5_context context, krb5_krbhst_handle handle)
1001 krb5_krbhst_info *h, *next;
1006 for (h = handle->hosts; h != NULL; h = next) {
1008 _krb5_free_krbhst_info(h);
1011 free(handle->realm);
1015 void KRB5_LIB_FUNCTION
1016 krb5_krbhst_retry(krb5_context context, krb5_krbhst_handle handle)
1018 ++handle->try_count;
1021 krb5_boolean KRB5_LIB_FUNCTION
1022 krb5_krbhst_retry_exceeded(krb5_context context, krb5_krbhst_handle handle)
1024 if (handle->try_count >= context->max_retries)
1030 /* backwards compatibility ahead */
1032 static krb5_error_code
1033 gethostlist(krb5_context context, const char *realm,
1034 unsigned int type, char ***hostlist)
1036 krb5_error_code ret;
1038 krb5_krbhst_handle handle;
1039 char host[MAXHOSTNAMELEN];
1040 krb5_krbhst_info *hostinfo;
1042 ret = krb5_krbhst_init(context, realm, type, &handle);
1046 while(krb5_krbhst_next(context, handle, &hostinfo) == 0)
1049 krb5_set_error_message(context, KRB5_KDC_UNREACH,
1050 N_("No KDC found for realm %s", ""), realm);
1051 return KRB5_KDC_UNREACH;
1053 *hostlist = calloc(nhost + 1, sizeof(**hostlist));
1054 if(*hostlist == NULL) {
1055 krb5_krbhst_free(context, handle);
1059 krb5_krbhst_reset(context, handle);
1061 while(krb5_krbhst_next_as_string(context, handle,
1062 host, sizeof(host)) == 0) {
1063 if(((*hostlist)[nhost++] = strdup(host)) == NULL) {
1064 krb5_free_krbhst(context, *hostlist);
1065 krb5_krbhst_free(context, handle);
1069 (*hostlist)[nhost] = NULL;
1070 krb5_krbhst_free(context, handle);
1075 * return an malloced list of kadmin-hosts for `realm' in `hostlist'
1078 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1079 krb5_get_krb_admin_hst (krb5_context context,
1080 const krb5_realm *realm,
1083 return gethostlist(context, *realm, KRB5_KRBHST_ADMIN, hostlist);
1087 * return an malloced list of changepw-hosts for `realm' in `hostlist'
1090 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1091 krb5_get_krb_changepw_hst (krb5_context context,
1092 const krb5_realm *realm,
1095 return gethostlist(context, *realm, KRB5_KRBHST_CHANGEPW, hostlist);
1099 * return an malloced list of 524-hosts for `realm' in `hostlist'
1102 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1103 krb5_get_krb524hst (krb5_context context,
1104 const krb5_realm *realm,
1107 return gethostlist(context, *realm, KRB5_KRBHST_KRB524, hostlist);
1112 * return an malloced list of KDC's for `realm' in `hostlist'
1115 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1116 krb5_get_krbhst (krb5_context context,
1117 const krb5_realm *realm,
1120 return gethostlist(context, *realm, KRB5_KRBHST_KDC, hostlist);
1124 * free all the memory allocated in `hostlist'
1127 KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL
1128 krb5_free_krbhst (krb5_context context,
1133 for (p = hostlist; *p; ++p)