curl/ares
Yang Tse 115446be37 Force AIX xlc to fail and not generate object code if the source code has
compiled with errors. This behaviour is needed for autoconf macros which
rely on the ability to compile with or without errors, and is safer than
xlc's default of failing only upon severe errors.
2008-02-29 17:13:39 +00:00
..
vc The only libraries actually needed for sample programs adig and 2007-11-08 01:33:28 +00:00
.cvsignore ignore this 2004-10-24 13:02:46 +00:00
AUTHORS Brad Spencer found and fixed three flaws in the code, found with the new 2007-06-02 20:09:23 +00:00
CHANGES Added acountry.c. 2007-12-11 17:26:07 +00:00
FILES Added Makefile.vc6. 2005-11-09 22:17:13 +00:00
Makefile.am added some files which were missing in release tarballs. 2008-02-14 21:24:59 +00:00
Makefile.dj Build acountry.exe. Added 'socklen_t' define. 2007-12-11 17:22:20 +00:00
Makefile.inc oops 2007-11-21 10:12:06 +00:00
Makefile.m32 Added build of acountry.exe. 2007-12-11 17:23:18 +00:00
Makefile.netware a couple of small fixes to the makefile: 2008-02-27 01:43:12 +00:00
Makefile.vc6 Added build of acountry.exe. 2007-12-11 17:23:18 +00:00
NEWS - Fixed a few variable return types for some system calls. Made configure 2004-07-22 22:18:45 +00:00
README point out that this is a forked project, all c-ares specific stuff is now 2004-01-29 11:32:45 +00:00
README.cares edited slightly, point out our new mailinglist 2004-04-01 08:25:23 +00:00
RELEASE-NOTES and we start on 1.5.2! 2007-11-21 10:16:44 +00:00
acinclude.m4 Sync PLATFORM_AIX_V3 detection and CURL_CC_DEBUG_OPTS() 2007-10-18 15:11:51 +00:00
acountry.c Added '-d' option for Watt-32 debugging. 2008-01-02 05:30:52 +00:00
adig.c Make the query callbacks return the number of timeouts that happened during the execution of a query, and update documentation accordingly. (Patch from the Google tree.) 2007-09-28 14:46:51 +00:00
ahost.c Needed now that in6_addr is referenced in ares.h 2007-11-15 19:44:01 +00:00
ares.h Fix for targets that do have 'struct in6_addr', but which doesn't 2007-12-10 16:14:02 +00:00
ares__close_sockets.c Three fixes in one commit (sorry): a) Take care of the tcpbuf if it ends while queued for transmission, note broken servers and close them in the main loop, and store TCP socket generation number in order not to send the same query twice over the same socket. 2007-09-28 14:28:14 +00:00
ares__get_hostent.c Ashish Sharma provided a patch for supporting multiple entries in the 2007-06-02 19:42:25 +00:00
ares__read_line.c 2nd try adding CVS id. 2006-07-22 15:37:10 +00:00
ares_cancel.3 This function was added in c-ares [version] 2005-12-22 15:31:32 +00:00
ares_cancel.c Clarified the comment over ares_cancel. 2007-10-04 08:06:25 +00:00
ares_destroy.3 NORECURSE clarification, minor formatting update 2004-12-07 10:43:21 +00:00
ares_destroy.c Moved the NULL check for channel upwards in ares_destroy(). 2007-10-04 08:07:47 +00:00
ares_destroy_options.3 ares_destroy_options() and ares_save_options() man pages by Brad House 2007-06-02 19:32:30 +00:00
ares_dns.h compiler warning fix 2007-02-16 14:22:08 +00:00
ares_expand_name.3 removed odd newline 2004-02-03 08:47:26 +00:00
ares_expand_name.c We should standarise on C comments. 2007-09-29 14:37:47 +00:00
ares_expand_string.3 Mention first version with CURLOPT_COPYPOSTFIELDS. 2007-10-15 21:19:40 +00:00
ares_expand_string.c Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +00:00
ares_fds.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_fds.c Previously, processing a large batch of timeouts was O(n^2) in the number of 2007-09-29 18:18:47 +00:00
ares_free_hostent.3 added another SEE ALSO 2007-07-14 23:01:49 +00:00
ares_free_hostent.c fix the bad bad bad mess this caused on name resolves returning more than 2007-06-04 21:04:14 +00:00
ares_free_string.3 Dominick Meglio's new ares_expand_string() function 2004-03-30 09:06:42 +00:00
ares_free_string.c 2nd try adding CVS id. 2006-07-22 15:37:10 +00:00
ares_gethostbyaddr.3 Make the query callbacks return the number of timeouts that happened during the execution of a query, and update documentation accordingly. (Patch from the Google tree.) 2007-09-28 14:46:51 +00:00
ares_gethostbyaddr.c Fix three issues previous cleanup introduces. 2007-12-03 19:57:18 +00:00
ares_gethostbyname.3 Make the query callbacks return the number of timeouts that happened during the execution of a query, and update documentation accordingly. (Patch from the Google tree.) 2007-09-28 14:46:51 +00:00
ares_gethostbyname.c fix next_lookup() to continue searching even if c-ares failed to load the 2007-11-28 10:46:40 +00:00
ares_getnameinfo.3 Make the query callbacks return the number of timeouts that happened during the execution of a query, and update documentation accordingly. (Patch from the Google tree.) 2007-09-28 14:46:51 +00:00
ares_getnameinfo.c Another timeout fix in ares_getnameinfo(). 2007-10-04 08:09:52 +00:00
ares_getopt.c move linkage var declarations to ares_getopt.h 2007-04-16 15:35:34 +00:00
ares_getopt.h move linkage var declarations to ares_getopt.h 2007-04-16 15:35:34 +00:00
ares_getsock.3 This function was added in c-ares [version] 2005-12-22 15:31:32 +00:00
ares_getsock.c Port the TCP socket fix made in ares_fds() to ares_getsock() as well. 2007-09-29 19:26:59 +00:00
ares_init.3 Nick Mathewson added the ARES_OPT_SOCK_STATE_CB option that when set makes 2006-05-03 06:11:44 +00:00
ares_init.c removed dependency on gettimeofday() since we use only 1 sec resolution here. 2007-10-22 23:31:40 +00:00
ares_init_options.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_ipv6.h Fix for targets that do have 'struct in6_addr', but which doesn't 2007-12-10 16:14:02 +00:00
ares_llist.c Avoid inline C99ism, and move c-ares routines for managing doubly-linked lists. 2007-10-02 02:18:01 +00:00
ares_llist.h Avoid inline C99ism, and move c-ares routines for managing doubly-linked lists. 2007-10-02 02:18:01 +00:00
ares_mkquery.3 minor edits 2004-04-02 09:50:42 +00:00
ares_mkquery.c Reject names that are longer than 255 characters, to avoid problems with strict or buggy DNS server implementations. (Patch from the Google tree) 2007-09-29 13:58:23 +00:00
ares_parse_a_reply.3 Return TTL data from ares_parse_{a,aaaa}_reply, if the user is so inclined. Patch from the Google tree. 2007-11-15 08:36:25 +00:00
ares_parse_a_reply.c Needed now that in6_addr is referenced in ares.h 2007-11-15 19:44:01 +00:00
ares_parse_aaaa_reply.3 Return TTL data from ares_parse_{a,aaaa}_reply, if the user is so inclined. Patch from the Google tree. 2007-11-15 08:36:25 +00:00
ares_parse_aaaa_reply.c Fix a double free. 2007-11-16 09:36:00 +00:00
ares_parse_ns_reply.3 Vlad Dinulescu added ares_parse_ns_reply() 2007-02-19 14:06:11 +00:00
ares_parse_ns_reply.c Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +00:00
ares_parse_ptr_reply.3 Dominick Meglio man page fixes 2004-04-01 06:10:56 +00:00
ares_parse_ptr_reply.c Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +00:00
ares_private.h Define WIN32 when build target is Win32 API. 2007-11-08 18:13:54 +00:00
ares_process.3 added ares_process_fd() to allow applications to ask for processing on 2007-05-30 12:58:47 +00:00
ares_process.c Renamed internal function to avoid a variable shadowing it 2007-10-18 17:17:18 +00:00
ares_query.3 Make the query callbacks return the number of timeouts that happened during the execution of a query, and update documentation accordingly. (Patch from the Google tree.) 2007-09-28 14:46:51 +00:00
ares_query.c Fix compiler warning: conversion from "int" to "unsigned char" 2007-10-18 01:01:20 +00:00
ares_save_options.3 ares_destroy_options() and ares_save_options() man pages by Brad House 2007-06-02 19:32:30 +00:00
ares_search.3 Make the query callbacks return the number of timeouts that happened during the execution of a query, and update documentation accordingly. (Patch from the Google tree.) 2007-09-28 14:46:51 +00:00
ares_search.c Fix a bug where fallback from AF_INET6 to AF_INET would not work properly together with relative search; if you had a search path of .a.com and .b.com, and foo.a.com would return ARES_ENODATA and foo.b.com would return ARES_ENOTFOUND, the lookup would not properly retry with AF_INET as it forgot the first ARES_ENODATA. 2007-10-16 21:27:51 +00:00
ares_send.3 Make the query callbacks return the number of timeouts that happened during the execution of a query, and update documentation accordingly. (Patch from the Google tree.) 2007-09-28 14:46:51 +00:00
ares_send.c Previously, processing a large batch of timeouts was O(n^2) in the number of 2007-09-29 18:18:47 +00:00
ares_strerror.3 mention incompatibilities with ares 2004-10-26 08:08:41 +00:00
ares_strerror.c Prevent ares_strerror() from segfaulting if an invalid error code is passed 2007-10-01 22:51:38 +00:00
ares_timeout.3 minor edits 2004-04-02 09:50:42 +00:00
ares_timeout.c Previously, processing a large batch of timeouts was O(n^2) in the number of 2007-09-29 18:18:47 +00:00
ares_version.3 added notes about incompatible functions 2004-02-03 09:16:40 +00:00
ares_version.c - Fixed a few variable return types for some system calls. Made configure 2004-07-22 22:18:45 +00:00
ares_version.h and we start on 1.5.2! 2007-11-21 10:16:44 +00:00
bitncmp.c Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +00:00
bitncmp.h fill in missing copyrights 2007-11-19 15:47:01 +00:00
buildconf Use $ACLOCAL_FLAGS too, pointed out by Alexander Lazic 2006-01-06 22:07:51 +00:00
config-win32.h MSVC 9.0 (VS2008) does not support Windows build targets prior to WinXP, 2007-12-18 18:08:19 +00:00
configure.ac Force AIX xlc to fail and not generate object code if the source code has 2008-02-29 17:13:39 +00:00
get_ver.awk added get_ver.awk since c-ares is a standalone project, and should therefore also compile when cURL is absent. 2008-02-27 01:51:40 +00:00
inet_net_pton.c Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +00:00
inet_net_pton.h fill in missing copyrights 2007-11-19 15:47:01 +00:00
inet_ntop.c Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +00:00
inet_ntop.h fill in missing copyrights 2007-11-19 15:47:01 +00:00
install-sh added for completeness 2003-10-08 20:18:15 +00:00
libcares.pc.in spellfix 2007-11-27 22:37:55 +00:00
maketgz maketgz now creates a ares_version.h.dist file with the given version data 2004-10-24 13:02:09 +00:00
mkinstalldirs added for completeness 2003-10-08 20:18:15 +00:00
nameser.h Needed now that in6_addr is referenced in ares.h 2007-11-15 19:44:01 +00:00
setup.h Define WIN32 when build target is Win32 API. 2007-11-08 18:13:54 +00:00
setup_once.h Windows build targets have socklen_t definition in ws2tcpip.h but some 2007-10-24 14:39:07 +00:00
windows_port.c Fixed typo. 2007-02-19 17:40:36 +00:00

