- Carlo Contavalli added support for the glibc "rotate" option, as documented
[platform/upstream/c-ares.git] / CHANGES
1   Changelog for the c-ares project
2
3 * Nov 1 2008 (Daniel Stenberg)
4 - Carlo Contavalli added support for the glibc "rotate" option, as documented
5   in man resolv.conf: 
6
7   causes round robin selection of nameservers from among those listed.  This
8   has the effect of spreading the query load among all listed servers, rather
9   than having all clients try the first listed server first every time.
10
11   You can enable it with ARES_OPT_ROTATE
12
13 * Oct 21 2008 (Yang Tse)
14   Charles Hardin added handling of EINPROGRESS for UDP connects.
15
16 * Oct 18 2008 (Daniel Stenberg)
17   Charles Hardin made adig support a regular numerical dotted IP address for the
18   -s option as well.
19
20 * Oct 7 2008 (Yang Tse)
21 - Added --enable-optimize configure option to enable and disable compiler
22   optimizations to allow decoupled setting from --enable-debug.
23
24 * Oct 2 2008 (Yang Tse)
25 - Added --enable-warnings configure option to enable and disable strict
26   compiler warnings to allow decoupled setting from --enable-debug.
27
28 * Sep 17 2008 (Yang Tse)
29 - Code reorganization to allow internal/private use of "nameser.h" to any
30   system that lacks arpa/nameser.h or arpa/nameser_compat.h header files.
31
32 * Sep 16 2008 (Yang Tse)
33 - Code reorganization to allow internal/private use of ares_writev to any
34   system that lacks the writev function.
35
36 * Sep 15 2008 (Yang Tse)
37 - Code reorganization to allow internal/private use of ares_strcasecmp to any
38   system that lacks the strcasecmp function.
39
40 - Improve configure detection of some string functions.
41
42 * Sep 11 2008 (Yang Tse)
43 - Code reorganization to allow internal/private use of ares_strdup to any
44   system that lacks the strdup function.
45
46 Version 1.5.3 (Aug 29, 2008)
47
48 * Aug 25 2008 (Yang Tse)
49 - Improvement by Brad House:
50
51   This patch addresses an issue in which a response could be sent back to the
52   source port of a client from a different address than the request was made to.
53   This is one form of a DNS cache poisoning attack.
54
55   The patch simply uses recvfrom() rather than recv() and validates that the
56   address returned from recvfrom() matches the address of the server we have
57   connected to. Only necessary on UDP sockets as they are connection-less, TCP
58   is unaffected.
59
60 - Fix by George Neill:
61   Fixed compilation of acountry sample application failure on some systems.
62
63 * Aug 4 2008 (Daniel Stenberg)
64 - Fix by Tofu Linden:
65
66   The symptom:
67   * Users (usually, but not always) on 2-Wire routers and the Comcast service
68   and a wired connection to their router would find that the second and
69   subsequent DNS lookups from fresh processes using c-ares to resolve the same
70   address would cause the process to never see a reply (it keeps polling for
71   around 1m15s before giving up).
72
73   The repro:
74   * On such a machine (and yeah, it took us a lot of QA to find the systems
75   that reproduce such a specific problem!), do 'ahost www.secondlife.com',
76   then do it again.  The first process's lookup will work, subsequent lookups
77   will time-out and fail.
78
79   The cause:
80   * init_id_key() was calling randomize_key() *before* it initialized
81   key->state, meaning that the randomness generated by randomize_key() is
82   immediately overwritten with deterministic values. (/dev/urandom was also
83   being read incorrectly in the c-ares version we were using, but this was
84   fixed in a later version.)
85   * This makes the stream of generated query-IDs from any new c-ares process
86   be an identical and predictable sequence of IDs.
87   * This makes the 2-Wire's default built-in DNS server detect these queries
88   as probable-duplicates and (erroneously) not respond at all.
89
90
91 * Aug 4 2008 (Yang Tse)
92 - Autoconf 2.62 has changed the behaviour of the AC_AIX macro which we use.
93   Prior versions of autoconf defined _ALL_SOURCE if _AIX was defined. 2.62
94   version of AC_AIX defines _ALL_SOURCE and other four preprocessor symbols
95   no matter if the system is AIX or not. To keep the traditional behaviour,
96   and an uniform one across autoconf versions AC_AIX is replaced with our
97   own internal macro CARES_CHECK_AIX_ALL_SOURCE.
98
99 * Aug 1 2008 (Yang Tse)
100 - Configure process now checks if the preprocessor _REENTRANT symbol is already
101   defined. If it isn't currently defined a set of checks are performed to test
102   if its definition is required to make visible to the compiler a set of *_r
103   functions. Finally, if _REENTRANT is already defined or needed it takes care
104   of making adjustments necessary to ensure that it is defined equally for the
105   configure process tests and generated config file.
106
107 * Jul 20 2008 (Yang Tse)
108 - When recvfrom prototype uses a void pointer for arguments 2, 5 or 6 this will
109   now cause the definition, as appropriate, of RECVFROM_TYPE_ARG2_IS_VOID,
110   RECVFROM_TYPE_ARG5_IS_VOID or RECVFROM_TYPE_ARG6_IS_VOID.
111
112 * Jul 17 2008 (Yang Tse)
113 - RECVFROM_TYPE_ARG2, RECVFROM_TYPE_ARG5 and RECVFROM_TYPE_ARG6 are now defined
114   to the data type pointed by its respective argument and not the pointer type.
115
116 * Jul 16 2008 (Yang Tse)
117 - Improved configure detection of number of arguments for getservbyport_r.
118   Detection is now based on compilation checks instead of linker ones.
119
120 - Configure process now checks availability of recvfrom() socket function and
121   finds out its return type and the types of its arguments. Added definitions
122   for non-configure systems config files, and introduced macro sreadfrom which
123   will be used on udp sockets as a recvfrom() wrapper in the future.
124
125 * Jul 15 2008 (Yang Tse)
126 - Introduce definition of _REENTRANT symbol in setup.h to improve library
127   usability.  Previously the configure process only used the AC_SYS_LARGEFILE
128   macro for debug builds, now it is also used for non-debug ones enabling the
129   use of configure options --enable-largefile and --disable-largefile which
130   might be needed for library compatibility.  Remove checking the size of
131   curl_off_t, it is no longer needed.
132
133 * Jul 3 2008 (Daniel Stenberg)
134 - Phil Blundell: If you ask ares_gethostbyname() to do an AF_INET6 lookup and
135   the target host has only A records, it automatically falls back to an
136   AF_INET lookup and gives you the A results.  However, if the target host has
137   a CNAME record, this behaviour is defeated since the original query does
138   return some data even though ares_parse_aaa_reply() doesn't consider it
139   relevant. Here's a small patch to make it behave the same with and without
140   the CNAME.
141
142 * Jul 2 2008 (Yang Tse)
143 - Fallback to gettimeofday when monotonic clock is unavailable at run-time.
144
145 * Jun 30 2008 (Daniel Stenberg)
146
147 - As was pointed out to me by Andreas Schuldei, the MAXHOSTNAMELEN define is
148   not posix or anything and thus c-ares failed to build on hurd (and possibly
149   elsewhere). The define was also somewhat artificially used in the windows
150   port. Now, I instead rewrote the use of gethostbyname to enlarge the host
151   name buffer in case of need and totally avoid the use of the MAXHOSTNAMELEN
152   define. I thus also removed the defien from the namser.h file where it was
153   once added for the windows build.
154
155   I also fixed init_by_defaults() function to not leak memory in case if
156   error.
157
158 * Jun 9 2008 (Yang Tse)
159
160 - Make libcares.pc generated file for pkg-config include information relative
161   to the libraries needed for the static linking of c-ares.
162
163 * May 30 2008 (Yang Tse)
164
165 - Brad House fixed a missing header file inclusion in adig sample program.
166
167 Version 1.5.2 (May 29, 2008)
168
169 * May 13 2008 (Daniel Stenberg)
170
171 - Introducing millisecond resolution support for the timeout option. See
172   ares_init_options()'s ARES_OPT_TIMEOUTMS.
173
174 * May 9 2008 (Yang Tse)
175
176 - Use monotonic time source if available, for private function ares__tvnow()
177
178 * May 7 2008 (Daniel Stenberg)
179
180 - Sebastian made c-ares able to return all PTR-records when doing reverse
181   lookups. It is not common practice to have multiple PTR-Records for a single
182   IP, but its perfectly legal and some sites have those.
183
184 - Doug Goldstein provided a configure patch: updates autoconf 2.13 usage to
185   autoconf 2.57 usage (which is the version you have specified as the minimum
186   version). It's a minor change but it does clean up some warnings with newer
187   autoconf (specifically 2.62).
188
189 * May 5 2008 (Yang Tse)
190
191 - Improved parsing of resolver configuration files.
192
193 * April 4 2008 (Daniel Stenberg)
194
195 - Eino Tuominen improved the code when a file is used to seed the randomizer.
196
197 - Alexey Simak made adig support NAPTR records
198
199 - Alexey Simak fixed the VC dsp file by adding the missing source file
200   ares_expand_string.c
201
202 * December 11 2007 (Gisle Vanem)
203
204 - Added another sample application; acountry.c which converts an
205   IPv4-address(es) and/or host-name(s) to country-name and country-code.
206   This uses the service of the DNSBL at countries.nerd.dk.
207
208 * December 3 2007 (Daniel Stenberg)
209
210 - Brad Spencer fixed the configure script to assume that there's no
211   /dev/urandom when built cross-compiled as then the script cannot check for
212   it.
213
214 - Erik Kline cleaned up ares_gethostbyaddr.c:next_lookup() somewhat
215
216 Version 1.5.1 (Nov 21, 2007)
217
218 * November 21 2007 (Daniel Stenberg)
219
220 - Robin Cornelius pointed out that ares_llist.h was missing in the release
221   archive for 1.5.0
222
223 Version 1.5.0 (Nov 21, 2007)
224
225 * October 2 2007 (Daniel Stenberg)
226
227 - ares_strerror() segfaulted if the input error number was out of the currently
228   supported range.
229
230 - Yang Tse: Avoid a segfault when generating a DNS "Transaction ID" in
231   internal function init_id_key() under low memory conditions.
232
233 * September 28 2007 (Daniel Stenberg)
234
235 - Bumped version to 1.5.0 for next release and soname bumped to 2 due to ABI
236   and API changes in the progress callback (and possibly more coming up from
237   Steinar)
238
239 * September 28 2007 (Steinar H. Gunderson)
240
241 - Don't skip a server if it's the only one. (Bugfix from the Google tree.)
242
243 - Made the query callbacks receive the number of timeouts that happened during
244   the execution of a query, and updated documentation accordingly. (Patch from
245   the Google tree.)
246
247 - Support a few more socket options: ARES_OPT_SOCK_SNDBUF and
248   ARES_OPT_SOCK_RCVBUF
249
250 - Always register for TCP events even if there are no outstanding queries, as
251   the other side could always close the connection, which is a valid event
252   which should be responded to.
253
254 * September 22 2007 (Daniel Stenberg)
255
256 - Steinar H. Gunderson fixed: Correctly clear sockets from the fd_set on in
257   several functions (write_tcp_data, read_tcp_data, read_udp_packets) so that
258   if it fails and the socket is closed the following code doesn't try to use
259   the file descriptor.
260
261 - Steinar H. Gunderson modified c-ares to now also do to DNS retries even when
262   TCP is used since there are several edge cases where it still makes sense.
263
264 - Brad House provided a fix for ares_save_options():
265
266   Apparently I overlooked something with the ares_save_options() where it
267   would try to do a malloc(0) when no options of that type needed to be saved.
268   On most platforms, this was fine because malloc(0) doesn't actually return
269   NULL, but on AIX it does, so ares_save_options would return ARES_ENOMEM.
270
271 * July 14 2007 (Daniel Stenberg)
272
273 - Vlad Dinulescu fixed two outstanding valgrind reports:
274
275   1. In ares_query.c , in find_query_by_id we compare q->qid (which is a short
276   int variable) with qid, which is declared as an int variable.  Moreover,
277   DNS_HEADER_SET_QID is used to set the value of qid, but DNS_HEADER_SET_QID
278   sets only the first two bytes of qid. I think that qid should be declared as
279   "unsigned short" in this function.
280
281   2. The same problem occurs in ares_process.c, process_answer() .  query->qid
282   (an unsigned short integer variable) is compared with id, which is an
283   integer variable. Moreover, id is initialized from DNS_HEADER_QID which sets
284   only the first two bytes of id. I think that the id variable should be
285   declared as "unsigned short" in this function.
286
287   Even after declaring these variables as "unsigned short", the valgrind
288   errors are still there. Which brings us to the third problem.
289
290   3. The third problem is that Valgrind assumes that query->qid is not
291   initialised correctly. And it does that because query->qid is set from
292   DNS_HEADER_QID(qbuf); Valgrind says that qbuf has unitialised bytes. And
293   qbuf has uninitialised bytes because of channel->next_id . And next_id is
294   set by ares_init.c:ares__generate_new_id() . I found that putting short r=0
295   in this function (instead of short r) makes all Valgrind warnings go away.
296   I have studied ares__rc4() too, and this is the offending line:
297
298         buffer_ptr[counter] ^= state[xorIndex];   (ares_query.c:62)
299
300   This is what triggers Valgrind.. buffer_ptr is unitialised in this function,
301   and by applying ^= on it, it remains unitialised.
302
303 Version 1.4.0 (June 8, 2007)
304
305 * June 4 2007 (Daniel Stenberg)
306
307 - James Bursa reported a major memory problem when resolving multi-IP names
308   and I found and fixed the problem. It was added by Ashish Sharma's patch
309   two days ago.
310
311   When I then tried to verify multiple entries in /etc/hosts after my fix, I
312   got another segfault and decided this code was not ripe for inclusion and I
313   reverted the patch.
314
315 * June 2 2007
316
317 - Brad Spencer found and fixed three flaws in the code, found with the new
318   gcc 4.2.0 warning: -Waddress
319
320 - Brad House fixed VS2005 compiler warnings due to time_t being 64bit.
321   He also made recent Microsoft compilers use _strdup() instead of strdup().
322
323 - Brad House's man pages for ares_save_options() and ares_destroy_options()
324   were added.
325
326 - Ashish Sharma provided a patch for supporting multiple entries in the
327   /etc/hosts file. Patch edited for coding style and functionality by me
328   (Daniel).
329
330 * May 30 2007
331
332 - Shmulik Regev brought cryptographically secure transaction IDs:
333
334   The c-ares library implementation uses a DNS "Transaction ID" field that is
335   seeded with a pseudo random number (based on gettimeofday) which is
336   incremented (++) between consecutive calls and is therefore rather
337   predictable. In general, predictability of DNS Transaction ID is a well
338   known security problem (e.g.
339   http://bak.spc.org/dms/archive/dns_id_attack.txt) and makes a c-ares based
340   implementation vulnerable to DNS poisoning. Credit goes to Amit Klein
341   (Trusteer) for identifying this problem.
342
343   The patch I wrote changes the implementation to use a more secure way of
344   generating unique IDs. It starts by obtaining a key with reasonable entropy
345   which is used with an RC4 stream to generate the cryptographically secure
346   transaction IDs.
347
348   Note that the key generation code (in ares_init:randomize_key) has two
349   versions, the Windows specific one uses a cryptographically safe function
350   provided (but undocumented :) by the operating system (described at
351   http://blogs.msdn.com/michael_howard/archive/2005/01/14/353379.aspx).  The
352   default implementation is a bit naive and uses the standard 'rand'
353   function. Surely a better way to generate random keys exists for other
354   platforms.
355
356   The patch can be tested by using the adig utility and using the '-s' option.
357
358 - Brad House added ares_save_options() and ares_destroy_options() that can be
359   used to keep options for later re-usal when ares_init_options() is used.
360
361   Problem: Calling ares_init() for each lookup can be unnecessarily resource
362          intensive.  On windows, it must LoadLibrary() or search the registry
363          on each call to ares_init().  On unix, it must read and parse
364          multiple files to obtain the necessary configuration information.  In
365          a single-threaded environment, it would make sense to only
366          ares_init() once, but in a heavily multi-threaded environment, it is
367          undesirable to ares_init() and ares_destroy() for each thread created
368          and track that.
369
370   Solution: Create ares_save_options() and ares_destroy_options() functions to
371          retrieve and free options obtained from an initialized channel.  The
372          options populated can be used to pass back into ares_init_options(),
373          it should populate all needed fields and not retrieve any information
374          from the system.  Probably wise to destroy the cache every minute or
375          so to prevent the data from becoming stale.
376
377 - Daniel S added ares_process_fd() to allow applications to ask for processing
378   on specific sockets and thus avoiding select() and associated
379   functions/macros.  This function will be used by upcoming libcurl releases
380   for this very reason. It also made me export the ares_socket_t type in the
381   public ares.h header file, since ares_process_fd() uses that type for two of
382   the arguments.
383
384 * May 25 2007
385
386 - Ravi Pratap fixed a flaw in the init_by_resolv_conf() function for windows
387   that could cause it to return a bad return code.
388
389 * April 16 2007
390
391 - Yang Tse: Provide ares_getopt() command-line parser function as a source
392   code helper function, not belonging to the actual c-ares library.
393
394 * February 19 2007
395
396 - Vlad Dinulescu added ares_parse_ns_reply().
397
398 * February 13 2007
399
400 - Yang Tse: Fix failure to get the search sequence of /etc/hosts and
401   DNS from /etc/nsswitch.conf, /etc/host.conf or /etc/svc.conf when
402   /etc/resolv.conf did not exist or was unable to read it.
403
404 * November 22 2006
405
406 - Install ares_dns.h too
407
408 - Michael Wallner fixed this problem: When I set domains in the options
409   struct, and there are domain/search entries in /etc/resolv.conf, the domains
410   of the options struct will be overridden.
411
412 * November 6 2006
413
414 - Yang Tse removed a couple of potential zero size memory allocations.
415
416 - Andreas Rieke fixed the line endings in the areslib.dsp file that I (Daniel)
417   broke in the 1.3.2 release. We should switch to a system where that file is
418   auto-generated. We could rip some code for that from curl...
419
420 Version 1.3.2 (November 3, 2006)
421
422 * October 12 2006
423
424 - Prevent ares_getsock() to overflow if more than 16 sockets are used.
425
426 * September 11 2006
427
428 - Guilherme Balena Versiani: I noted a strange BUG in Win32 port
429   (ares_init.c/get_iphlpapi_dns_info() function): when I disable the network
430   by hand or disconnect the network cable in Windows 2000 or Windows XP, my
431   application gets 127.0.0.1 as the only name server. The problem comes from
432   'GetNetworkParams' function, that returns the empty string "" as the only
433   name server in that case. Moreover, the Windows implementation of
434   inet_addr() returns INADDR_LOOPBACK instead of INADDR_NONE.
435
436 * August 29 2006
437
438 - Brad Spencer did
439
440   o made ares_version.h use extern "C" for c++ compilers
441   o fixed compiler warnings in ares_getnameinfo.c
442   o fixed a buffer position init for TCP reads
443
444 * August 3 2006
445
446 - Ravi Pratap fixed ares_getsock() to actually return the proper bitmap and
447   not always zero!
448
449 Version 1.3.1 (June 24, 2006)
450
451 * July 23, 2006
452
453 - Gisle Vanem added getopt() to the ahost program. Currently accepts
454   only [-t {a|aaaa}] to specify address family in ares_gethostbyname().
455
456 * June 19, 2006
457
458 - (wahern) Removed "big endian" DNS section and RR data integer parser
459   macros from ares_dns.h, which break c-ares on my Sparc64. Bit-wise
460   operations in C operate on logical values. And in any event the octets are
461   already in big-endian (aka network) byte order so they're being reversed
462   (thus the source of the breakage).
463
464 * June 18, 2006
465
466 - William Ahern handles EAGAIN/EWOULDBLOCK errors in most of the I/O calls
467   from area_process.c.
468
469   TODO: Handle one last EAGAIN for a UDP socket send(2) in
470   ares__send_query().
471
472 * May 10, 2006
473
474 - Bram Matthys brought my attention to a libtool peculiarity where detecting
475   things such as C++ compiler actually is a bad thing and since we don't need
476   that detection I added a work-around, much inspired by a previous patch by
477   Paolo Bonzini. This also shortens the configure script quite a lot.
478
479 * May 3, 2006
480
481 - Nick Mathewson added the ARES_OPT_SOCK_STATE_CB option that when set makes
482   c-ares call a callback on socket state changes. A better way than the
483   ares_getsock() to get full control over the socket state.
484
485 * January 9, 2006
486
487 - Alexander Lazic improved the getservbyport_r() configure check.
488
489 * January 6, 2006
490
491 - Alexander Lazic pointed out that the buildconf should use the ACLOCAL_FLAGS
492   variable for easier controlling what it does and how it runs.
493
494 * January 5, 2006
495
496 - James Bursa fixed c-ares to find the hosts file on RISC OS, and made it
497   build with newer gcc versions that no longer defines "riscos".
498
499 * December 22
500
501 - Daniel Stenberg added ares_getsock() that extracts the set of sockets to
502   wait for action on. Similar to ares_fds() but not restricted to using
503   select() for the waiting.
504
505 * November 25
506
507 - Yang Tse fixed some send() / recv() compiler warnings
508
509 * September 18
510
511 - Added constants that will be used by ares_getaddrinfo
512
513 - Made ares_getnameinfo use the reentrant getservbyport (getservbyport_r) if it
514   is available to ensure it works properly in a threaded environment.
515
516 * September 10
517
518 - configure fix for detecting a member in the sockaddr_in6 struct which failed
519   on ipv6-enabled HP-UX 11.00
520
521 Version 1.3.0 (August 29, 2005)
522
523 * August 21
524
525 - Alfredo Tupone provided a fix for the Windows code in get_iphlpapi_dns_info()
526   when getting the DNS server etc.
527
528 * June 19
529
530 - Added some checks for the addrinfo structure.
531
532 * June 2
533
534 - William Ahern:
535
536   Make UDP sockets non-blocking. I've confirmed that at least on Linux 2.4 a
537   read event can come back from poll() on a valid SOCK_DGRAM socket but
538   recv(2) will still block. This patch doesn't ignore EAGAIN in
539   read_udp_packets(), though maybe it should. (This patch was edited by Daniel
540   Stenberg and a new configure test was added (imported from curl's configure)
541   to properly detect what non-blocking socket approach to use.)
542
543   I'm not quite sure how this was happening, but I've been seeing PTR queries
544   which seem to return empty responses. At least, they were empty when calling
545   ares_expand_name() on the record. Here's a patch which guarantees to
546   NUL-terminate the expanded name. The old behavior failed to NUL-terminate if
547   len was 0, and this was causing strlen() to run past the end of the buffer
548   after calling ares_expand_name() and getting ARES_SUCCESS as the return
549   value. If q is not greater than *s then it's equal and *s is always
550   allocated with at least one byte.
551
552 * May 16
553
554 - Added ares_getnameinfo which mimics the getnameinfo API (another feature
555   that could use testing).
556
557 * May 14
558
559 - Added an inet_ntop function from BIND for systems that do not have it.
560
561 * April 9
562
563 - Made sortlist support IPv6 (this can probably use some testing).
564
565 - Made sortlist support CIDR matching for IPv4.
566
567 * April 8
568
569 - Added preliminary IPv6 support to ares_gethostbyname. Currently, sortlist
570   does not work with IPv6. Also provided an implementation of bitncmp from
571   BIND for systems that do not supply this function. This will be used to add
572   IPv6 support to sortlist.
573
574 - Made ares_gethostbyaddr support IPv6 by specifying AF_INET6 as the family.
575   The function can lookup IPv6 addresses both from files (/etc/hosts) and
576   DNS lookups.
577
578 * April 7
579
580 - Tupone Alfredo fixed includes of arpa/nameser_compat.h to build fine on Mac
581   OS X.
582
583 * April 5
584
585 - Dominick Meglio: Provided implementations of inet_net_pton and inet_pton
586   from BIND for systems that do not include these functions.
587
588 * March 11, 2005
589
590 - Dominick Meglio added ares_parse_aaaa_reply.c and did various
591   adjustments. The first little steps towards IPv6 support!
592
593 * November 7
594
595 - Fixed the VC project and makefile to use ares_cancel and ares_version
596
597 * October 24
598
599 - The released ares_version.h from 1.2.1 says 1.2.0 due to a maketgz flaw.
600   This is now fixed.
601
602 Version 1.2.1 (October 20, 2004)
603
604 * September 29
605
606 - Henrik Stoerner fix: got a report that Tru64 Unix (the unix from Digital
607   when they made Alpha's) uses /etc/svc.conf for the purpose fixed below for
608   other OSes. He made c-ares check for and understand it if present.
609
610 - Now c-ares will use local host name lookup _before_ DNS resolving by default
611   if nothing else is told.
612
613 * September 26
614
615 - Henrik Stoerner: found out that c-ares does not look at the /etc/host.conf
616   file to determine the sequence in which to search /etc/hosts and DNS.  So on
617   systems where this order is defined by /etc/host.conf instead of a "lookup"
618   entry in /etc/resolv.conf, c-ares will always default to looking in DNS
619   first, and /etc/hosts second.
620
621   c-ares now looks at
622
623   1) resolv.conf (for the "lookup" line);
624   2) nsswitch.fon (for the "hosts:" line);
625   3) host.conf (for the "order" line).
626
627   First match wins.
628
629 - Dominick Meglio patched: C-ares on Windows assumed that the HOSTS file is
630   located in a static location. It assumed
631   C:\Windows\System32\Drivers\Etc. This is a poor assumption to make. In fact,
632   the location of the HOSTS file can be changed via a registry setting.
633
634   There is a key called DatabasePath which specifies the path to the HOSTS
635   file:
636   http://www.microsoft.com/technet/itsolutions/network/deploy/depovg/tcpip2k.mspx
637
638   The patch will make c-ares correctly consult the registry for the location
639   of this file.
640
641 * August 29
642
643 - Gisle Vanem fixed the MSVC build files.
644
645 * August 20
646
647 - Gisle Vanem made c-ares build and work with his Watt-32 TCP/IP stack.
648
649 * August 13
650
651 - Harshal Pradhan made a minor syntax change in ares_init.c to make it build
652   fine with MSVC 7.1
653
654 * July 24
655
656 - Made the lib get built static only if --enable-debug is used.
657
658 - Gisle Vanem fixed:
659
660   Basically in loops like handle_errors(), 'query->next' was assigned a local
661   variable and then query was referenced after the memory was freed by
662   next_server(). I've changed that so next_server() and end_query() returns
663   the next query. So callers should use this ret-value.
664
665   The next problem was that 'server->tcp_buffer_pos' had a random value at
666   entry to 1st recv() (luckily causing Winsock to return ENOBUFS).
667
668   I've also added a ares_writev() for Windows to streamline the code a bit
669   more.
670
671 * July 20
672 - Fixed a few variable return types for some system calls. Made configure
673   check for ssize_t to make it possible to use that when receiving the send()
674   error code. This is necessary to prevent compiler warnings on some systems.
675
676 - Made configure create config.h, and all source files now include setup.h that
677   might include the proper config.h (or a handicrafted alternative).
678
679 - Switched to 'ares_socket_t' type for sockets in ares, since Windows don't
680   use 'int' for that.
681
682 - automake-ified and libool-ified c-ares. Now it builds libcares as a shared
683   lib on most platforms if wanted. (This bloated the size of the release
684   archive with another 200K!)
685
686 - Makefile.am now uses Makefile.inc for the c sources, h headers and man
687   pages, to make it easier for other makefiles to use the exact same set of
688   files.
689
690 - Adjusted 'maketgz' to use the new automake magic when building distribution
691   archives.
692
693 - Anyone desires HTML and/or PDF versions of the man pages in the release
694   archives?
695
696 * July 3
697 - Günter Knauf made c-ares build and run on Novell Netware.
698
699 * July 1
700 - Gisle Vanem provided Makefile.dj to build with djgpp, added a few more djgpp
701   fixes and made ares not use 'errno' to provide further info on Windows.
702
703 * June 30
704 - Gisle Vanem made it build with djgpp and run fine with the Watt-32 stack.
705
706 * June 10
707 - Gisle Vanem's init patch for Windows:
708
709   The init_by_resolv_conf() function fetches the DNS-server(s)
710   from a series of registry branches.
711
712   This can be wrong in the case where DHCP has assigned nameservers, but the
713   user has overridden these servers with other prefered settings. Then it's
714   wrong to use the DHCPNAMESERVER setting in registry.
715
716   In the case of no global DHCP-assigned or fixed servers, but DNS server(s)
717   per adapter, one has to query the adapter branches.  But how can c-ares know
718   which adapter is valid for use? AFAICS it can't. There could be one adapter
719   that is down (e.g. a VPN adapter).
720
721   So it's better to leave this to the IP Helper API (iphlapi) available in
722   Win-98/2000 and later. My patch falls-back to the old way if not available.
723
724 * June 8
725 - James Bursa fixed an init issue for RISC OS.
726
727 * May 11
728 - Nico Stappenbelt reported that when processing domain and search lines in
729   the resolv.conf file, the first entry encountered is processed and used as
730   the search list. According to the manual pages for both Linux, Solaris and
731   Tru64, the last entry of either a domain or a search field is used.
732
733   This is now adjusted in the code
734
735 Version 1.2.0 (April 13, 2004)
736
737 * April 2, 2004
738 - Updated various man pages to look nicer when converted to HTML on the web
739   site.
740
741 * April 1, 2004
742 - Dirk Manske provided a new function that is now named ares_cancel(). It is
743   used to cancel/cleanup a resolve/request made using ares functions on the
744   given ares channel. It does not destroy/kill the ares channel itself.
745
746 - Dominick Meglio cleaned up the formatting in several man pages.
747
748 * March 30, 2004
749 - Dominick Meglio's new ares_expand_string. A helper function when decoding
750   incoming DNS packages.
751
752 - Daniel Stenberg modified the Makefile.in to use a for loop for the man page
753   installation to improve overview and make it easier to add man pages.
754
755 Version 1.1.0 (March 11, 2004)
756
757 * March 9, 2004
758 - Gisle Vanem improved build on Windows.
759
760 * February 25, 2004
761 - Dan Fandrich found a flaw in the Feb 22 fix.
762
763 - Added better configure --enable-debug logic (taken from the curl configure
764   script). Added acinclude.m4 to the tarball.
765
766 * February 23, 2004
767 - Removed ares_free_errmem(), the function, the file and the man page. It was
768   not used and it did nothing.
769
770 - Fixed a lot of code that wasn't "64bit clean" and thus caused a lot of
771   compiler warnings on picky compilers.
772
773 * February 22, 2004
774 - Dominick Meglio made ares init support multiple name servers in the
775   NameServer key on Windows.
776
777 * February 16, 2004
778 - Modified ares_private.h to include libcurl's memory debug header if
779   CURLDEBUG is set. This makes all the ares-functions supervised properly by
780   the curl test suite. This also forced me to add inclusion of the
781   ares_private.h header in a few more files that are using some kind of
782   memory-related resources.
783
784 - Made the makefile only build ahost and adig if 'make demos' is used.
785
786 * February 10, 2004
787 - Dirk Manske made ares_version.h installed with 'make install'
788
789 * February 4, 2004
790 - ares_free_errmem() is subject for removal, it is simply present for future
791   purposes, and since we removed the extra parameter in strerror() it won't
792   be used by c-ares!
793 - configure --enable-debug now enables picky compiler options if gcc is used
794 - fixed several compiler warnings --enable-debug showed and Joerg Mueller-Tolk
795   reported
796
797 Version 1.0.0 (February 3, 2004)
798
799 * February 3, 2004
800 - now we produce the libcares.a library instead of the previous libares.a
801   since we are no longer compatible
802
803 * February 2, 2004
804
805 - ares_strerror() has one argument less. This is the first official
806   modification of the existing provided ares API.
807
808 * January 29, 2004
809
810 - Dirk Manske fixed how the socket is set non-blocking.
811
812 * January 4, 2004
813
814 - Dominick Meglio made the private gettimeofday() become ares_gettimeofday()
815   instead in order to not pollute the name space and risk colliding with
816   other libraries' versions of this function.
817
818 * October 24, 2003. Daniel Stenberg
819
820   Added ares_version().
821
822 Version 1.0-pre1 (8 October 2003)
823
824 - James Bursa made it run on RISC OS
825
826 - Dominick Meglio made it run fine on NT4
827
828 - Duncan Wilcox made it work fine on Mac OS X
829
830 - Daniel Stenberg adjusted the windows port
831
832 - liren at vivisimo.com made the initial windows port
833
834 * Imported the sources from ares 1.1.1