curl/ares
Yang Tse 51b46f451f Do not halt compilation when using VS2008 to build a Windows 2000 target 2009-02-20 11:30:11 +00:00
..
m4 ignore 2009-02-13 06:34:44 +00:00
vc rearrange to allow internal/private use of ares_writev to any system 2008-09-16 16:42:48 +00:00
.cvsignore ignore libcares.pc 2008-05-12 12:22:23 +00:00
AUTHORS added the three people from RELEASE-NOTES and sorted the list alphabetically 2008-08-29 08:29:47 +00:00
CHANGES Do not halt compilation when using VS2008 to build a Windows 2000 target 2009-02-20 11:30:11 +00:00
Makefile.am Added a TODO file to list things we want changed, added or fixed. 2008-11-01 23:39:07 +00:00
Makefile.dj Removed unneeded defines HAVE_SIGNAL_H, HAVE_SIG_ATOMIC_T, 2008-12-08 14:58:56 +00:00
Makefile.inc the initial version of the ares_set_socket_callback man page 2008-12-04 12:54:43 +00:00
Makefile.m32 Added build of acountry.exe. 2007-12-11 17:23:18 +00:00
Makefile.netware added HAVE_SOCKADDR_IN6_SIN6_SCOPE_ID to ares Makefile.netware and sync'd with other Makefile.netware. 2008-12-30 08:16:24 +00:00
Makefile.vc6 ares_writev() shall not be exported when using Watt-32 (has writev). 2008-12-08 16:09:21 +00:00
NEWS - Fixed a few variable return types for some system calls. Made configure 2004-07-22 22:18:45 +00:00
README just to clarify that c-ares actually have some ipv6 support 2008-07-03 11:41:11 +00:00
README.cares use the new URL 2008-12-09 22:49:51 +00:00
RELEASE-NOTES - ares_gethostbyname() now accepts 'AF_UNSPEC' as a family for resolving 2009-01-31 20:17:41 +00:00
TODO Added a TODO file to list things we want changed, added or fixed. 2008-11-01 23:39:07 +00:00
acinclude.m4 Refactor configure script detection of functions used to set sockets into 2008-11-13 18:56:55 +00:00
acountry.c Make sure sys/socket.h is included before netinet/in.h (required by 2008-12-02 02:58:04 +00:00
adig.c fix compiler warning 2008-10-17 19:04:53 +00:00
ahost.c rearrange to allow internal/private use of ares_strcasecmp to any system that 2008-09-15 15:28:26 +00:00
ares.h - ares.h no longer uses the HAVE_STRUCT_IN6_ADDR define check, but instead it 2009-01-14 13:08:50 +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 - ares_gethostbyname() now accepts 'AF_UNSPEC' as a family for resolving 2009-01-31 20:17:41 +00:00
ares__read_line.c 2nd try adding CVS id. 2006-07-22 15:37:10 +00:00
ares__timeval.c fallback to gettimeofday when monotonic clock is unavailable at run-time 2008-07-02 03:04:56 +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_dup.3 Introduce ares_dup(3) and new thoughts about API/ABI and how to move forwards. 2008-12-03 09:59:50 +00:00
ares_expand_name.3 removed odd newline 2004-02-03 08:47:26 +00:00
ares_expand_name.c - Phil Blundell added the internal function ares__expand_name_for_response() 2009-01-11 13:49:13 +00:00
ares_expand_string.3 Mention first version with CURLOPT_COPYPOSTFIELDS. 2007-10-15 21:19:40 +00:00
ares_expand_string.c Make sure sys/socket.h is included before netinet/in.h (required by 2008-11-29 00:26:07 +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 Constified some arguments in local functions. 2009-01-18 16:33:10 +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 * February 3 2009 (Phil Blundell) 2009-02-03 14:38:09 +00:00
ares_gethostbyname_file.3 - Brad Spencer brought the new function ares_gethostbyname_file() which simply 2008-11-19 15:16:16 +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 Make use of gethostname() conditional on it being available 2008-11-28 22:41:14 +00:00
ares_getopt.c fix compiler warning: assignment within conditional expression 2008-04-07 12:40:05 +00:00
ares_getopt.h Undefine 'optarg', 'optind' and 'opterr' when using Watt-32 2008-12-08 16:11:16 +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 Introduce ares_dup(3) and new thoughts about API/ABI and how to move forwards. 2008-12-03 09:59:50 +00:00
ares_init.c Gregor Jasny provided the patch that introduces ares_set_socket_callback(), 2008-12-04 12:53:03 +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 Make sure sys/socket.h is included before netinet/in.h (required by 2008-11-29 00:26:07 +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 - Phil Blundell added the internal function ares__expand_name_for_response() 2009-01-11 13:49:13 +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 - Phil Blundell added the internal function ares__expand_name_for_response() 2009-01-11 13:49:13 +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 - Phil Blundell added the internal function ares__expand_name_for_response() 2009-01-11 13:49:13 +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 - Phil Blundell added the internal function ares__expand_name_for_response() 2009-01-11 13:49:13 +00:00
ares_private.h - Phil Blundell added the internal function ares__expand_name_for_response() 2009-01-11 13:49:13 +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 - ares__send_query() now varies the retry timeout pseudo-randomly to avoid 2009-01-13 11:51:04 +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 Make sure sys/socket.h is included before netinet/in.h (required by 2008-11-29 00:26:07 +00:00
ares_save_options.3 Introduce ares_dup(3) and new thoughts about API/ABI and how to move forwards. 2008-12-03 09:59:50 +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 fopen() returns error in 'errno' even on Windows. 2009-01-18 17:03:31 +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 Make sure sys/socket.h is included before netinet/in.h (required by 2008-11-29 00:26:07 +00:00
ares_set_socket_callback.3 the initial version of the ares_set_socket_callback man page 2008-12-04 12:54:43 +00:00
ares_strcasecmp.c rearrange to allow internal/private use of ares_strcasecmp to any system that 2008-09-15 15:28:26 +00:00
ares_strcasecmp.h rearrange to allow internal/private use of ares_strcasecmp to any system that 2008-09-15 15:28:26 +00:00
ares_strdup.c change CRLF into LF line endings 2008-09-12 05:08:18 +00:00
ares_strdup.h change CRLF into LF line endings 2008-09-12 05:08:18 +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 millisecond resolution support followup 2008-05-15 22:57:33 +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 start over on the 1.6.1 release... 2008-12-09 22:41:36 +00:00
ares_writev.c rearrange to allow internal/private use of ares_writev to any system 2008-09-16 16:42:48 +00:00
ares_writev.h rearrange to allow internal/private use of ares_writev to any system 2008-09-16 16:42:48 +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 Brad Spencer provided changes to allow buildconf to work on OS X. 2008-11-26 16:51:51 +00:00
config-win32.h Do not halt compilation when using VS2008 to build a Windows 2000 target 2009-02-20 11:30:11 +00:00
configure.ac provide a common PATH_SEPARATOR check method which is required by 2008-11-18 19:29:31 +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 HAVE_INET_PTON will only be defined when an IPv6 capable working 2008-09-24 19:13:01 +00:00
inet_net_pton.h HAVE_INET_PTON will only be defined when an IPv6 capable working 2008-09-24 19:13:01 +00:00
inet_ntop.c HAVE_INET_NTOP will only be defined when an IPv6 capable working 2008-09-24 16:43:12 +00:00
inet_ntop.h HAVE_INET_NTOP will only be defined when an IPv6 capable working 2008-09-24 16:43:12 +00:00
install-sh added for completeness 2003-10-08 20:18:15 +00:00
libcares.pc.in fix pkg-config reporting of private libraries needed for static linking 2008-06-09 01:06:48 +00:00
maketgz fix the output name 2008-08-21 00:13:48 +00:00
mkinstalldirs added for completeness 2003-10-08 20:18:15 +00:00
nameser.h adjust inclusion of "nameser.h" 2008-09-17 01:02:57 +00:00
setup.h Don't tweak the HAVE_* macros when using autoconf 2008-11-28 23:12:11 +00:00
setup_once.h Don't abort configuration if recvfrom() is not available. 2008-08-27 00:25:02 +00:00
windows_port.c adjust inclusion of "nameser.h" 2008-09-17 01:02:57 +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.                [not true for c-ares]
	* 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.