README

This is c-ares, a forked version of the original ares. The original ares
README follows below, the c-ares specific details are in README.cares

====================================================================

This is ares, an asynchronous resolver library.  It is intended for
applications which need to perform DNS queries without blocking, or
need to perform multiple DNS queries in parallel.  The primary
examples of such applications are servers which communicate with
multiple clients and programs with graphical user interfaces.

This library implementation is not especially portable to crufty old
systems like SunOS 4.  It assumes a compiler which can handle ANSI C
syntax, a system malloc which properly handles realloc(NULL, foo) and
free(NULL), and a reasonably up-to-date <arpa/nameser.h>.

I have attempted to preserve the externally visible behavior of the
BIND resolver in nearly all respects.  The API of the library is, of
course, very different from the synchronous BIND API; instead of
invoking a function like res_send() and getting a return value back
indicating the number of bytes in the response, you invoke a function
like ares_send() and give it a callback function to invoke when the
response arrives.  You then have to select() on the file descriptors
indicated by ares_fds(), with a timeout given by ares_timeout().  You
call ares_process() when select() returns.

Some features are missing from the current version of ares, relative
to the BIND resolver:

	* There is no IPV6 support.
	* There is no hostname verification.
	* There is no logging of unexpected events.
	* There is no debugging-oriented logging.
	* There is no YP support.

libares requires an ANSI compiler to compile and use.  To build the
library, just run "./configure" and "make".  To install it, run "make
install".  Run "./configure --help" to see a list of options you can
provide to configure to change how the library builds.  libares has no
data files, so you can move the include file and library around freely
without leaving behind any dependencies on old paths.  Building the
library will also build the "adig" program, a little toy for trying
out the library.  It doesn't get installed.

libares is distributed at athena-dist.mit.edu:pub/ATHENA/ares.  Please
send bug reports and comments to ghudson@mit.edu.