Code tidies to remove stuff that was needed only for the old test suite.
[exim.git] / src / src / host.c
1 /* $Cambridge: exim/src/src/host.c,v 1.22 2006/02/16 10:05:33 ph10 Exp $ */
2
3 /*************************************************
4 *     Exim - an Internet mail transport agent    *
5 *************************************************/
6
7 /* Copyright (c) University of Cambridge 1995 - 2006 */
8 /* See the file NOTICE for conditions of use and distribution. */
9
10 /* Functions for finding hosts, either by gethostbyname(), gethostbyaddr(), or
11 directly via the DNS. When IPv6 is supported, getipnodebyname() and
12 getipnodebyaddr() may be used instead of gethostbyname() and gethostbyaddr(),
13 if the newer functions are available. This module also contains various other
14 functions concerned with hosts and addresses, and a random number function,
15 used for randomizing hosts with equal MXs but available for use in other parts
16 of Exim. */
17
18
19 #include "exim.h"
20
21
22 /* Static variable for preserving the list of interface addresses in case it is
23 used more than once. */
24
25 static ip_address_item *local_interface_data = NULL;
26
27
28 #ifdef USE_INET_NTOA_FIX
29 /*************************************************
30 *         Replacement for broken inet_ntoa()     *
31 *************************************************/
32
33 /* On IRIX systems, gcc uses a different structure passing convention to the
34 native libraries. This causes inet_ntoa() to always yield 0.0.0.0 or
35 255.255.255.255. To get round this, we provide a private version of the
36 function here. It is used only if USE_INET_NTOA_FIX is set, which should happen
37 only when gcc is in use on an IRIX system. Code send to me by J.T. Breitner,
38 with these comments:
39
40   code by Stuart Levy
41   as seen in comp.sys.sgi.admin
42
43 August 2005: Apparently this is also needed for AIX systems; USE_INET_NTOA_FIX
44 should now be set for them as well.
45
46 Arguments:  sa  an in_addr structure
47 Returns:        pointer to static text string
48 */
49
50 char *
51 inet_ntoa(struct in_addr sa)
52 {
53 static uschar addr[20];
54 sprintf(addr, "%d.%d.%d.%d",
55         (US &sa.s_addr)[0],
56         (US &sa.s_addr)[1],
57         (US &sa.s_addr)[2],
58         (US &sa.s_addr)[3]);
59   return addr;
60 }
61 #endif
62
63
64
65 /*************************************************
66 *              Random number generator           *
67 *************************************************/
68
69 /* This is a simple pseudo-random number generator. It does not have to be
70 very good for the uses to which it is put. When running the regression tests,
71 start with a fixed seed.
72
73 Arguments:
74   limit:    one more than the largest number required
75
76 Returns:    a pseudo-random number in the range 0 to limit-1
77 */
78
79 int
80 random_number(int limit)
81 {
82 if (random_seed == 0)
83   {
84   if (running_in_test_harness) random_seed = 42; else
85     {
86     int p = (int)getpid();
87     random_seed = (int)time(NULL) ^ ((p << 16) | p);
88     }
89   }
90 random_seed = 1103515245 * random_seed + 12345;
91 return (unsigned int)(random_seed >> 16) % limit;
92 }
93
94
95
96 /*************************************************
97 *       Replace gethostbyname() when testing     *
98 *************************************************/
99
100 /* This function is called instead of gethostbyname(), gethostbyname2(), or
101 getipnodebyname() when running in the test harness. It recognizes the name
102 "manyhome.test.ex" and generates a humungous number of IP addresses. It also
103 recognizes an unqualified "localhost" and forces it to the appropriate loopback
104 address. IP addresses are treated as literals. For other names, it uses the DNS
105 to find the host name. In the test harness, this means it will access only the
106 fake DNS resolver.
107
108 Arguments:
109   name          the host name or a textual IP address
110   af            AF_INET or AF_INET6
111   error_num     where to put an error code:
112                 HOST_NOT_FOUND/TRY_AGAIN/NO_RECOVERY/NO_DATA
113
114 Returns:        a hostent structure or NULL for an error
115 */
116
117 static struct hostent *
118 host_fake_gethostbyname(uschar *name, int af, int *error_num)
119 {
120 #if HAVE_IPV6
121 int alen = (af == AF_INET)? sizeof(struct in_addr):sizeof(struct in6_addr);
122 #else
123 int alen = sizeof(struct in_addr);
124 #endif
125
126 int ipa;
127 uschar *lname = name;
128 uschar *adds;
129 uschar **alist;
130 struct hostent *yield;
131 dns_answer dnsa;
132 dns_scan dnss;
133 dns_record *rr;
134
135 DEBUG(D_host_lookup)
136   debug_printf("using host_fake_gethostbyname for %s (%s)\n", name,
137     (af == AF_INET)? "IPv4" : "IPv6");
138
139 /* Handle the name that needs a vast number of IP addresses */
140
141 if (Ustrcmp(name, "manyhome.test.ex") == 0 && af == AF_INET)
142   {
143   int i, j;
144   yield = store_get(sizeof(struct hostent));
145   alist = store_get(2049 * sizeof(char *));
146   adds  = store_get(2048 * alen);
147   yield->h_name = CS name;
148   yield->h_aliases = NULL;
149   yield->h_addrtype = af;
150   yield->h_length = alen;
151   yield->h_addr_list = CSS alist;
152   for (i = 104; i <= 111; i++)
153     {
154     for (j = 0; j <= 255; j++)
155       {
156       *alist++ = adds;
157       *adds++ = 10;
158       *adds++ = 250;
159       *adds++ = i;
160       *adds++ = j;
161       }
162     }
163   *alist = NULL;
164   return yield;
165   }
166
167 /* Handle unqualified "localhost" */
168
169 if (Ustrcmp(name, "localhost") == 0)
170   lname = (af == AF_INET)? US"127.0.0.1" : US"::1";
171
172 /* Handle a literal IP address */
173
174 ipa = string_is_ip_address(lname, NULL);
175 if (ipa != 0)
176   {
177   if ((ipa == 4 && af == AF_INET) ||
178       (ipa == 6 && af == AF_INET6))
179     {
180     int i, n;
181     int x[4];
182     yield = store_get(sizeof(struct hostent));
183     alist = store_get(2 * sizeof(char *));
184     adds  = store_get(alen);
185     yield->h_name = CS name;
186     yield->h_aliases = NULL;
187     yield->h_addrtype = af;
188     yield->h_length = alen;
189     yield->h_addr_list = CSS alist;
190     *alist++ = adds;
191     n = host_aton(lname, x);
192     for (i = 0; i < n; i++)
193       {
194       int y = x[i];
195       *adds++ = (y >> 24) & 255;
196       *adds++ = (y >> 16) & 255;
197       *adds++ = (y >> 8) & 255;
198       *adds++ = y & 255;
199       }
200     *alist = NULL;
201     }
202
203   /* Wrong kind of literal address */
204
205   else
206     {
207     *error_num = HOST_NOT_FOUND;
208     return NULL;
209     }
210   }
211
212 /* Handle a host name */
213
214 else
215   {
216   int type = (af == AF_INET)? T_A:T_AAAA;
217   int rc = dns_lookup(&dnsa, lname, type, NULL);
218   int count = 0;
219
220   switch(rc)
221     {
222     case DNS_SUCCEED: break;
223     case DNS_NOMATCH: *error_num = HOST_NOT_FOUND; return NULL;
224     case DNS_NODATA:  *error_num = NO_DATA; return NULL;
225     case DNS_AGAIN:   *error_num = TRY_AGAIN; return NULL;
226     default:
227     case DNS_FAIL:    *error_num = NO_RECOVERY; return NULL;
228     }
229
230   for (rr = dns_next_rr(&dnsa, &dnss, RESET_ANSWERS);
231        rr != NULL;
232        rr = dns_next_rr(&dnsa, &dnss, RESET_NEXT))
233     {
234     if (rr->type == type) count++;
235     }
236
237   yield = store_get(sizeof(struct hostent));
238   alist = store_get((count + 1) * sizeof(char **));
239   adds  = store_get(count *alen);
240
241   yield->h_name = CS name;
242   yield->h_aliases = NULL;
243   yield->h_addrtype = af;
244   yield->h_length = alen;
245   yield->h_addr_list = CSS alist;
246
247   for (rr = dns_next_rr(&dnsa, &dnss, RESET_ANSWERS);
248        rr != NULL;
249        rr = dns_next_rr(&dnsa, &dnss, RESET_NEXT))
250     {
251     int i, n;
252     int x[4];
253     dns_address *da;
254     if (rr->type != type) continue;
255     da = dns_address_from_rr(&dnsa, rr);
256     *alist++ = adds;
257     n = host_aton(da->address, x);
258     for (i = 0; i < n; i++)
259       {
260       int y = x[i];
261       *adds++ = (y >> 24) & 255;
262       *adds++ = (y >> 16) & 255;
263       *adds++ = (y >> 8) & 255;
264       *adds++ = y & 255;
265       }
266     }
267   *alist = NULL;
268   }
269
270 return yield;
271 }
272
273
274
275 /*************************************************
276 *       Build chain of host items from list      *
277 *************************************************/
278
279 /* This function builds a chain of host items from a textual list of host
280 names. It does not do any lookups. If randomize is true, the chain is build in
281 a randomized order. There may be multiple groups of independently randomized
282 hosts; they are delimited by a host name consisting of just "+".
283
284 Arguments:
285   anchor      anchor for the chain
286   list        text list
287   randomize   TRUE for randomizing
288
289 Returns:      nothing
290 */
291
292 void
293 host_build_hostlist(host_item **anchor, uschar *list, BOOL randomize)
294 {
295 int sep = 0;
296 int fake_mx = MX_NONE;          /* This value is actually -1 */
297 uschar *name;
298 uschar buffer[1024];
299
300 if (list == NULL) return;
301 if (randomize) fake_mx--;       /* Start at -2 for randomizing */
302
303 *anchor = NULL;
304
305 while ((name = string_nextinlist(&list, &sep, buffer, sizeof(buffer))) != NULL)
306   {
307   host_item *h;
308
309   if (name[0] == '+' && name[1] == 0)   /* "+" delimits a randomized group */
310     {                                   /* ignore if not randomizing */
311     if (randomize) fake_mx--;
312     continue;
313     }
314
315   h = store_get(sizeof(host_item));
316   h->name = string_copy(name);
317   h->address = NULL;
318   h->port = PORT_NONE;
319   h->mx = fake_mx;
320   h->sort_key = randomize? (-fake_mx)*1000 + random_number(1000) : 0;
321   h->status = hstatus_unknown;
322   h->why = hwhy_unknown;
323   h->last_try = 0;
324
325   if (*anchor == NULL)
326     {
327     h->next = NULL;
328     *anchor = h;
329     }
330   else
331     {
332     host_item *hh = *anchor;
333     if (h->sort_key < hh->sort_key)
334       {
335       h->next = hh;
336       *anchor = h;
337       }
338     else
339       {
340       while (hh->next != NULL && h->sort_key >= (hh->next)->sort_key)
341         hh = hh->next;
342       h->next = hh->next;
343       hh->next = h;
344       }
345     }
346   }
347 }
348
349
350
351
352
353 /*************************************************
354 *        Extract port from address string        *
355 *************************************************/
356
357 /* In the spool file, and in the -oMa and -oMi options, a host plus port is
358 given as an IP address followed by a dot and a port number. This function
359 decodes this.
360
361 An alternative format for the -oMa and -oMi options is [ip address]:port which
362 is what Exim 4 uses for output, because it seems to becoming commonly used,
363 whereas the dot form confuses some programs/people. So we recognize that form
364 too.
365
366 Argument:
367   address    points to the string; if there is a port, the '.' in the string
368              is overwritten with zero to terminate the address; if the string
369              is in the [xxx]:ppp format, the address is shifted left and the
370              brackets are removed
371
372 Returns:     0 if there is no port, else the port number. If there's a syntax
373              error, leave the incoming address alone, and return 0.
374 */
375
376 int
377 host_address_extract_port(uschar *address)
378 {
379 int port = 0;
380 uschar *endptr;
381
382 /* Handle the "bracketed with colon on the end" format */
383
384 if (*address == '[')
385   {
386   uschar *rb = address + 1;
387   while (*rb != 0 && *rb != ']') rb++;
388   if (*rb++ == 0) return 0;        /* Missing ]; leave invalid address */
389   if (*rb == ':')
390     {
391     port = Ustrtol(rb + 1, &endptr, 10);
392     if (*endptr != 0) return 0;    /* Invalid port; leave invalid address */
393     }
394   else if (*rb != 0) return 0;     /* Bad syntax; leave invalid address */
395   memmove(address, address + 1, rb - address - 2);
396   rb[-2] = 0;
397   }
398
399 /* Handle the "dot on the end" format */
400
401 else
402   {
403   int skip = -3;                   /* Skip 3 dots in IPv4 addresses */
404   address--;
405   while (*(++address) != 0)
406     {
407     int ch = *address;
408     if (ch == ':') skip = 0;       /* Skip 0 dots in IPv6 addresses */
409       else if (ch == '.' && skip++ >= 0) break;
410     }
411   if (*address == 0) return 0;
412   port = Ustrtol(address + 1, &endptr, 10);
413   if (*endptr != 0) return 0;      /* Invalid port; leave invalid address */
414   *address = 0;
415   }
416
417 return port;
418 }
419
420
421 /*************************************************
422 *         Get port from a host item's name       *
423 *************************************************/
424
425 /* This function is called when finding the IP address for a host that is in a
426 list of hosts explicitly configured, such as in the manualroute router, or in a
427 fallback hosts list. We see if there is a port specification at the end of the
428 host name, and if so, remove it. A minimum length of 3 is required for the
429 original name; nothing shorter is recognized as having a port.
430
431 We test for a name ending with a sequence of digits; if preceded by colon we
432 have a port if the character before the colon is ] and the name starts with [
433 or if there are no other colons in the name (i.e. it's not an IPv6 address).
434
435 Arguments:  pointer to the host item
436 Returns:    a port number or PORT_NONE
437 */
438
439 int
440 host_item_get_port(host_item *h)
441 {
442 uschar *p;
443 int port, x;
444 int len = Ustrlen(h->name);
445
446 if (len < 3 || (p = h->name + len - 1, !isdigit(*p))) return PORT_NONE;
447
448 /* Extract potential port number */
449
450 port = *p-- - '0';
451 x = 10;
452
453 while (p > h->name + 1 && isdigit(*p))
454   {
455   port += (*p-- - '0') * x;
456   x *= 10;
457   }
458
459 /* The smallest value of p at this point is h->name + 1. */
460
461 if (*p != ':') return PORT_NONE;
462
463 if (p[-1] == ']' && h->name[0] == '[')
464   h->name = string_copyn(h->name + 1, p - h->name - 2);
465 else if (Ustrchr(h->name, ':') == p)
466   h->name = string_copyn(h->name, p - h->name);
467 else return PORT_NONE;
468
469 DEBUG(D_route|D_host_lookup) debug_printf("host=%s port=%d\n", h->name, port);
470 return port;
471 }
472
473
474
475 #ifndef STAND_ALONE    /* Omit when standalone testing */
476
477 /*************************************************
478 *     Build sender_fullhost and sender_rcvhost   *
479 *************************************************/
480
481 /* This function is called when sender_host_name and/or sender_helo_name
482 have been set. Or might have been set - for a local message read off the spool
483 they won't be. In that case, do nothing. Otherwise, set up the fullhost string
484 as follows:
485
486 (a) No sender_host_name or sender_helo_name: "[ip address]"
487 (b) Just sender_host_name: "host_name [ip address]"
488 (c) Just sender_helo_name: "(helo_name) [ip address]" unless helo is IP
489             in which case: "[ip address}"
490 (d) The two are identical: "host_name [ip address]" includes helo = IP
491 (e) The two are different: "host_name (helo_name) [ip address]"
492
493 If log_incoming_port is set, the sending host's port number is added to the IP
494 address.
495
496 This function also builds sender_rcvhost for use in Received: lines, whose
497 syntax is a bit different. This value also includes the RFC 1413 identity.
498 There wouldn't be two different variables if I had got all this right in the
499 first place.
500
501 Because this data may survive over more than one incoming SMTP message, it has
502 to be in permanent store.
503
504 Arguments:  none
505 Returns:    nothing
506 */
507
508 void
509 host_build_sender_fullhost(void)
510 {
511 BOOL show_helo = TRUE;
512 uschar *address;
513 int len;
514 int old_pool = store_pool;
515
516 if (sender_host_address == NULL) return;
517
518 store_pool = POOL_PERM;
519
520 /* Set up address, with or without the port. After discussion, it seems that
521 the only format that doesn't cause trouble is [aaaa]:pppp. However, we can't
522 use this directly as the first item for Received: because it ain't an RFC 2822
523 domain. Sigh. */
524
525 address = string_sprintf("[%s]:%d", sender_host_address, sender_host_port);
526 if ((log_extra_selector & LX_incoming_port) == 0 || sender_host_port <= 0)
527   *(Ustrrchr(address, ':')) = 0;
528
529 /* If there's no EHLO/HELO data, we can't show it. */
530
531 if (sender_helo_name == NULL) show_helo = FALSE;
532
533 /* If HELO/EHLO was followed by an IP literal, it's messy because of two
534 features of IPv6. Firstly, there's the "IPv6:" prefix (Exim is liberal and
535 doesn't require this, for historical reasons). Secondly, IPv6 addresses may not
536 be given in canonical form, so we have to canonicize them before comparing. As
537 it happens, the code works for both IPv4 and IPv6. */
538
539 else if (sender_helo_name[0] == '[' &&
540          sender_helo_name[(len=Ustrlen(sender_helo_name))-1] == ']')
541   {
542   int offset = 1;
543   uschar *helo_ip;
544
545   if (strncmpic(sender_helo_name + 1, US"IPv6:", 5) == 0) offset += 5;
546   if (strncmpic(sender_helo_name + 1, US"IPv4:", 5) == 0) offset += 5;
547
548   helo_ip = string_copyn(sender_helo_name + offset, len - offset - 1);
549
550   if (string_is_ip_address(helo_ip, NULL) != 0)
551     {
552     int x[4], y[4];
553     int sizex, sizey;
554     uschar ipx[48], ipy[48];    /* large enough for full IPv6 */
555
556     sizex = host_aton(helo_ip, x);
557     sizey = host_aton(sender_host_address, y);
558
559     (void)host_nmtoa(sizex, x, -1, ipx, ':');
560     (void)host_nmtoa(sizey, y, -1, ipy, ':');
561
562     if (strcmpic(ipx, ipy) == 0) show_helo = FALSE;
563     }
564   }
565
566 /* Host name is not verified */
567
568 if (sender_host_name == NULL)
569   {
570   uschar *portptr = Ustrstr(address, "]:");
571   int size = 0;
572   int ptr = 0;
573   int adlen;    /* Sun compiler doesn't like ++ in initializers */
574
575   adlen = (portptr == NULL)? Ustrlen(address) : (++portptr - address);
576   sender_fullhost = (sender_helo_name == NULL)? address :
577     string_sprintf("(%s) %s", sender_helo_name, address);
578
579   sender_rcvhost = string_cat(NULL, &size, &ptr, address, adlen);
580
581   if (sender_ident != NULL || show_helo || portptr != NULL)
582     {
583     int firstptr;
584     sender_rcvhost = string_cat(sender_rcvhost, &size, &ptr, US" (", 2);
585     firstptr = ptr;
586
587     if (portptr != NULL)
588       sender_rcvhost = string_append(sender_rcvhost, &size, &ptr, 2, US"port=",
589         portptr + 1);
590
591     if (show_helo)
592       sender_rcvhost = string_append(sender_rcvhost, &size, &ptr, 2,
593         (firstptr == ptr)? US"helo=" : US" helo=", sender_helo_name);
594
595     if (sender_ident != NULL)
596       sender_rcvhost = string_append(sender_rcvhost, &size, &ptr, 2,
597         (firstptr == ptr)? US"ident=" : US" ident=", sender_ident);
598
599     sender_rcvhost = string_cat(sender_rcvhost, &size, &ptr, US")", 1);
600     }
601
602   sender_rcvhost[ptr] = 0;   /* string_cat() always leaves room */
603
604   /* Release store, because string_cat allocated a minimum of 100 bytes that
605   are rarely completely used. */
606
607   store_reset(sender_rcvhost + ptr + 1);
608   }
609
610 /* Host name is known and verified. Unless we've already found that the HELO
611 data matches the IP address, compare it with the name. */
612
613 else
614   {
615   if (show_helo && strcmpic(sender_host_name, sender_helo_name) == 0)
616     show_helo = FALSE;
617
618   if (show_helo)
619     {
620     sender_fullhost = string_sprintf("%s (%s) %s", sender_host_name,
621       sender_helo_name, address);
622     sender_rcvhost = (sender_ident == NULL)?
623       string_sprintf("%s (%s helo=%s)", sender_host_name,
624         address, sender_helo_name) :
625       string_sprintf("%s\n\t(%s helo=%s ident=%s)", sender_host_name,
626         address, sender_helo_name, sender_ident);
627     }
628   else
629     {
630     sender_fullhost = string_sprintf("%s %s", sender_host_name, address);
631     sender_rcvhost = (sender_ident == NULL)?
632       string_sprintf("%s (%s)", sender_host_name, address) :
633       string_sprintf("%s (%s ident=%s)", sender_host_name, address,
634         sender_ident);
635     }
636   }
637
638 store_pool = old_pool;
639
640 DEBUG(D_host_lookup) debug_printf("sender_fullhost = %s\n", sender_fullhost);
641 DEBUG(D_host_lookup) debug_printf("sender_rcvhost = %s\n", sender_rcvhost);
642 }
643
644
645
646 /*************************************************
647 *          Build host+ident message              *
648 *************************************************/
649
650 /* Used when logging rejections and various ACL and SMTP incidents. The text
651 return depends on whether sender_fullhost and sender_ident are set or not:
652
653   no ident, no host   => U=unknown
654   no ident, host set  => H=sender_fullhost
655   ident set, no host  => U=ident
656   ident set, host set => H=sender_fullhost U=ident
657
658 Arguments:
659   useflag   TRUE if first item to be flagged (H= or U=); if there are two
660               items, the second is always flagged
661
662 Returns:    pointer to a string in big_buffer
663 */
664
665 uschar *
666 host_and_ident(BOOL useflag)
667 {
668 if (sender_fullhost == NULL)
669   {
670   (void)string_format(big_buffer, big_buffer_size, "%s%s", useflag? "U=" : "",
671      (sender_ident == NULL)? US"unknown" : sender_ident);
672   }
673 else
674   {
675   uschar *flag = useflag? US"H=" : US"";
676   uschar *iface = US"";
677   if ((log_extra_selector & LX_incoming_interface) != 0 &&
678        interface_address != NULL)
679     iface = string_sprintf(" I=[%s]:%d", interface_address, interface_port);
680   if (sender_ident == NULL)
681     (void)string_format(big_buffer, big_buffer_size, "%s%s%s",
682       flag, sender_fullhost, iface);
683   else
684     (void)string_format(big_buffer, big_buffer_size, "%s%s%s U=%s",
685       flag, sender_fullhost, iface, sender_ident);
686   }
687 return big_buffer;
688 }
689
690 #endif   /* STAND_ALONE */
691
692
693
694
695 /*************************************************
696 *         Build list of local interfaces         *
697 *************************************************/
698
699 /* This function interprets the contents of the local_interfaces or
700 extra_local_interfaces options, and creates an ip_address_item block for each
701 item on the list. There is no special interpretation of any IP addresses; in
702 particular, 0.0.0.0 and ::0 are returned without modification. If any address
703 includes a port, it is set in the block. Otherwise the port value is set to
704 zero.
705
706 Arguments:
707   list        the list
708   name        the name of the option being expanded
709
710 Returns:      a chain of ip_address_items, each containing to a textual
711               version of an IP address, and a port number (host order) or
712               zero if no port was given with the address
713 */
714
715 ip_address_item *
716 host_build_ifacelist(uschar *list, uschar *name)
717 {
718 int sep = 0;
719 uschar *s;
720 uschar buffer[64];
721 ip_address_item *yield = NULL;
722 ip_address_item *last = NULL;
723 ip_address_item *next;
724
725 while ((s = string_nextinlist(&list, &sep, buffer, sizeof(buffer))) != NULL)
726   {
727   int ipv;
728   int port = host_address_extract_port(s);            /* Leaves just the IP address */
729   if ((ipv = string_is_ip_address(s, NULL)) == 0)
730     log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Malformed IP address \"%s\" in %s",
731       s, name);
732
733   /* Skip IPv6 addresses if IPv6 is disabled. */
734
735   if (disable_ipv6 && ipv == 6) continue;
736
737   /* This use of strcpy() is OK because we have checked that s is a valid IP
738   address above. The field in the ip_address_item is large enough to hold an
739   IPv6 address. */
740
741   next = store_get(sizeof(ip_address_item));
742   next->next = NULL;
743   Ustrcpy(next->address, s);
744   next->port = port;
745   next->v6_include_v4 = FALSE;
746
747   if (yield == NULL) yield = last = next; else
748     {
749     last->next = next;
750     last = next;
751     }
752   }
753
754 return yield;
755 }
756
757
758
759
760
761 /*************************************************
762 *         Find addresses on local interfaces     *
763 *************************************************/
764
765 /* This function finds the addresses of local IP interfaces. These are used
766 when testing for routing to the local host. As the function may be called more
767 than once, the list is preserved in permanent store, pointed to by a static
768 variable, to save doing the work more than once per process.
769
770 The generic list of interfaces is obtained by calling host_build_ifacelist()
771 for local_interfaces and extra_local_interfaces. This list scanned to remove
772 duplicates (which may exist with different ports - not relevant here). If
773 either of the wildcard IP addresses (0.0.0.0 and ::0) are encountered, they are
774 replaced by the appropriate (IPv4 or IPv6) list of actual local interfaces,
775 obtained from os_find_running_interfaces().
776
777 Arguments:    none
778 Returns:      a chain of ip_address_items, each containing to a textual
779               version of an IP address; the port numbers are not relevant
780 */
781
782
783 /* First, a local subfunction to add an interface to a list in permanent store,
784 but only if there isn't a previous copy of that address on the list. */
785
786 static ip_address_item *
787 add_unique_interface(ip_address_item *list, ip_address_item *ipa)
788 {
789 ip_address_item *ipa2;
790 for (ipa2 = list; ipa2 != NULL; ipa2 = ipa2->next)
791   if (Ustrcmp(ipa2->address, ipa->address) == 0) return list;
792 ipa2 = store_get_perm(sizeof(ip_address_item));
793 *ipa2 = *ipa;
794 ipa2->next = list;
795 return ipa2;
796 }
797
798
799 /* This is the globally visible function */
800
801 ip_address_item *
802 host_find_interfaces(void)
803 {
804 ip_address_item *running_interfaces = NULL;
805
806 if (local_interface_data == NULL)
807   {
808   void *reset_item = store_get(0);
809   ip_address_item *dlist = host_build_ifacelist(local_interfaces,
810     US"local_interfaces");
811   ip_address_item *xlist = host_build_ifacelist(extra_local_interfaces,
812     US"extra_local_interfaces");
813   ip_address_item *ipa;
814
815   if (dlist == NULL) dlist = xlist; else
816     {
817     for (ipa = dlist; ipa->next != NULL; ipa = ipa->next);
818     ipa->next = xlist;
819     }
820
821   for (ipa = dlist; ipa != NULL; ipa = ipa->next)
822     {
823     if (Ustrcmp(ipa->address, "0.0.0.0") == 0 ||
824         Ustrcmp(ipa->address, "::0") == 0)
825       {
826       ip_address_item *ipa2;
827       BOOL ipv6 = ipa->address[0] == ':';
828       if (running_interfaces == NULL)
829         running_interfaces = os_find_running_interfaces();
830       for (ipa2 = running_interfaces; ipa2 != NULL; ipa2 = ipa2->next)
831         {
832         if ((Ustrchr(ipa2->address, ':') != NULL) == ipv6)
833           local_interface_data = add_unique_interface(local_interface_data,
834           ipa2);
835         }
836       }
837     else
838       {
839       local_interface_data = add_unique_interface(local_interface_data, ipa);
840       DEBUG(D_interface)
841         {
842         debug_printf("Configured local interface: address=%s", ipa->address);
843         if (ipa->port != 0) debug_printf(" port=%d", ipa->port);
844         debug_printf("\n");
845         }
846       }
847     }
848   store_reset(reset_item);
849   }
850
851 return local_interface_data;
852 }
853
854
855
856
857
858 /*************************************************
859 *        Convert network IP address to text      *
860 *************************************************/
861
862 /* Given an IPv4 or IPv6 address in binary, convert it to a text
863 string and return the result in a piece of new store. The address can
864 either be given directly, or passed over in a sockaddr structure. Note
865 that this isn't the converse of host_aton() because of byte ordering
866 differences. See host_nmtoa() below.
867
868 Arguments:
869   type       if < 0 then arg points to a sockaddr, else
870              either AF_INET or AF_INET6
871   arg        points to a sockaddr if type is < 0, or
872              points to an IPv4 address (32 bits), or
873              points to an IPv6 address (128 bits),
874              in both cases, in network byte order
875   buffer     if NULL, the result is returned in gotten store;
876              else points to a buffer to hold the answer
877   portptr    points to where to put the port number, if non NULL; only
878              used when type < 0
879
880 Returns:     pointer to character string
881 */
882
883 uschar *
884 host_ntoa(int type, const void *arg, uschar *buffer, int *portptr)
885 {
886 uschar *yield;
887
888 /* The new world. It is annoying that we have to fish out the address from
889 different places in the block, depending on what kind of address it is. It
890 is also a pain that inet_ntop() returns a const uschar *, whereas the IPv4
891 function inet_ntoa() returns just uschar *, and some picky compilers insist
892 on warning if one assigns a const uschar * to a uschar *. Hence the casts. */
893
894 #if HAVE_IPV6
895 uschar addr_buffer[46];
896 if (type < 0)
897   {
898   int family = ((struct sockaddr *)arg)->sa_family;
899   if (family == AF_INET6)
900     {
901     struct sockaddr_in6 *sk = (struct sockaddr_in6 *)arg;
902     yield = (uschar *)inet_ntop(family, &(sk->sin6_addr), CS addr_buffer,
903       sizeof(addr_buffer));
904     if (portptr != NULL) *portptr = ntohs(sk->sin6_port);
905     }
906   else
907     {
908     struct sockaddr_in *sk = (struct sockaddr_in *)arg;
909     yield = (uschar *)inet_ntop(family, &(sk->sin_addr), CS addr_buffer,
910       sizeof(addr_buffer));
911     if (portptr != NULL) *portptr = ntohs(sk->sin_port);
912     }
913   }
914 else
915   {
916   yield = (uschar *)inet_ntop(type, arg, CS addr_buffer, sizeof(addr_buffer));
917   }
918
919 /* If the result is a mapped IPv4 address, show it in V4 format. */
920
921 if (Ustrncmp(yield, "::ffff:", 7) == 0) yield += 7;
922
923 #else  /* HAVE_IPV6 */
924
925 /* The old world */
926
927 if (type < 0)
928   {
929   yield = US inet_ntoa(((struct sockaddr_in *)arg)->sin_addr);
930   if (portptr != NULL) *portptr = ntohs(((struct sockaddr_in *)arg)->sin_port);
931   }
932 else
933   yield = US inet_ntoa(*((struct in_addr *)arg));
934 #endif
935
936 /* If there is no buffer, put the string into some new store. */
937
938 if (buffer == NULL) return string_copy(yield);
939
940 /* Callers of this function with a non-NULL buffer must ensure that it is
941 large enough to hold an IPv6 address, namely, at least 46 bytes. That's what
942 makes this use of strcpy() OK. */
943
944 Ustrcpy(buffer, yield);
945 return buffer;
946 }
947
948
949
950
951 /*************************************************
952 *         Convert address text to binary         *
953 *************************************************/
954
955 /* Given the textual form of an IP address, convert it to binary in an
956 array of ints. IPv4 addresses occupy one int; IPv6 addresses occupy 4 ints.
957 The result has the first byte in the most significant byte of the first int. In
958 other words, the result is not in network byte order, but in host byte order.
959 As a result, this is not the converse of host_ntoa(), which expects network
960 byte order. See host_nmtoa() below.
961
962 Arguments:
963   address    points to the textual address, checked for syntax
964   bin        points to an array of 4 ints
965
966 Returns:     the number of ints used
967 */
968
969 int
970 host_aton(uschar *address, int *bin)
971 {
972 int x[4];
973 int v4offset = 0;
974
975 /* Handle IPv6 address, which may end with an IPv4 address. It may also end
976 with a "scope", introduced by a percent sign. This code is NOT enclosed in #if
977 HAVE_IPV6 in order that IPv6 addresses are recognized even if IPv6 is not
978 supported. */
979
980 if (Ustrchr(address, ':') != NULL)
981   {
982   uschar *p = address;
983   uschar *component[8];
984   BOOL ipv4_ends = FALSE;
985   int ci = 0;
986   int nulloffset = 0;
987   int v6count = 8;
988   int i;
989
990   /* If the address starts with a colon, it will start with two colons.
991   Just lose the first one, which will leave a null first component. */
992
993   if (*p == ':') p++;
994
995   /* Split the address into components separated by colons. The input address
996   is supposed to be checked for syntax. There was a case where this was
997   overlooked; to guard against that happening again, check here and crash if
998   there are too many components. */
999
1000   while (*p != 0 && *p != '%')
1001     {
1002     int len = Ustrcspn(p, ":%");
1003     if (len == 0) nulloffset = ci;
1004     if (ci > 7) log_write(0, LOG_MAIN|LOG_PANIC_DIE,
1005       "Internal error: invalid IPv6 address \"%s\" passed to host_aton()",
1006       address);
1007     component[ci++] = p;
1008     p += len;
1009     if (*p == ':') p++;
1010     }
1011
1012   /* If the final component contains a dot, it is a trailing v4 address.
1013   As the syntax is known to be checked, just set up for a trailing
1014   v4 address and restrict the v6 part to 6 components. */
1015
1016   if (Ustrchr(component[ci-1], '.') != NULL)
1017     {
1018     address = component[--ci];
1019     ipv4_ends = TRUE;
1020     v4offset = 3;
1021     v6count = 6;
1022     }
1023
1024   /* If there are fewer than 6 or 8 components, we have to insert some
1025   more empty ones in the middle. */
1026
1027   if (ci < v6count)
1028     {
1029     int insert_count = v6count - ci;
1030     for (i = v6count-1; i > nulloffset + insert_count; i--)
1031       component[i] = component[i - insert_count];
1032     while (i > nulloffset) component[i--] = US"";
1033     }
1034
1035   /* Now turn the components into binary in pairs and bung them
1036   into the vector of ints. */
1037
1038   for (i = 0; i < v6count; i += 2)
1039     bin[i/2] = (Ustrtol(component[i], NULL, 16) << 16) +
1040       Ustrtol(component[i+1], NULL, 16);
1041
1042   /* If there was no terminating v4 component, we are done. */
1043
1044   if (!ipv4_ends) return 4;
1045   }
1046
1047 /* Handle IPv4 address */
1048
1049 (void)sscanf(CS address, "%d.%d.%d.%d", x, x+1, x+2, x+3);
1050 bin[v4offset] = (x[0] << 24) + (x[1] << 16) + (x[2] << 8) + x[3];
1051 return v4offset+1;
1052 }
1053
1054
1055 /*************************************************
1056 *           Apply mask to an IP address          *
1057 *************************************************/
1058
1059 /* Mask an address held in 1 or 4 ints, with the ms bit in the ms bit of the
1060 first int, etc.
1061
1062 Arguments:
1063   count        the number of ints
1064   binary       points to the ints to be masked
1065   mask         the count of ms bits to leave, or -1 if no masking
1066
1067 Returns:       nothing
1068 */
1069
1070 void
1071 host_mask(int count, int *binary, int mask)
1072 {
1073 int i;
1074 if (mask < 0) mask = 99999;
1075 for (i = 0; i < count; i++)
1076   {
1077   int wordmask;
1078   if (mask == 0) wordmask = 0;
1079   else if (mask < 32)
1080     {
1081     wordmask = (-1) << (32 - mask);
1082     mask = 0;
1083     }
1084   else
1085     {
1086     wordmask = -1;
1087     mask -= 32;
1088     }
1089   binary[i] &= wordmask;
1090   }
1091 }
1092
1093
1094
1095
1096 /*************************************************
1097 *     Convert masked IP address in ints to text  *
1098 *************************************************/
1099
1100 /* We can't use host_ntoa() because it assumes the binary values are in network
1101 byte order, and these are the result of host_aton(), which puts them in ints in
1102 host byte order. Also, we really want IPv6 addresses to be in a canonical
1103 format, so we output them with no abbreviation. In a number of cases we can't
1104 use the normal colon separator in them because it terminates keys in lsearch
1105 files, so we want to use dot instead. There's an argument that specifies what
1106 to use for IPv6 addresses.
1107
1108 Arguments:
1109   count       1 or 4 (number of ints)
1110   binary      points to the ints
1111   mask        mask value; if < 0 don't add to result
1112   buffer      big enough to hold the result
1113   sep         component separator character for IPv6 addresses
1114
1115 Returns:      the number of characters placed in buffer, not counting
1116               the final nul.
1117 */
1118
1119 int
1120 host_nmtoa(int count, int *binary, int mask, uschar *buffer, int sep)
1121 {
1122 int i, j;
1123 uschar *tt = buffer;
1124
1125 if (count == 1)
1126   {
1127   j = binary[0];
1128   for (i = 24; i >= 0; i -= 8)
1129     {
1130     sprintf(CS tt, "%d.", (j >> i) & 255);
1131     while (*tt) tt++;
1132     }
1133   }
1134 else
1135   {
1136   for (i = 0; i < 4; i++)
1137     {
1138     j = binary[i];
1139     sprintf(CS tt, "%04x%c%04x%c", (j >> 16) & 0xffff, sep, j & 0xffff, sep);
1140     while (*tt) tt++;
1141     }
1142   }
1143
1144 tt--;   /* lose final separator */
1145
1146 if (mask < 0)
1147   *tt = 0;
1148 else
1149   {
1150   sprintf(CS tt, "/%d", mask);
1151   while (*tt) tt++;
1152   }
1153
1154 return tt - buffer;
1155 }
1156
1157
1158
1159 /*************************************************
1160 *        Check port for tls_on_connect           *
1161 *************************************************/
1162
1163 /* This function checks whether a given incoming port is configured for tls-
1164 on-connect. It is called from the daemon and from inetd handling. If the global
1165 option tls_on_connect is already set, all ports operate this way. Otherwise, we
1166 check the tls_on_connect_ports option for a list of ports.
1167
1168 Argument:  a port number
1169 Returns:   TRUE or FALSE
1170 */
1171
1172 BOOL
1173 host_is_tls_on_connect_port(int port)
1174 {
1175 int sep = 0;
1176 uschar buffer[32];
1177 uschar *list = tls_on_connect_ports;
1178 uschar *s;
1179
1180 if (tls_on_connect) return TRUE;
1181
1182 while ((s = string_nextinlist(&list, &sep, buffer, sizeof(buffer))) != NULL)
1183   {
1184   uschar *end;
1185   int lport = Ustrtol(s, &end, 10);
1186   if (*end != 0) log_write(0, LOG_MAIN|LOG_PANIC_DIE, "tls_on_connect_ports "
1187     "contains \"%s\", which is not a port number: exim abandoned", s);
1188   if (lport == port) return TRUE;
1189   }
1190
1191 return FALSE;
1192 }
1193
1194
1195
1196 /*************************************************
1197 *        Check whether host is in a network      *
1198 *************************************************/
1199
1200 /* This function checks whether a given IP address matches a pattern that
1201 represents either a single host, or a network (using CIDR notation). The caller
1202 of this function must check the syntax of the arguments before calling it.
1203
1204 Arguments:
1205   host        string representation of the ip-address to check
1206   net         string representation of the network, with optional CIDR mask
1207   maskoffset  offset to the / that introduces the mask in the key
1208               zero if there is no mask
1209
1210 Returns:
1211   TRUE   the host is inside the network
1212   FALSE  the host is NOT inside the network
1213 */
1214
1215 BOOL
1216 host_is_in_net(uschar *host, uschar *net, int maskoffset)
1217 {
1218 int i;
1219 int address[4];
1220 int incoming[4];
1221 int mlen;
1222 int size = host_aton(net, address);
1223 int insize;
1224
1225 /* No mask => all bits to be checked */
1226
1227 if (maskoffset == 0) mlen = 99999;    /* Big number */
1228   else mlen = Uatoi(net + maskoffset + 1);
1229
1230 /* Convert the incoming address to binary. */
1231
1232 insize = host_aton(host, incoming);
1233
1234 /* Convert IPv4 addresses given in IPv6 compatible mode, which represent
1235    connections from IPv4 hosts to IPv6 hosts, that is, addresses of the form
1236    ::ffff:<v4address>, to IPv4 format. */
1237
1238 if (insize == 4 && incoming[0] == 0 && incoming[1] == 0 &&
1239     incoming[2] == 0xffff)
1240   {
1241   insize = 1;
1242   incoming[0] = incoming[3];
1243   }
1244
1245 /* No match if the sizes don't agree. */
1246
1247 if (insize != size) return FALSE;
1248
1249 /* Else do the masked comparison. */
1250
1251 for (i = 0; i < size; i++)
1252   {
1253   int mask;
1254   if (mlen == 0) mask = 0;
1255   else if (mlen < 32)
1256     {
1257     mask = (-1) << (32 - mlen);
1258     mlen = 0;
1259     }
1260   else
1261     {
1262     mask = -1;
1263     mlen -= 32;
1264     }
1265   if ((incoming[i] & mask) != (address[i] & mask)) return FALSE;
1266   }
1267
1268 return TRUE;
1269 }
1270
1271
1272
1273 /*************************************************
1274 *       Scan host list for local hosts           *
1275 *************************************************/
1276
1277 /* Scan through a chain of addresses and check whether any of them is the
1278 address of an interface on the local machine. If so, remove that address and
1279 any previous ones with the same MX value, and all subsequent ones (which will
1280 have greater or equal MX values) from the chain. Note: marking them as unusable
1281 is NOT the right thing to do because it causes the hosts not to be used for
1282 other domains, for which they may well be correct.
1283
1284 The hosts may be part of a longer chain; we only process those between the
1285 initial pointer and the "last" pointer.
1286
1287 There is also a list of "pseudo-local" host names which are checked against the
1288 host names. Any match causes that host item to be treated the same as one which
1289 matches a local IP address.
1290
1291 If the very first host is a local host, then all MX records had a precedence
1292 greater than or equal to that of the local host. Either there's a problem in
1293 the DNS, or an apparently remote name turned out to be an abbreviation for the
1294 local host. Give a specific return code, and let the caller decide what to do.
1295 Otherwise, give a success code if at least one host address has been found.
1296
1297 Arguments:
1298   host        pointer to the first host in the chain
1299   lastptr     pointer to pointer to the last host in the chain (may be updated)
1300   removed     if not NULL, set TRUE if some local addresses were removed
1301                 from the list
1302
1303 Returns:
1304   HOST_FOUND       if there is at least one host with an IP address on the chain
1305                      and an MX value less than any MX value associated with the
1306                      local host
1307   HOST_FOUND_LOCAL if a local host is among the lowest-numbered MX hosts; when
1308                      the host addresses were obtained from A records or
1309                      gethostbyname(), the MX values are set to -1.
1310   HOST_FIND_FAILED if no valid hosts with set IP addresses were found
1311 */
1312
1313 int
1314 host_scan_for_local_hosts(host_item *host, host_item **lastptr, BOOL *removed)
1315 {
1316 int yield = HOST_FIND_FAILED;
1317 host_item *last = *lastptr;
1318 host_item *prev = NULL;
1319 host_item *h;
1320
1321 if (removed != NULL) *removed = FALSE;
1322
1323 if (local_interface_data == NULL) local_interface_data = host_find_interfaces();
1324
1325 for (h = host; h != last->next; h = h->next)
1326   {
1327   #ifndef STAND_ALONE
1328   if (hosts_treat_as_local != NULL)
1329     {
1330     int rc;
1331     uschar *save = deliver_domain;
1332     deliver_domain = h->name;   /* set $domain */
1333     rc = match_isinlist(string_copylc(h->name), &hosts_treat_as_local, 0,
1334       &domainlist_anchor, NULL, MCL_DOMAIN, TRUE, NULL);
1335     deliver_domain = save;
1336     if (rc == OK) goto FOUND_LOCAL;
1337     }
1338   #endif
1339
1340   /* It seems that on many operating systems, 0.0.0.0 is treated as a synonym
1341   for 127.0.0.1 and refers to the local host. We therefore force it always to
1342   be treated as local. */
1343
1344   if (h->address != NULL)
1345     {
1346     ip_address_item *ip;
1347     if (Ustrcmp(h->address, "0.0.0.0") == 0) goto FOUND_LOCAL;
1348     for (ip = local_interface_data; ip != NULL; ip = ip->next)
1349       if (Ustrcmp(h->address, ip->address) == 0) goto FOUND_LOCAL;
1350     yield = HOST_FOUND;  /* At least one remote address has been found */
1351     }
1352
1353   /* Update prev to point to the last host item before any that have
1354   the same MX value as the one we have just considered. */
1355
1356   if (h->next == NULL || h->next->mx != h->mx) prev = h;
1357   }
1358
1359 return yield;  /* No local hosts found: return HOST_FOUND or HOST_FIND_FAILED */
1360
1361 /* A host whose IP address matches a local IP address, or whose name matches
1362 something in hosts_treat_as_local has been found. */
1363
1364 FOUND_LOCAL:
1365
1366 if (prev == NULL)
1367   {
1368   HDEBUG(D_host_lookup) debug_printf((h->mx >= 0)?
1369     "local host has lowest MX\n" :
1370     "local host found for non-MX address\n");
1371   return HOST_FOUND_LOCAL;
1372   }
1373
1374 HDEBUG(D_host_lookup)
1375   {
1376   debug_printf("local host in host list - removed hosts:\n");
1377   for (h = prev->next; h != last->next; h = h->next)
1378     debug_printf("  %s %s %d\n", h->name, h->address, h->mx);
1379   }
1380
1381 if (removed != NULL) *removed = TRUE;
1382 prev->next = last->next;
1383 *lastptr = prev;
1384 return yield;
1385 }
1386
1387
1388
1389
1390 /*************************************************
1391 *        Remove duplicate IPs in host list       *
1392 *************************************************/
1393
1394 /* You would think that administrators could set up their DNS records so that
1395 one ended up with a list of unique IP addresses after looking up A or MX
1396 records, but apparently duplication is common. So we scan such lists and
1397 remove the later duplicates. Note that we may get lists in which some host
1398 addresses are not set.
1399
1400 Arguments:
1401   host        pointer to the first host in the chain
1402   lastptr     pointer to pointer to the last host in the chain (may be updated)
1403
1404 Returns:      nothing
1405 */
1406
1407 static void
1408 host_remove_duplicates(host_item *host, host_item **lastptr)
1409 {
1410 while (host != *lastptr)
1411   {
1412   if (host->address != NULL)
1413     {
1414     host_item *h = host;
1415     while (h != *lastptr)
1416       {
1417       if (h->next->address != NULL &&
1418           Ustrcmp(h->next->address, host->address) == 0)
1419         {
1420         DEBUG(D_host_lookup) debug_printf("duplicate IP address %s (MX=%d) "
1421           "removed\n", host->address, h->next->mx);
1422         if (h->next == *lastptr) *lastptr = h;
1423         h->next = h->next->next;
1424         }
1425       else h = h->next;
1426       }
1427     }
1428   /* If the last item was removed, host may have become == *lastptr */
1429   if (host != *lastptr) host = host->next;
1430   }
1431 }
1432
1433
1434
1435
1436 /*************************************************
1437 *    Find sender host name by gethostbyaddr()    *
1438 *************************************************/
1439
1440 /* This used to be the only way it was done, but it turns out that not all
1441 systems give aliases for calls to gethostbyaddr() - or one of the modern
1442 equivalents like getipnodebyaddr(). Fortunately, multiple PTR records are rare,
1443 but they can still exist. This function is now used only when a DNS lookup of
1444 the IP address fails, in order to give access to /etc/hosts.
1445
1446 Arguments:   none
1447 Returns:     OK, DEFER, FAIL
1448 */
1449
1450 static int
1451 host_name_lookup_byaddr(void)
1452 {
1453 int len;
1454 uschar *s, *t;
1455 struct hostent *hosts;
1456 struct in_addr addr;
1457
1458 /* Lookup on IPv6 system */
1459
1460 #if HAVE_IPV6
1461 if (Ustrchr(sender_host_address, ':') != NULL)
1462   {
1463   struct in6_addr addr6;
1464   if (inet_pton(AF_INET6, CS sender_host_address, &addr6) != 1)
1465     log_write(0, LOG_MAIN|LOG_PANIC_DIE, "unable to parse \"%s\" as an "
1466       "IPv6 address", sender_host_address);
1467   #if HAVE_GETIPNODEBYADDR
1468   hosts = getipnodebyaddr(CS &addr6, sizeof(addr6), AF_INET6, &h_errno);
1469   #else
1470   hosts = gethostbyaddr(CS &addr6, sizeof(addr6), AF_INET6);
1471   #endif
1472   }
1473 else
1474   {
1475   if (inet_pton(AF_INET, CS sender_host_address, &addr) != 1)
1476     log_write(0, LOG_MAIN|LOG_PANIC_DIE, "unable to parse \"%s\" as an "
1477       "IPv4 address", sender_host_address);
1478   #if HAVE_GETIPNODEBYADDR
1479   hosts = getipnodebyaddr(CS &addr, sizeof(addr), AF_INET, &h_errno);
1480   #else
1481   hosts = gethostbyaddr(CS &addr, sizeof(addr), AF_INET);
1482   #endif
1483   }
1484
1485 /* Do lookup on IPv4 system */
1486
1487 #else
1488 addr.s_addr = (S_ADDR_TYPE)inet_addr(CS sender_host_address);
1489 hosts = gethostbyaddr(CS(&addr), sizeof(addr), AF_INET);
1490 #endif
1491
1492 /* Failed to look up the host. */
1493
1494 if (hosts == NULL)
1495   {
1496   HDEBUG(D_host_lookup) debug_printf("IP address lookup failed: h_errno=%d\n",
1497     h_errno);
1498   return (h_errno == TRY_AGAIN || h_errno == NO_RECOVERY) ? DEFER : FAIL;
1499   }
1500
1501 /* It seems there are some records in the DNS that yield an empty name. We
1502 treat this as non-existent. In some operating systems, this is returned as an
1503 empty string; in others as a single dot. */
1504
1505 if (hosts->h_name[0] == 0 || hosts->h_name[0] == '.')
1506   {
1507   HDEBUG(D_host_lookup) debug_printf("IP address lookup yielded an empty name: "
1508     "treated as non-existent host name\n");
1509   return FAIL;
1510   }
1511
1512 /* Copy and lowercase the name, which is in static storage in many systems.
1513 Put it in permanent memory. */
1514
1515 s = (uschar *)hosts->h_name;
1516 len = Ustrlen(s) + 1;
1517 t = sender_host_name = store_get_perm(len);
1518 while (*s != 0) *t++ = tolower(*s++);
1519 *t = 0;
1520
1521 /* If the host has aliases, build a copy of the alias list */
1522
1523 if (hosts->h_aliases != NULL)
1524   {
1525   int count = 1;
1526   uschar **aliases, **ptr;
1527   for (aliases = USS hosts->h_aliases; *aliases != NULL; aliases++) count++;
1528   ptr = sender_host_aliases = store_get_perm(count * sizeof(uschar *));
1529   for (aliases = USS hosts->h_aliases; *aliases != NULL; aliases++)
1530     {
1531     uschar *s = *aliases;
1532     int len = Ustrlen(s) + 1;
1533     uschar *t = *ptr++ = store_get_perm(len);
1534     while (*s != 0) *t++ = tolower(*s++);
1535     *t = 0;
1536     }
1537   *ptr = NULL;
1538   }
1539
1540 return OK;
1541 }
1542
1543
1544
1545 /*************************************************
1546 *        Find host name for incoming call        *
1547 *************************************************/
1548
1549 /* Put the name in permanent store, pointed to by sender_host_name. We also set
1550 up a list of alias names, pointed to by sender_host_alias. The list is
1551 NULL-terminated. The incoming address is in sender_host_address, either in
1552 dotted-quad form for IPv4 or in colon-separated form for IPv6.
1553
1554 This function does a thorough check that the names it finds point back to the
1555 incoming IP address. Any that do not are discarded. Note that this is relied on
1556 by the ACL reverse_host_lookup check.
1557
1558 On some systems, get{host,ipnode}byaddr() appears to do this internally, but
1559 this it not universally true. Also, for release 4.30, this function was changed
1560 to do a direct DNS lookup first, by default[1], because it turns out that that
1561 is the only guaranteed way to find all the aliases on some systems. My
1562 experiments indicate that Solaris gethostbyaddr() gives the aliases for but
1563 Linux does not.
1564
1565 [1] The actual order is controlled by the host_lookup_order option.
1566
1567 Arguments:    none
1568 Returns:      OK on success, the answer being placed in the global variable
1569                 sender_host_name, with any aliases in a list hung off
1570                 sender_host_aliases
1571               FAIL if no host name can be found
1572               DEFER if a temporary error was encountered
1573
1574 The variable host_lookup_msg is set to an empty string on sucess, or to a
1575 reason for the failure otherwise, in a form suitable for tagging onto an error
1576 message, and also host_lookup_failed is set TRUE if the lookup failed. If there
1577 was a defer, host_lookup_deferred is set TRUE.
1578
1579 Any dynamically constructed string for host_lookup_msg must be in permanent
1580 store, because it might be used for several incoming messages on the same SMTP
1581 connection. */
1582
1583 int
1584 host_name_lookup(void)
1585 {
1586 int old_pool, rc;
1587 int sep = 0;
1588 uschar *hname, *save_hostname;
1589 uschar **aliases;
1590 uschar buffer[256];
1591 uschar *ordername;
1592 uschar *list = host_lookup_order;
1593 dns_record *rr;
1594 dns_answer dnsa;
1595 dns_scan dnss;
1596
1597 host_lookup_deferred = host_lookup_failed = FALSE;
1598
1599 HDEBUG(D_host_lookup)
1600   debug_printf("looking up host name for %s\n", sender_host_address);
1601
1602 /* For testing the case when a lookup does not complete, we have a special
1603 reserved IP address. */
1604
1605 if (running_in_test_harness &&
1606     Ustrcmp(sender_host_address, "99.99.99.99") == 0)
1607   {
1608   HDEBUG(D_host_lookup)
1609     debug_printf("Test harness: host name lookup returns DEFER\n");
1610   host_lookup_deferred = TRUE;
1611   return DEFER;
1612   }
1613
1614 /* Do lookups directly in the DNS or via gethostbyaddr() (or equivalent), in
1615 the order specified by the host_lookup_order option. */
1616
1617 while ((ordername = string_nextinlist(&list, &sep, buffer, sizeof(buffer)))
1618         != NULL)
1619   {
1620   if (strcmpic(ordername, US"bydns") == 0)
1621     {
1622     dns_init(FALSE, FALSE);
1623     dns_build_reverse(sender_host_address, buffer);
1624     rc = dns_lookup(&dnsa, buffer, T_PTR, NULL);
1625
1626     /* The first record we come across is used for the name; others are
1627     considered to be aliases. We have to scan twice, in order to find out the
1628     number of aliases. However, if all the names are empty, we will behave as
1629     if failure. (PTR records that yield empty names have been encountered in
1630     the DNS.) */
1631
1632     if (rc == DNS_SUCCEED)
1633       {
1634       uschar **aptr = NULL;
1635       int ssize = 264;
1636       int count = 0;
1637       int old_pool = store_pool;
1638
1639       store_pool = POOL_PERM;        /* Save names in permanent storage */
1640
1641       for (rr = dns_next_rr(&dnsa, &dnss, RESET_ANSWERS);
1642            rr != NULL;
1643            rr = dns_next_rr(&dnsa, &dnss, RESET_NEXT))
1644         {
1645         if (rr->type == T_PTR) count++;
1646         }
1647
1648       /* Get store for the list of aliases. For compatibility with
1649       gethostbyaddr, we make an empty list if there are none. */
1650
1651       aptr = sender_host_aliases = store_get(count * sizeof(uschar *));
1652
1653       /* Re-scan and extract the names */
1654
1655       for (rr = dns_next_rr(&dnsa, &dnss, RESET_ANSWERS);
1656            rr != NULL;
1657            rr = dns_next_rr(&dnsa, &dnss, RESET_NEXT))
1658         {
1659         uschar *s = NULL;
1660         if (rr->type != T_PTR) continue;
1661         s = store_get(ssize);
1662
1663         /* If an overlong response was received, the data will have been
1664         truncated and dn_expand may fail. */
1665
1666         if (dn_expand(dnsa.answer, dnsa.answer + dnsa.answerlen,
1667              (uschar *)(rr->data), (DN_EXPAND_ARG4_TYPE)(s), ssize) < 0)
1668           {
1669           log_write(0, LOG_MAIN, "host name alias list truncated for %s",
1670             sender_host_address);
1671           break;
1672           }
1673
1674         store_reset(s + Ustrlen(s) + 1);
1675         if (s[0] == 0)
1676           {
1677           HDEBUG(D_host_lookup) debug_printf("IP address lookup yielded an "
1678             "empty name: treated as non-existent host name\n");
1679           continue;
1680           }
1681         if (sender_host_name == NULL) sender_host_name = s;
1682           else *aptr++ = s;
1683         while (*s != 0) { *s = tolower(*s); s++; }
1684         }
1685
1686       *aptr = NULL;            /* End of alias list */
1687       store_pool = old_pool;   /* Reset store pool */
1688
1689       /* If we've found a names, break out of the "order" loop */
1690
1691       if (sender_host_name != NULL) break;
1692       }
1693
1694     /* If the DNS lookup deferred, we must also defer. */
1695
1696     if (rc == DNS_AGAIN)
1697       {
1698       HDEBUG(D_host_lookup)
1699         debug_printf("IP address PTR lookup gave temporary error\n");
1700       host_lookup_deferred = TRUE;
1701       return DEFER;
1702       }
1703     }
1704
1705   /* Do a lookup using gethostbyaddr() - or equivalent */
1706
1707   else if (strcmpic(ordername, US"byaddr") == 0)
1708     {
1709     HDEBUG(D_host_lookup)
1710       debug_printf("IP address lookup using gethostbyaddr()\n");
1711     rc = host_name_lookup_byaddr();
1712     if (rc == DEFER)
1713       {
1714       host_lookup_deferred = TRUE;
1715       return rc;                       /* Can't carry on */
1716       }
1717     if (rc == OK) break;               /* Found a name */
1718     }
1719   }      /* Loop for bydns/byaddr scanning */
1720
1721 /* If we have failed to find a name, return FAIL and log when required.
1722 NB host_lookup_msg must be in permanent store.  */
1723
1724 if (sender_host_name == NULL)
1725   {
1726   if (host_checking || !log_testing_mode)
1727     log_write(L_host_lookup_failed, LOG_MAIN, "no host name found for IP "
1728       "address %s", sender_host_address);
1729   host_lookup_msg = US" (failed to find host name from IP address)";
1730   host_lookup_failed = TRUE;
1731   return FAIL;
1732   }
1733
1734 HDEBUG(D_host_lookup)
1735   {
1736   uschar **aliases = sender_host_aliases;
1737   debug_printf("IP address lookup yielded %s\n", sender_host_name);
1738   while (*aliases != NULL) debug_printf("  alias %s\n", *aliases++);
1739   }
1740
1741 /* We need to verify that a forward lookup on the name we found does indeed
1742 correspond to the address. This is for security: in principle a malefactor who
1743 happened to own a reverse zone could set it to point to any names at all.
1744
1745 This code was present in versions of Exim before 3.20. At that point I took it
1746 out because I thought that gethostbyaddr() did the check anyway. It turns out
1747 that this isn't always the case, so it's coming back in at 4.01. This version
1748 is actually better, because it also checks aliases.
1749
1750 The code was made more robust at release 4.21. Prior to that, it accepted all
1751 the names if any of them had the correct IP address. Now the code checks all
1752 the names, and accepts only those that have the correct IP address. */
1753
1754 save_hostname = sender_host_name;   /* Save for error messages */
1755 aliases = sender_host_aliases;
1756 for (hname = sender_host_name; hname != NULL; hname = *aliases++)
1757   {
1758   int rc;
1759   BOOL ok = FALSE;
1760   host_item h;
1761   h.next = NULL;
1762   h.name = hname;
1763   h.mx = MX_NONE;
1764   h.address = NULL;
1765
1766   /* When called with the 5th argument FALSE, host_find_byname() won't return
1767   HOST_FOUND_LOCAL. If the incoming address is an IPv4 address expressed in
1768   IPv6 format, we must compare the IPv4 part to any IPv4 addresses. */
1769
1770   if ((rc = host_find_byname(&h, NULL, NULL, FALSE)) == HOST_FOUND)
1771     {
1772     host_item *hh;
1773     HDEBUG(D_host_lookup) debug_printf("checking addresses for %s\n", hname);
1774     for (hh = &h; hh != NULL; hh = hh->next)
1775       {
1776       if (host_is_in_net(hh->address, sender_host_address, 0))
1777         {
1778         HDEBUG(D_host_lookup) debug_printf("  %s OK\n", hh->address);
1779         ok = TRUE;
1780         break;
1781         }
1782       else
1783         {
1784         HDEBUG(D_host_lookup) debug_printf("  %s\n", hh->address);
1785         }
1786       }
1787     if (!ok) HDEBUG(D_host_lookup)
1788       debug_printf("no IP address for %s matched %s\n", hname,
1789         sender_host_address);
1790     }
1791   else if (rc == HOST_FIND_AGAIN)
1792     {
1793     HDEBUG(D_host_lookup) debug_printf("temporary error for host name lookup\n");
1794     host_lookup_deferred = TRUE;
1795     return DEFER;
1796     }
1797   else
1798     {
1799     HDEBUG(D_host_lookup) debug_printf("no IP addresses found for %s\n", hname);
1800     }
1801
1802   /* If this name is no good, and it's the sender name, set it null pro tem;
1803   if it's an alias, just remove it from the list. */
1804
1805   if (!ok)
1806     {
1807     if (hname == sender_host_name) sender_host_name = NULL; else
1808       {
1809       uschar **a;                              /* Don't amalgamate - some */
1810       a = --aliases;                           /* compilers grumble */
1811       while (*a != NULL) { *a = a[1]; a++; }
1812       }
1813     }
1814   }
1815
1816 /* If sender_host_name == NULL, it means we didn't like the name. Replace
1817 it with the first alias, if there is one. */
1818
1819 if (sender_host_name == NULL && *sender_host_aliases != NULL)
1820   sender_host_name = *sender_host_aliases++;
1821
1822 /* If we now have a main name, all is well. */
1823
1824 if (sender_host_name != NULL) return OK;
1825
1826 /* We have failed to find an address that matches. */
1827
1828 HDEBUG(D_host_lookup)
1829   debug_printf("%s does not match any IP address for %s\n",
1830     sender_host_address, save_hostname);
1831
1832 /* This message must be in permanent store */
1833
1834 old_pool = store_pool;
1835 store_pool = POOL_PERM;
1836 host_lookup_msg = string_sprintf(" (%s does not match any IP address for %s)",
1837   sender_host_address, save_hostname);
1838 store_pool = old_pool;
1839 host_lookup_failed = TRUE;
1840 return FAIL;
1841 }
1842
1843
1844
1845
1846 /*************************************************
1847 *    Find IP address(es) for host by name        *
1848 *************************************************/
1849
1850 /* The input is a host_item structure with the name filled in and the address
1851 field set to NULL. We use gethostbyname(). Of course, gethostbyname() may use
1852 the DNS, but it doesn't do MX processing. If more than one address is given,
1853 chain on additional host items, with other relevant fields copied.
1854
1855 The second argument provides a host list (usually an IP list) of hosts to
1856 ignore. This makes it possible to ignore IPv6 link-local addresses or loopback
1857 addresses in unreasonable places.
1858
1859 The lookup may result in a change of name. For compatibility with the dns
1860 lookup, return this via fully_qualified_name as well as updating the host item.
1861 The lookup may also yield more than one IP address, in which case chain on
1862 subsequent host_item structures.
1863
1864 Arguments:
1865   host                   a host item with the name and MX filled in;
1866                            the address is to be filled in;
1867                            multiple IP addresses cause other host items to be
1868                              chained on.
1869   ignore_target_hosts    a list of hosts to ignore
1870   fully_qualified_name   if not NULL, set to point to host name for
1871                          compatibility with host_find_bydns
1872   local_host_check       TRUE if a check for the local host is wanted
1873
1874 Returns:                 HOST_FIND_FAILED  Failed to find the host or domain
1875                          HOST_FIND_AGAIN   Try again later
1876                          HOST_FOUND        Host found - data filled in
1877                          HOST_FOUND_LOCAL  Host found and is the local host
1878 */
1879
1880 int
1881 host_find_byname(host_item *host, uschar *ignore_target_hosts,
1882   uschar **fully_qualified_name, BOOL local_host_check)
1883 {
1884 int i, yield, times;
1885 uschar **addrlist;
1886 host_item *last = NULL;
1887 BOOL temp_error = FALSE;
1888 #if HAVE_IPV6
1889 int af;
1890 #endif
1891
1892 /* If we are in the test harness, a name ending in .test.again.dns always
1893 forces a temporary error response. */
1894
1895 if (running_in_test_harness)
1896   {
1897   uschar *endname = host->name + Ustrlen(host->name);
1898   if (Ustrcmp(endname - 14, "test.again.dns") == 0)
1899     return HOST_FIND_AGAIN;
1900   }
1901
1902 /* In an IPv6 world, unless IPv6 has been disabled, we need to scan for both
1903 kinds of address, so go round the loop twice. Note that we have ensured that
1904 AF_INET6 is defined even in an IPv4 world, which makes for slightly tidier
1905 code. However, if dns_ipv4_lookup matches the domain, we also just do IPv4
1906 lookups here (except when testing standalone). */
1907
1908 #if HAVE_IPV6
1909   #ifndef STAND_ALONE
1910   if (disable_ipv6 || (dns_ipv4_lookup != NULL &&
1911         match_isinlist(host->name, &dns_ipv4_lookup, 0, NULL, NULL, MCL_DOMAIN,
1912           TRUE, NULL) == OK))
1913     { af = AF_INET; times = 1; }
1914   else
1915   #endif  /* STAND_ALONE */
1916
1917     { af = AF_INET6; times = 2; }
1918
1919 /* No IPv6 support */
1920
1921 #else   /* HAVE_IPV6 */
1922   times = 1;
1923 #endif  /* HAVE_IPV6 */
1924
1925 /* Initialize the flag that gets set for DNS syntax check errors, so that the
1926 interface to this function can be similar to host_find_bydns. */
1927
1928 host_find_failed_syntax = FALSE;
1929
1930 /* Loop to look up both kinds of address in an IPv6 world */
1931
1932 for (i = 1; i <= times;
1933      #if HAVE_IPV6
1934        af = AF_INET,     /* If 2 passes, IPv4 on the second */
1935      #endif
1936      i++)
1937   {
1938   BOOL ipv4_addr;
1939   int error_num;
1940   struct hostent *hostdata;
1941
1942   #if HAVE_IPV6
1943   if (running_in_test_harness)
1944     hostdata = host_fake_gethostbyname(host->name, af, &error_num);
1945   else
1946     {
1947     #if HAVE_GETIPNODEBYNAME
1948     hostdata = getipnodebyname(CS host->name, af, 0, &error_num);
1949     #else
1950     hostdata = gethostbyname2(CS host->name, af);
1951     error_num = h_errno;
1952     #endif
1953     }
1954
1955   #else    /* not HAVE_IPV6 */
1956   if (running_in_test_harness)
1957     hostdata = host_fake_gethostbyname(host->name, AF_INET, &error_num);
1958   else
1959     {
1960     hostdata = gethostbyname(CS host->name);
1961     error_num = h_errno;
1962     }
1963   #endif   /* HAVE_IPV6 */
1964
1965   if (hostdata == NULL)
1966     {
1967     uschar *error;
1968     switch (error_num)
1969       {
1970       case HOST_NOT_FOUND: error = US"HOST_NOT_FOUND"; break;
1971       case TRY_AGAIN: error = US"TRY_AGAIN"; break;
1972       case NO_RECOVERY: error = US"NO_RECOVERY"; break;
1973       case NO_DATA: error = US"NO_DATA"; break;
1974       #if NO_DATA != NO_ADDRESS
1975       case NO_ADDRESS: error = US"NO_ADDRESS"; break;
1976       #endif
1977       default: error = US"?"; break;
1978       }
1979
1980     DEBUG(D_host_lookup) debug_printf("%s returned %d (%s)\n",
1981       #if HAVE_IPV6
1982         #if HAVE_GETIPNODEBYNAME
1983         (af == AF_INET6)? "getipnodebyname(af=inet6)" : "getipnodebyname(af=inet)",
1984         #else
1985         (af == AF_INET6)? "gethostbyname2(af=inet6)" : "gethostbyname2(af=inet)",
1986         #endif
1987       #else
1988       "gethostbyname",
1989       #endif
1990       error_num, error);
1991
1992     if (error_num == TRY_AGAIN || error_num == NO_RECOVERY) temp_error = TRUE;
1993     continue;
1994     }
1995   if ((hostdata->h_addr_list)[0] == NULL) continue;
1996
1997   /* Replace the name with the fully qualified one if necessary, and fill in
1998   the fully_qualified_name pointer. */
1999
2000   if (hostdata->h_name[0] != 0 &&
2001       Ustrcmp(host->name, hostdata->h_name) != 0)
2002     host->name = string_copy_dnsdomain((uschar *)hostdata->h_name);
2003   if (fully_qualified_name != NULL) *fully_qualified_name = host->name;
2004
2005   /* Get the list of addresses. IPv4 and IPv6 addresses can be distinguished
2006   by their different lengths. Scan the list, ignoring any that are to be
2007   ignored, and build a chain from the rest. */
2008
2009   ipv4_addr = hostdata->h_length == sizeof(struct in_addr);
2010
2011   for (addrlist = USS hostdata->h_addr_list; *addrlist != NULL; addrlist++)
2012     {
2013     uschar *text_address =
2014       host_ntoa(ipv4_addr? AF_INET:AF_INET6, *addrlist, NULL, NULL);
2015
2016     #ifndef STAND_ALONE
2017     if (ignore_target_hosts != NULL &&
2018         verify_check_this_host(&ignore_target_hosts, NULL, host->name,
2019           text_address, NULL) == OK)
2020       {
2021       DEBUG(D_host_lookup)
2022         debug_printf("ignored host %s [%s]\n", host->name, text_address);
2023       continue;
2024       }
2025     #endif
2026
2027     /* If this is the first address, last == NULL and we put the data in the
2028     original block. */
2029
2030     if (last == NULL)
2031       {
2032       host->address = text_address;
2033       host->port = PORT_NONE;
2034       host->status = hstatus_unknown;
2035       host->why = hwhy_unknown;
2036       last = host;
2037       }
2038
2039     /* Else add further host item blocks for any other addresses, keeping
2040     the order. */
2041
2042     else
2043       {
2044       host_item *next = store_get(sizeof(host_item));
2045       next->name = host->name;
2046       next->mx = host->mx;
2047       next->address = text_address;
2048       next->port = PORT_NONE;
2049       next->status = hstatus_unknown;
2050       next->why = hwhy_unknown;
2051       next->last_try = 0;
2052       next->next = last->next;
2053       last->next = next;
2054       last = next;
2055       }
2056     }
2057   }
2058
2059 /* If no hosts were found, the address field in the original host block will be
2060 NULL. If temp_error is set, at least one of the lookups gave a temporary error,
2061 so we pass that back. */
2062
2063 if (host->address == NULL)
2064   {
2065   uschar *msg =
2066     #ifndef STAND_ALONE
2067     (message_id[0] == 0 && smtp_in != NULL)?
2068       string_sprintf("no IP address found for host %s (during %s)", host->name,
2069           smtp_get_connection_info()) :
2070     #endif
2071     string_sprintf("no IP address found for host %s", host->name);
2072
2073   HDEBUG(D_host_lookup) debug_printf("%s\n", msg);
2074   if (temp_error) return HOST_FIND_AGAIN;
2075   if (host_checking || !log_testing_mode)
2076     log_write(L_host_lookup_failed, LOG_MAIN, "%s", msg);
2077   return HOST_FIND_FAILED;
2078   }
2079
2080 /* Remove any duplicate IP addresses, then check to see if this is the local
2081 host if required. */
2082
2083 host_remove_duplicates(host, &last);
2084 yield = local_host_check?
2085   host_scan_for_local_hosts(host, &last, NULL) : HOST_FOUND;
2086
2087 HDEBUG(D_host_lookup)
2088   {
2089   host_item *h;
2090   if (fully_qualified_name != NULL)
2091     debug_printf("fully qualified name = %s\n", *fully_qualified_name);
2092   debug_printf("%s looked up these IP addresses:\n",
2093     #if HAVE_IPV6
2094       #if HAVE_GETIPNODEBYNAME
2095       "getipnodebyname"
2096       #else
2097       "gethostbyname2"
2098       #endif
2099     #else
2100     "gethostbyname"
2101     #endif
2102     );
2103   for (h = host; h != last->next; h = h->next)
2104     debug_printf("  name=%s address=%s\n", h->name,
2105       (h->address == NULL)? US"<null>" : h->address);
2106   }
2107
2108 /* Return the found status. */
2109
2110 return yield;
2111 }
2112
2113
2114
2115 /*************************************************
2116 *        Fill in a host address from the DNS     *
2117 *************************************************/
2118
2119 /* Given a host item, with its name, port and mx fields set, and its address
2120 field set to NULL, fill in its IP address from the DNS. If it is multi-homed,
2121 create additional host items for the additional addresses, copying all the
2122 other fields, and randomizing the order.
2123
2124 On IPv6 systems, A6 records are sought first (but only if support for A6 is
2125 configured - they may never become mainstream), then AAAA records are sought,
2126 and finally A records are sought as well.
2127
2128 The host name may be changed if the DNS returns a different name - e.g. fully
2129 qualified or changed via CNAME. If fully_qualified_name is not NULL, dns_lookup
2130 ensures that it points to the fully qualified name. However, this is the fully
2131 qualified version of the original name; if a CNAME is involved, the actual
2132 canonical host name may be different again, and so we get it directly from the
2133 relevant RR. Note that we do NOT change the mx field of the host item in this
2134 function as it may be called to set the addresses of hosts taken from MX
2135 records.
2136
2137 Arguments:
2138   host                  points to the host item we're filling in
2139   lastptr               points to pointer to last host item in a chain of
2140                           host items (may be updated if host is last and gets
2141                           extended because multihomed)
2142   ignore_target_hosts   list of hosts to ignore
2143   allow_ip              if TRUE, recognize an IP address and return it
2144   fully_qualified_name  if not NULL, return fully qualified name here if
2145                           the contents are different (i.e. it must be preset
2146                           to something)
2147
2148 Returns:       HOST_FIND_FAILED     couldn't find A record
2149                HOST_FIND_AGAIN      try again later
2150                HOST_FOUND           found AAAA and/or A record(s)
2151                HOST_IGNORED         found, but all IPs ignored
2152 */
2153
2154 static int
2155 set_address_from_dns(host_item *host, host_item **lastptr,
2156   uschar *ignore_target_hosts, BOOL allow_ip, uschar **fully_qualified_name)
2157 {
2158 dns_record *rr;
2159 host_item *thishostlast = NULL;    /* Indicates not yet filled in anything */
2160 BOOL v6_find_again = FALSE;
2161 int i;
2162
2163 /* If allow_ip is set, a name which is an IP address returns that value
2164 as its address. This is used for MX records when allow_mx_to_ip is set, for
2165 those sites that feel they have to flaunt the RFC rules. */
2166
2167 if (allow_ip && string_is_ip_address(host->name, NULL) != 0)
2168   {
2169   #ifndef STAND_ALONE
2170   if (ignore_target_hosts != NULL &&
2171         verify_check_this_host(&ignore_target_hosts, NULL, host->name,
2172         host->name, NULL) == OK)
2173     return HOST_IGNORED;
2174   #endif
2175
2176   host->address = host->name;
2177   return HOST_FOUND;
2178   }
2179
2180 /* On an IPv6 system, unless IPv6 is disabled, go round the loop up to three
2181 times, looking for A6 and AAAA records the first two times. However, unless
2182 doing standalone testing, we force an IPv4 lookup if the domain matches
2183 dns_ipv4_lookup is set. Since A6 records look like being abandoned, support
2184 them only if explicitly configured to do so. On an IPv4 system, go round the
2185 loop once only, looking only for A records. */
2186
2187 #if HAVE_IPV6
2188   #ifndef STAND_ALONE
2189     if (disable_ipv6 || (dns_ipv4_lookup != NULL &&
2190         match_isinlist(host->name, &dns_ipv4_lookup, 0, NULL, NULL, MCL_DOMAIN,
2191         TRUE, NULL) == OK))
2192       i = 0;    /* look up A records only */
2193     else
2194   #endif        /* STAND_ALONE */
2195
2196   #ifdef SUPPORT_A6
2197   i = 2;        /* look up A6 and AAAA and A records */
2198   #else
2199   i = 1;        /* look up AAAA and A records */
2200   #endif        /* SUPPORT_A6 */
2201
2202 /* The IPv4 world */
2203
2204 #else           /* HAVE_IPV6 */
2205   i = 0;        /* look up A records only */
2206 #endif          /* HAVE_IPV6 */
2207
2208 for (; i >= 0; i--)
2209   {
2210   static int types[] = { T_A, T_AAAA, T_A6 };
2211   int type = types[i];
2212   int randoffset = (i == 0)? 500 : 0;  /* Ensures v6 sorts before v4 */
2213   dns_answer dnsa;
2214   dns_scan dnss;
2215
2216   int rc = dns_lookup(&dnsa, host->name, type, fully_qualified_name);
2217
2218   /* We want to return HOST_FIND_AGAIN if one of the A, A6, or AAAA lookups
2219   fails or times out, but not if another one succeeds. (In the early
2220   IPv6 days there are name servers that always fail on AAAA, but are happy
2221   to give out an A record. We want to proceed with that A record.) */
2222
2223   if (rc != DNS_SUCCEED)
2224     {
2225     if (i == 0)  /* Just tried for an A record, i.e. end of loop */
2226       {
2227       if (host->address != NULL) return HOST_FOUND;  /* A6 or AAAA was found */
2228       if (rc == DNS_AGAIN || rc == DNS_FAIL || v6_find_again)
2229         return HOST_FIND_AGAIN;
2230       return HOST_FIND_FAILED;    /* DNS_NOMATCH or DNS_NODATA */
2231       }
2232
2233     /* Tried for an A6 or AAAA record: remember if this was a temporary
2234     error, and look for the next record type. */
2235
2236     if (rc != DNS_NOMATCH && rc != DNS_NODATA) v6_find_again = TRUE;
2237     continue;
2238     }
2239
2240   /* Lookup succeeded: fill in the given host item with the first non-ignored
2241   address found; create additional items for any others. A single A6 record
2242   may generate more than one address. */
2243
2244   for (rr = dns_next_rr(&dnsa, &dnss, RESET_ANSWERS);
2245        rr != NULL;
2246        rr = dns_next_rr(&dnsa, &dnss, RESET_NEXT))
2247     {
2248     if (rr->type == type)
2249       {
2250       /* dns_address *da = dns_address_from_rr(&dnsa, rr); */
2251
2252       dns_address *da;
2253       da = dns_address_from_rr(&dnsa, rr);
2254
2255       DEBUG(D_host_lookup)
2256         {
2257         if (da == NULL)
2258           debug_printf("no addresses extracted from A6 RR for %s\n",
2259             host->name);
2260         }
2261
2262       /* This loop runs only once for A and AAAA records, but may run
2263       several times for an A6 record that generated multiple addresses. */
2264
2265       for (; da != NULL; da = da->next)
2266         {
2267         #ifndef STAND_ALONE
2268         if (ignore_target_hosts != NULL &&
2269               verify_check_this_host(&ignore_target_hosts, NULL,
2270                 host->name, da->address, NULL) == OK)
2271           {
2272           DEBUG(D_host_lookup)
2273             debug_printf("ignored host %s [%s]\n", host->name, da->address);
2274           continue;
2275           }
2276         #endif
2277
2278         /* If this is the first address, stick it in the given host block,
2279         and change the name if the returned RR has a different name. */
2280
2281         if (thishostlast == NULL)
2282           {
2283           if (strcmpic(host->name, rr->name) != 0)
2284             host->name = string_copy_dnsdomain(rr->name);
2285           host->address = da->address;
2286           host->sort_key = host->mx * 1000 + random_number(500) + randoffset;
2287           host->status = hstatus_unknown;
2288           host->why = hwhy_unknown;
2289           thishostlast = host;
2290           }
2291
2292         /* Not the first address. Check for, and ignore, duplicates. Then
2293         insert in the chain at a random point. */
2294
2295         else
2296           {
2297           int new_sort_key;
2298           host_item *next;
2299
2300           /* End of our local chain is specified by "thishostlast". */
2301
2302           for (next = host;; next = next->next)
2303             {
2304             if (Ustrcmp(CS da->address, next->address) == 0) break;
2305             if (next == thishostlast) { next = NULL; break; }
2306             }
2307           if (next != NULL) continue;  /* With loop for next address */
2308
2309           /* Not a duplicate */
2310
2311           new_sort_key = host->mx * 1000 + random_number(500) + randoffset;
2312           next = store_get(sizeof(host_item));
2313
2314           /* New address goes first: insert the new block after the first one
2315           (so as not to disturb the original pointer) but put the new address
2316           in the original block. */
2317
2318           if (new_sort_key < host->sort_key)
2319             {
2320             *next = *host;                                  /* Copies port */
2321             host->next = next;
2322             host->address = da->address;
2323             host->sort_key = new_sort_key;
2324             if (thishostlast == host) thishostlast = next;  /* Local last */
2325             if (*lastptr == host) *lastptr = next;          /* Global last */
2326             }
2327
2328           /* Otherwise scan down the addresses for this host to find the
2329           one to insert after. */
2330
2331           else
2332             {
2333             host_item *h = host;
2334             while (h != thishostlast)
2335               {
2336               if (new_sort_key < h->next->sort_key) break;
2337               h = h->next;
2338               }
2339             *next = *h;                                 /* Copies port */
2340             h->next = next;
2341             next->address = da->address;
2342             next->sort_key = new_sort_key;
2343             if (h == thishostlast) thishostlast = next; /* Local last */
2344             if (h == *lastptr) *lastptr = next;         /* Global last */
2345             }
2346           }
2347         }
2348       }
2349     }
2350   }
2351
2352 /* Control gets here only if the third lookup (the A record) succeeded.
2353 However, the address may not be filled in if it was ignored. */
2354
2355 return (host->address == NULL)? HOST_IGNORED : HOST_FOUND;
2356 }
2357
2358
2359
2360
2361 /*************************************************
2362 *    Find IP addresses and host names via DNS    *
2363 *************************************************/
2364
2365 /* The input is a host_item structure with the name field filled in and the
2366 address field set to NULL. This may be in a chain of other host items. The
2367 lookup may result in more than one IP address, in which case we must created
2368 new host blocks for the additional addresses, and insert them into the chain.
2369 The original name may not be fully qualified. Use the fully_qualified_name
2370 argument to return the official name, as returned by the resolver.
2371
2372 Arguments:
2373   host                  point to initial host item
2374   ignore_target_hosts   a list of hosts to ignore
2375   whichrrs              flags indicating which RRs to look for:
2376                           HOST_FIND_BY_SRV  => look for SRV
2377                           HOST_FIND_BY_MX   => look for MX
2378                           HOST_FIND_BY_A    => look for A or AAAA
2379                         also flags indicating how the lookup is done
2380                           HOST_FIND_QUALIFY_SINGLE   ) passed to the
2381                           HOST_FIND_SEARCH_PARENTS   )   resolver
2382   srv_service           when SRV used, the service name
2383   srv_fail_domains      DNS errors for these domains => assume nonexist
2384   mx_fail_domains       DNS errors for these domains => assume nonexist
2385   fully_qualified_name  if not NULL, return fully-qualified name
2386   removed               set TRUE if local host was removed from the list
2387
2388 Returns:                HOST_FIND_FAILED  Failed to find the host or domain;
2389                                           if there was a syntax error,
2390                                           host_find_failed_syntax is set.
2391                         HOST_FIND_AGAIN   Could not resolve at this time
2392                         HOST_FOUND        Host found
2393                         HOST_FOUND_LOCAL  The lowest MX record points to this
2394                                           machine, if MX records were found, or
2395                                           an A record that was found contains
2396                                           an address of the local host
2397 */
2398
2399 int
2400 host_find_bydns(host_item *host, uschar *ignore_target_hosts, int whichrrs,
2401   uschar *srv_service, uschar *srv_fail_domains, uschar *mx_fail_domains,
2402   uschar **fully_qualified_name, BOOL *removed)
2403 {
2404 host_item *h, *last;
2405 dns_record *rr;
2406 int rc = DNS_FAIL;
2407 int ind_type = 0;
2408 int yield;
2409 dns_answer dnsa;
2410 dns_scan dnss;
2411
2412 /* Set the default fully qualified name to the incoming name, initialize the
2413 resolver if necessary, set up the relevant options, and initialize the flag
2414 that gets set for DNS syntax check errors. */
2415
2416 if (fully_qualified_name != NULL) *fully_qualified_name = host->name;
2417 dns_init((whichrrs & HOST_FIND_QUALIFY_SINGLE) != 0,
2418          (whichrrs & HOST_FIND_SEARCH_PARENTS) != 0);
2419 host_find_failed_syntax = FALSE;
2420
2421 /* First, if requested, look for SRV records. The service name is given; we
2422 assume TCP progocol. DNS domain names are constrained to a maximum of 256
2423 characters, so the code below should be safe. */
2424
2425 if ((whichrrs & HOST_FIND_BY_SRV) != 0)
2426   {
2427   uschar buffer[300];
2428   uschar *temp_fully_qualified_name = buffer;
2429   int prefix_length;
2430
2431   (void)sprintf(CS buffer, "_%s._tcp.%n%.256s", srv_service, &prefix_length,
2432     host->name);
2433   ind_type = T_SRV;
2434
2435   /* Search for SRV records. If the fully qualified name is different to
2436   the input name, pass back the new original domain, without the prepended
2437   magic. */
2438
2439   rc = dns_lookup(&dnsa, buffer, ind_type, &temp_fully_qualified_name);
2440   if (temp_fully_qualified_name != buffer && fully_qualified_name != NULL)
2441     *fully_qualified_name = temp_fully_qualified_name + prefix_length;
2442
2443   /* On DNS failures, we give the "try again" error unless the domain is
2444   listed as one for which we continue. */
2445
2446   if (rc == DNS_FAIL || rc == DNS_AGAIN)
2447     {
2448     #ifndef STAND_ALONE
2449     if (match_isinlist(host->name, &srv_fail_domains, 0, NULL, NULL, MCL_DOMAIN,
2450         TRUE, NULL) != OK)
2451     #endif
2452       return HOST_FIND_AGAIN;
2453     DEBUG(D_host_lookup) debug_printf("DNS_%s treated as DNS_NODATA "
2454       "(domain in srv_fail_domains)\n", (rc == DNS_FAIL)? "FAIL":"AGAIN");
2455     }
2456   }
2457
2458 /* If we did not find any SRV records, search the DNS for MX records, if
2459 requested to do so. If the result is DNS_NOMATCH, it means there is no such
2460 domain, and there's no point in going on to look for address records with the
2461 same domain. The result will be DNS_NODATA if the domain exists but has no MX
2462 records. On DNS failures, we give the "try again" error unless the domain is
2463 listed as one for which we continue. */
2464
2465 if (rc != DNS_SUCCEED && (whichrrs & HOST_FIND_BY_MX) != 0)
2466   {
2467   ind_type = T_MX;
2468   rc = dns_lookup(&dnsa, host->name, ind_type, fully_qualified_name);
2469   if (rc == DNS_NOMATCH) return HOST_FIND_FAILED;
2470   if (rc == DNS_FAIL || rc == DNS_AGAIN)
2471     {
2472     #ifndef STAND_ALONE
2473     if (match_isinlist(host->name, &mx_fail_domains, 0, NULL, NULL, MCL_DOMAIN,
2474         TRUE, NULL) != OK)
2475     #endif
2476       return HOST_FIND_AGAIN;
2477     DEBUG(D_host_lookup) debug_printf("DNS_%s treated as DNS_NODATA "
2478       "(domain in mx_fail_domains)\n", (rc == DNS_FAIL)? "FAIL":"AGAIN");
2479     }
2480   }
2481
2482 /* If we haven't found anything yet, and we are requested to do so, try for an
2483 A or AAAA record. If we find it (or them) check to see that it isn't the local
2484 host. */
2485
2486 if (rc != DNS_SUCCEED)
2487   {
2488   if ((whichrrs & HOST_FIND_BY_A) == 0)
2489     {
2490     DEBUG(D_host_lookup) debug_printf("Address records are not being sought\n");
2491     return HOST_FIND_FAILED;
2492     }
2493
2494   last = host;        /* End of local chainlet */
2495   host->mx = MX_NONE;
2496   host->port = PORT_NONE;
2497   rc = set_address_from_dns(host, &last, ignore_target_hosts, FALSE,
2498     fully_qualified_name);
2499
2500   /* If one or more address records have been found, check that none of them
2501   are local. Since we know the host items all have their IP addresses
2502   inserted, host_scan_for_local_hosts() can only return HOST_FOUND or
2503   HOST_FOUND_LOCAL. We do not need to scan for duplicate IP addresses here,
2504   because set_address_from_dns() removes them. */
2505
2506   if (rc == HOST_FOUND)
2507     rc = host_scan_for_local_hosts(host, &last, removed);
2508   else
2509     if (rc == HOST_IGNORED) rc = HOST_FIND_FAILED;  /* No special action */
2510
2511   DEBUG(D_host_lookup)
2512     {
2513     host_item *h;
2514     if (host->address != NULL)
2515       {
2516       if (fully_qualified_name != NULL)
2517         debug_printf("fully qualified name = %s\n", *fully_qualified_name);
2518       for (h = host; h != last->next; h = h->next)
2519         debug_printf("%s %s mx=%d sort=%d %s\n", h->name,
2520           (h->address == NULL)? US"<null>" : h->address, h->mx, h->sort_key,
2521           (h->status >= hstatus_unusable)? US"*" : US"");
2522       }
2523     }
2524
2525   return rc;
2526   }
2527
2528 /* We have found one or more MX or SRV records. Sort them according to
2529 precedence. Put the data for the first one into the existing host block, and
2530 insert new host_item blocks into the chain for the remainder. For equal
2531 precedences one is supposed to randomize the order. To make this happen, the
2532 sorting is actually done on the MX value * 1000 + a random number. This is put
2533 into a host field called sort_key.
2534
2535 In the case of hosts with both IPv6 and IPv4 addresses, we want to choose the
2536 IPv6 address in preference. At this stage, we don't know what kind of address
2537 the host has. We choose a random number < 500; if later we find an A record
2538 first, we add 500 to the random number. Then for any other address records, we
2539 use random numbers in the range 0-499 for AAAA records and 500-999 for A
2540 records.
2541
2542 At this point we remove any duplicates that point to the same host, retaining
2543 only the one with the lowest precedence. We cannot yet check for precedence
2544 greater than that of the local host, because that test cannot be properly done
2545 until the addresses have been found - an MX record may point to a name for this
2546 host which is not the primary hostname. */
2547
2548 last = NULL;    /* Indicates that not even the first item is filled yet */
2549
2550 for (rr = dns_next_rr(&dnsa, &dnss, RESET_ANSWERS);
2551      rr != NULL;
2552      rr = dns_next_rr(&dnsa, &dnss, RESET_NEXT))
2553   {
2554   int precedence;
2555   int weight = 0;        /* For SRV records */
2556   int port = PORT_NONE;
2557   uschar *s;             /* MUST be unsigned for GETSHORT */
2558   uschar data[256];
2559
2560   if (rr->type != ind_type) continue;
2561   s = rr->data;
2562   GETSHORT(precedence, s);      /* Pointer s is advanced */
2563
2564   /* For MX records, we use a random "weight" which causes multiple records of
2565   the same precedence to sort randomly. */
2566
2567   if (ind_type == T_MX)
2568     {
2569     weight = random_number(500);
2570     }
2571
2572   /* SRV records are specified with a port and a weight. The weight is used
2573   in a special algorithm. However, to start with, we just use it to order the
2574   records of equal priority (precedence). */
2575
2576   else
2577     {
2578     GETSHORT(weight, s);
2579     GETSHORT(port, s);
2580     }
2581
2582   /* Get the name of the host pointed to. */
2583
2584   (void)dn_expand(dnsa.answer, dnsa.answer + dnsa.answerlen, s,
2585     (DN_EXPAND_ARG4_TYPE)data, sizeof(data));
2586
2587   /* Check that we haven't already got this host on the chain; if we have,
2588   keep only the lower precedence. This situation shouldn't occur, but you
2589   never know what junk might get into the DNS (and this case has been seen on
2590   more than one occasion). */
2591
2592   if (last != NULL)       /* This is not the first record */
2593     {
2594     host_item *prev = NULL;
2595
2596     for (h = host; h != last->next; prev = h, h = h->next)
2597       {
2598       if (strcmpic(h->name, data) == 0)
2599         {
2600         DEBUG(D_host_lookup)
2601           debug_printf("discarded duplicate host %s (MX=%d)\n", data,
2602             (precedence > h->mx)? precedence : h->mx);
2603         if (precedence >= h->mx) goto NEXT_MX_RR; /* Skip greater precedence */
2604         if (h == host)                            /* Override first item */
2605           {
2606           h->mx = precedence;
2607           host->sort_key = precedence * 1000 + weight;
2608           goto NEXT_MX_RR;
2609           }
2610
2611         /* Unwanted host item is not the first in the chain, so we can get
2612         get rid of it by cutting it out. */
2613
2614         prev->next = h->next;
2615         if (h == last) last = prev;
2616         break;
2617         }
2618       }
2619     }
2620
2621   /* If this is the first MX or SRV record, put the data into the existing host
2622   block. Otherwise, add a new block in the correct place; if it has to be
2623   before the first block, copy the first block's data to a new second block. */
2624
2625   if (last == NULL)
2626     {
2627     host->name = string_copy_dnsdomain(data);
2628     host->address = NULL;
2629     host->port = port;
2630     host->mx = precedence;
2631     host->sort_key = precedence * 1000 + weight;
2632     host->status = hstatus_unknown;
2633     host->why = hwhy_unknown;
2634     last = host;
2635     }
2636
2637   /* Make a new host item and seek the correct insertion place */
2638
2639   else
2640     {
2641     int sort_key = precedence * 1000 + weight;
2642     host_item *next = store_get(sizeof(host_item));
2643     next->name = string_copy_dnsdomain(data);
2644     next->address = NULL;
2645     next->port = port;
2646     next->mx = precedence;
2647     next->sort_key = sort_key;
2648     next->status = hstatus_unknown;
2649     next->why = hwhy_unknown;
2650     next->last_try = 0;
2651
2652     /* Handle the case when we have to insert before the first item. */
2653
2654     if (sort_key < host->sort_key)
2655       {
2656       host_item htemp;
2657       htemp = *host;
2658       *host = *next;
2659       *next = htemp;
2660       host->next = next;
2661       if (last == host) last = next;
2662       }
2663
2664     /* Else scan down the items we have inserted as part of this exercise;
2665     don't go further. */
2666
2667     else
2668       {
2669       for (h = host; h != last; h = h->next)
2670         {
2671         if (sort_key < h->next->sort_key)
2672           {
2673           next->next = h->next;
2674           h->next = next;
2675           break;
2676           }
2677         }
2678
2679       /* Join on after the last host item that's part of this
2680       processing if we haven't stopped sooner. */
2681
2682       if (h == last)
2683         {
2684         next->next = last->next;
2685         last->next = next;
2686         last = next;
2687         }
2688       }
2689     }
2690
2691   NEXT_MX_RR: continue;
2692   }
2693
2694 /* If the list of hosts was obtained from SRV records, there are two things to
2695 do. First, if there is only one host, and it's name is ".", it means there is
2696 no SMTP service at this domain. Otherwise, we have to sort the hosts of equal
2697 priority according to their weights, using an algorithm that is defined in RFC
2698 2782. The hosts are currently sorted by priority and weight. For each priority
2699 group we have to pick off one host and put it first, and then repeat for any
2700 remaining in the same priority group. */
2701
2702 if (ind_type == T_SRV)
2703   {
2704   host_item **pptr;
2705
2706   if (host == last && host->name[0] == 0)
2707     {
2708     DEBUG(D_host_lookup) debug_printf("the single SRV record is \".\"\n");
2709     return HOST_FIND_FAILED;
2710     }
2711
2712   DEBUG(D_host_lookup)
2713     {
2714     debug_printf("original ordering of hosts from SRV records:\n");
2715     for (h = host; h != last->next; h = h->next)
2716       debug_printf("  %s P=%d W=%d\n", h->name, h->mx, h->sort_key % 1000);
2717     }
2718
2719   for (pptr = &host, h = host; h != last; pptr = &(h->next), h = h->next)
2720     {
2721     int sum = 0;
2722     host_item *hh;
2723
2724     /* Find the last following host that has the same precedence. At the same
2725     time, compute the sum of the weights and the running totals. These can be
2726     stored in the sort_key field. */
2727
2728     for (hh = h; hh != last; hh = hh->next)
2729       {
2730       int weight = hh->sort_key % 1000;   /* was precedence * 1000 + weight */
2731       sum += weight;
2732       hh->sort_key = sum;
2733       if (hh->mx != hh->next->mx) break;
2734       }
2735
2736     /* If there's more than one host at this precedence (priority), we need to
2737     pick one to go first. */
2738
2739     if (hh != h)
2740       {
2741       host_item *hhh;
2742       host_item **ppptr;
2743       int randomizer = random_number(sum + 1);
2744
2745       for (ppptr = pptr, hhh = h;
2746            hhh != hh;
2747            ppptr = &(hhh->next), hhh = hhh->next)
2748         {
2749         if (hhh->sort_key >= randomizer) break;
2750         }
2751
2752       /* hhh now points to the host that should go first; ppptr points to the
2753       place that points to it. Unfortunately, if the start of the minilist is
2754       the start of the entire list, we can't just swap the items over, because
2755       we must not change the value of host, since it is passed in from outside.
2756       One day, this could perhaps be changed.
2757
2758       The special case is fudged by putting the new item *second* in the chain,
2759       and then transferring the data between the first and second items. We
2760       can't just swap the first and the chosen item, because that would mean
2761       that an item with zero weight might no longer be first. */
2762
2763       if (hhh != h)
2764         {
2765         *ppptr = hhh->next;          /* Cuts it out of the chain */
2766
2767         if (h == host)
2768           {
2769           host_item temp = *h;
2770           *h = *hhh;
2771           *hhh = temp;
2772           hhh->next = temp.next;
2773           h->next = hhh;
2774           }
2775
2776         else
2777           {
2778           hhh->next = h;               /* The rest of the chain follows it */
2779           *pptr = hhh;                 /* It takes the place of h */
2780           h = hhh;                     /* It's now the start of this minilist */
2781           }
2782         }
2783       }
2784
2785     /* A host has been chosen to be first at this priority and h now points
2786     to this host. There may be others at the same priority, or others at a
2787     different priority. Before we leave this host, we need to put back a sort
2788     key of the traditional MX kind, in case this host is multihomed, because
2789     the sort key is used for ordering the multiple IP addresses. We do not need
2790     to ensure that these new sort keys actually reflect the order of the hosts,
2791     however. */
2792
2793     h->sort_key = h->mx * 1000 + random_number(500);
2794     }   /* Move on to the next host */
2795   }
2796
2797 /* Now we have to find IP addresses for all the hosts. We have ensured above
2798 that the names in all the host items are unique. Before release 4.61 we used to
2799 process records from the additional section in the DNS packet that returned the
2800 MX or SRV records. However, a DNS name server is free to drop any resource
2801 records from the additional section. In theory, this has always been a
2802 potential problem, but it is exacerbated by the advent of IPv6. If a host had
2803 several IPv4 addresses and some were not in the additional section, at least
2804 Exim would try the others. However, if a host had both IPv4 and IPv6 addresses
2805 and all the IPv4 (say) addresses were absent, Exim would try only for a IPv6
2806 connection, and never try an IPv4 address. When there was only IPv4
2807 connectivity, this was a disaster that did in practice occur.
2808
2809 So, from release 4.61 onwards, we always search for A and AAAA records
2810 explicitly. The names shouldn't point to CNAMES, but we use the general lookup
2811 function that handles them, just in case. If any lookup gives a soft error,
2812 change the default yield.
2813
2814 For these DNS lookups, we must disable qualify_single and search_parents;
2815 otherwise invalid host names obtained from MX or SRV records can cause trouble
2816 if they happen to match something local. */
2817
2818 yield = HOST_FIND_FAILED;    /* Default yield */
2819 dns_init(FALSE, FALSE);      /* Disable qualify_single and search_parents */
2820
2821 for (h = host; h != last->next; h = h->next)
2822   {
2823   if (h->address != NULL) continue;  /* Inserted by a multihomed host */
2824   rc = set_address_from_dns(h, &last, ignore_target_hosts, allow_mx_to_ip, NULL);
2825   if (rc != HOST_FOUND)
2826     {
2827     h->status = hstatus_unusable;
2828     if (rc == HOST_FIND_AGAIN)
2829       {
2830       yield = rc;
2831       h->why = hwhy_deferred;
2832       }
2833     else
2834       h->why = (rc == HOST_IGNORED)? hwhy_ignored : hwhy_failed;
2835     }
2836   }
2837
2838 /* Scan the list for any hosts that are marked unusable because they have
2839 been explicitly ignored, and remove them from the list, as if they did not
2840 exist. If we end up with just a single, ignored host, flatten its fields as if
2841 nothing was found. */
2842
2843 if (ignore_target_hosts != NULL)
2844   {
2845   host_item *prev = NULL;
2846   for (h = host; h != last->next; h = h->next)
2847     {
2848     REDO:
2849     if (h->why != hwhy_ignored)        /* Non ignored host, just continue */
2850       prev = h;
2851     else if (prev == NULL)             /* First host is ignored */
2852       {
2853       if (h != last)                   /* First is not last */
2854         {
2855         if (h->next == last) last = h; /* Overwrite it with next */
2856         *h = *(h->next);               /* and reprocess it. */
2857         goto REDO;                     /* C should have redo, like Perl */
2858         }
2859       }
2860     else                               /* Ignored host is not first - */
2861       {                                /*   cut it out */
2862       prev->next = h->next;
2863       if (h == last) last = prev;
2864       }
2865     }
2866
2867   if (host->why == hwhy_ignored) host->address = NULL;
2868   }
2869
2870 /* There is still one complication in the case of IPv6. Although the code above
2871 arranges that IPv6 addresses take precedence over IPv4 addresses for multihomed
2872 hosts, it doesn't do this for addresses that apply to different hosts with the
2873 same MX precedence, because the sorting on MX precedence happens first. So we
2874 have to make another pass to check for this case. We ensure that, within a
2875 single MX preference value, IPv6 addresses come first. This can separate the
2876 addresses of a multihomed host, but that should not matter. */
2877
2878 #if HAVE_IPV6
2879 if (h != last)
2880   {
2881   for (h = host; h != last; h = h->next)
2882     {
2883     host_item temp;
2884     host_item *next = h->next;
2885     if (h->mx != next->mx ||                /* If next is different MX value */
2886         (h->sort_key % 1000) < 500 ||       /* OR this one is IPv6 */
2887         (next->sort_key % 1000) >= 500)     /* OR next is IPv4 */
2888       continue;                             /* move on to next */
2889     temp = *h;
2890     temp.next = next->next;
2891     *h = *next;
2892     h->next = next;
2893     *next = temp;
2894     }
2895   }
2896 #endif
2897
2898 /* Remove any duplicate IP addresses and then scan the list of hosts for any
2899 whose IP addresses are on the local host. If any are found, all hosts with the
2900 same or higher MX values are removed. However, if the local host has the lowest
2901 numbered MX, then HOST_FOUND_LOCAL is returned. Otherwise, if at least one host
2902 with an IP address is on the list, HOST_FOUND is returned. Otherwise,
2903 HOST_FIND_FAILED is returned, but in this case do not update the yield, as it
2904 might have been set to HOST_FIND_AGAIN just above here. If not, it will already
2905 be HOST_FIND_FAILED. */
2906
2907 host_remove_duplicates(host, &last);
2908 rc = host_scan_for_local_hosts(host, &last, removed);
2909 if (rc != HOST_FIND_FAILED) yield = rc;
2910
2911 DEBUG(D_host_lookup)
2912   {
2913   if (fully_qualified_name != NULL)
2914     debug_printf("fully qualified name = %s\n", *fully_qualified_name);
2915   debug_printf("host_find_bydns yield = %s (%d); returned hosts:\n",
2916     (yield == HOST_FOUND)? "HOST_FOUND" :
2917     (yield == HOST_FOUND_LOCAL)? "HOST_FOUND_LOCAL" :
2918     (yield == HOST_FIND_AGAIN)? "HOST_FIND_AGAIN" :
2919     (yield == HOST_FIND_FAILED)? "HOST_FIND_FAILED" : "?",
2920     yield);
2921   for (h = host; h != last->next; h = h->next)
2922     {
2923     debug_printf("  %s %s MX=%d ", h->name,
2924       (h->address == NULL)? US"<null>" : h->address, h->mx);
2925     if (h->port != PORT_NONE) debug_printf("port=%d ", h->port);
2926     if (h->status >= hstatus_unusable) debug_printf("*");
2927     debug_printf("\n");
2928     }
2929   }
2930
2931 return yield;
2932 }
2933
2934
2935
2936
2937 /*************************************************
2938 **************************************************
2939 *             Stand-alone test program           *
2940 **************************************************
2941 *************************************************/
2942
2943 #ifdef STAND_ALONE
2944
2945 int main(int argc, char **cargv)
2946 {
2947 host_item h;
2948 int whichrrs = HOST_FIND_BY_MX | HOST_FIND_BY_A;
2949 BOOL byname = FALSE;
2950 BOOL qualify_single = TRUE;
2951 BOOL search_parents = FALSE;
2952 uschar **argv = USS cargv;
2953 uschar buffer[256];
2954
2955 primary_hostname = US"";
2956 store_pool = POOL_MAIN;
2957 debug_selector = D_host_lookup|D_interface;
2958 debug_file = stdout;
2959 debug_fd = fileno(debug_file);
2960
2961 printf("Exim stand-alone host functions test\n");
2962
2963 host_find_interfaces();
2964 debug_selector = D_host_lookup | D_dns;
2965
2966 if (argc > 1) primary_hostname = argv[1];
2967
2968 /* So that debug level changes can be done first */
2969
2970 dns_init(qualify_single, search_parents);
2971
2972 printf("Testing host lookup\n");
2973 printf("> ");
2974 while (Ufgets(buffer, 256, stdin) != NULL)
2975   {
2976   int rc;
2977   int len = Ustrlen(buffer);
2978   uschar *fully_qualified_name;
2979
2980   while (len > 0 && isspace(buffer[len-1])) len--;
2981   buffer[len] = 0;
2982
2983   if (Ustrcmp(buffer, "q") == 0) break;
2984
2985   if (Ustrcmp(buffer, "byname") == 0) byname = TRUE;
2986   else if (Ustrcmp(buffer, "no_byname") == 0) byname = FALSE;
2987   else if (Ustrcmp(buffer, "a_only") == 0) whichrrs = HOST_FIND_BY_A;
2988   else if (Ustrcmp(buffer, "mx_only") == 0) whichrrs = HOST_FIND_BY_MX;
2989   else if (Ustrcmp(buffer, "srv_only") == 0) whichrrs = HOST_FIND_BY_SRV;
2990   else if (Ustrcmp(buffer, "srv+a") == 0)
2991     whichrrs = HOST_FIND_BY_SRV | HOST_FIND_BY_A;
2992   else if (Ustrcmp(buffer, "srv+mx") == 0)
2993     whichrrs = HOST_FIND_BY_SRV | HOST_FIND_BY_MX;
2994   else if (Ustrcmp(buffer, "srv+mx+a") == 0)
2995     whichrrs = HOST_FIND_BY_SRV | HOST_FIND_BY_MX | HOST_FIND_BY_A;
2996   else if (Ustrcmp(buffer, "qualify_single") == 0) qualify_single = TRUE;
2997   else if (Ustrcmp(buffer, "no_qualify_single") == 0) qualify_single = FALSE;
2998   else if (Ustrcmp(buffer, "search_parents") == 0) search_parents = TRUE;
2999   else if (Ustrcmp(buffer, "no_search_parents") == 0) search_parents = FALSE;
3000   else if (Ustrcmp(buffer, "test_harness") == 0)
3001     running_in_test_harness = !running_in_test_harness;
3002   else if (Ustrcmp(buffer, "res_debug") == 0)
3003     {
3004     _res.options ^= RES_DEBUG;
3005     }
3006   else if (Ustrncmp(buffer, "retrans", 7) == 0)
3007     {
3008     (void)sscanf(CS(buffer+8), "%d", &dns_retrans);
3009     _res.retrans = dns_retrans;
3010     }
3011   else if (Ustrncmp(buffer, "retry", 5) == 0)
3012     {
3013     (void)sscanf(CS(buffer+6), "%d", &dns_retry);
3014     _res.retry = dns_retry;
3015     }
3016   else
3017     {
3018     int flags = whichrrs;
3019
3020     h.name = buffer;
3021     h.next = NULL;
3022     h.mx = MX_NONE;
3023     h.port = PORT_NONE;
3024     h.status = hstatus_unknown;
3025     h.why = hwhy_unknown;
3026     h.address = NULL;
3027
3028     if (qualify_single) flags |= HOST_FIND_QUALIFY_SINGLE;
3029     if (search_parents) flags |= HOST_FIND_SEARCH_PARENTS;
3030
3031     rc = byname?
3032       host_find_byname(&h, NULL, &fully_qualified_name, TRUE)
3033       :
3034       host_find_bydns(&h, NULL, flags, US"smtp", NULL, NULL,
3035         &fully_qualified_name, NULL);
3036
3037     if (rc == HOST_FIND_FAILED) printf("Failed\n");
3038       else if (rc == HOST_FIND_AGAIN) printf("Again\n");
3039         else if (rc == HOST_FOUND_LOCAL) printf("Local\n");
3040     }
3041
3042   printf("\n> ");
3043   }
3044
3045 printf("Testing host_aton\n");
3046 printf("> ");
3047 while (Ufgets(buffer, 256, stdin) != NULL)
3048   {
3049   int i;
3050   int x[4];
3051   int len = Ustrlen(buffer);
3052
3053   while (len > 0 && isspace(buffer[len-1])) len--;
3054   buffer[len] = 0;
3055
3056   if (Ustrcmp(buffer, "q") == 0) break;
3057
3058   len = host_aton(buffer, x);
3059   printf("length = %d ", len);
3060   for (i = 0; i < len; i++)
3061     {
3062     printf("%04x ", (x[i] >> 16) & 0xffff);
3063     printf("%04x ", x[i] & 0xffff);
3064     }
3065   printf("\n> ");
3066   }
3067
3068 printf("\n");
3069
3070 printf("Testing host_name_lookup\n");
3071 printf("> ");
3072 while (Ufgets(buffer, 256, stdin) != NULL)
3073   {
3074   int len = Ustrlen(buffer);
3075   while (len > 0 && isspace(buffer[len-1])) len--;
3076   buffer[len] = 0;
3077   if (Ustrcmp(buffer, "q") == 0) break;
3078   sender_host_address = buffer;
3079   sender_host_name = NULL;
3080   sender_host_aliases = NULL;
3081   host_lookup_msg = US"";
3082   host_lookup_failed = FALSE;
3083   if (host_name_lookup() == FAIL)  /* Debug causes printing */
3084     printf("Lookup failed:%s\n", host_lookup_msg);
3085   printf("\n> ");
3086   }
3087
3088 printf("\n");
3089
3090 return 0;
3091 }
3092 #endif  /* STAND_ALONE */
3093
3094 /* End of host.c */