curl/ares
Yang Tse 989aace192 Remove HAVE_CONFIG_H definition from here,
CFLAGS from common.dj already defines it.
2009-06-13 20:52:30 +00:00
..
m4 c-ares' --enable-debug --enable-curldebug decoupling follow-up 2009-06-09 17:58:34 +00:00
vc don't ignore these subdirs, they must be removed first 2009-06-13 01:44:45 +00:00
.cvsignore Allow generation of .html and .pdf versions of c-ares man pages. 2009-05-21 17:40:19 +00:00
AUTHORS added the three people from RELEASE-NOTES and sorted the list alphabetically 2008-08-29 08:29:47 +00:00
CHANGES Try to make more clear that --enable-curldebug has nothing to do with --enable-debug for this library. 2009-06-12 23:51:28 +00:00
CVS-INFO CVS-INFO file only present in CVS tree, never in release nor daily snapshot 2009-06-08 14:26:58 +00:00
Makefile.am Remove buildconf.bat from release and daily snapshot archives. 2009-06-08 14:31:35 +00:00
Makefile.dj Remove HAVE_CONFIG_H definition from here, 2009-06-13 20:52:30 +00:00
Makefile.inc Allow generation of .html and .pdf versions of c-ares man pages. 2009-05-21 17:40:19 +00:00
Makefile.m32 cope with ares_build.h and ares_rules.h 2009-04-30 11:48:43 +00:00
Makefile.netware Use build-time configured ares_socklen_t instead of socklen_t 2009-05-02 02:36:47 +00:00
Makefile.vc6 DEBUGBUILD symbol definition for debug builds 2009-06-13 00:52:48 +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 s/libcurl/c-ares 2009-05-01 18:26:03 +00:00
RELEASE-NOTES c-ares's --enable-curldebug configure option decoupled from c-ares's --enable-debug 2009-05-26 14:50:45 +00:00
TODO language fix 2009-05-26 18:03:05 +00:00
acinclude.m4 John E. Malmberg noticed that the configure script was failing to detect the 2009-06-01 09:19:16 +00:00
acountry.c Fix compiler warning: out of bound access 2009-05-29 13:19:51 +00:00
adig.c Fix compiler warning: out of bound access 2009-05-29 13:19:51 +00:00
ahost.c Introduction of ares_library_init() and ares_library_cleanup() 2009-05-17 17:11:28 +00:00
ares.h Make ares_init(), ares_dup() and ares_init_options() return ARES_ENOTINITIALIZED 2009-05-26 18:00:14 +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 fix compiler warning: implicit conversion shortens 64-bit value into a 32-bit value 2009-04-14 12:53:53 +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_build.h.dist fiX *__SOCKLEN_T definitions for remaining targets 2009-05-12 01:57:53 +00:00
ares_build.h.in ares_build.h Windows follow-up 2009-04-29 14:05:21 +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 Make ares_init(), ares_dup() and ares_init_options() return ARES_ENOTINITIALIZED 2009-05-26 18:00:14 +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 fix compiler warning: implicit conversion shortens 64-bit value into a 32-bit value 2009-04-14 12:53:53 +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 compiler warning: implicit conversion shortens 64-bit value into a 32-bit value 2009-04-14 12:53:53 +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 Force revision update, to force CVS to update the $Id date string format 2009-05-19 16:05:45 +00:00
ares_getnameinfo.c Use build-time configured ares_socklen_t instead of socklen_t 2009-05-02 02:36:47 +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 Make ares_init(), ares_dup() and ares_init_options() return ARES_ENOTINITIALIZED 2009-05-26 18:00:14 +00:00
ares_init.c Revert last change, it is inappropriate. 2009-06-12 23:50:33 +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 Use build-time configured ares_socklen_t instead of socklen_t 2009-05-02 02:36:47 +00:00
ares_library_cleanup.3 Make ares_init(), ares_dup() and ares_init_options() return ARES_ENOTINITIALIZED 2009-05-26 18:00:14 +00:00
ares_library_init.3 minor edits 2009-05-23 20:23:44 +00:00
ares_library_init.c Remove temporarily introduced memory leak. 2009-05-28 09:58:24 +00:00
ares_library_init.h Add same copyright notice as other c-ares files 2009-05-19 15:23:25 +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 use HAVE_LIMITS_H symbol to protect limits.h inclusion 2009-04-14 13:50:32 +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 use HAVE_LIMITS_H symbol to protect limits.h inclusion 2009-04-14 13:50:32 +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 fix comment 2009-06-13 00:20:41 +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 Use build-time configured ares_socklen_t instead of socklen_t 2009-05-02 02:36:47 +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_rules.h ares_socklen_t follow-up 2009-04-29 15:15:14 +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 Make ares_init(), ares_dup() and ares_init_options() return ARES_ENOTINITIALIZED 2009-05-26 18:00:14 +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 - Provide in external interface preprocessor symbol definitions for 2009-05-18 00:21:02 +00:00
ares_version.h - Provide in external interface preprocessor symbol definitions for 2009-05-18 00:21:02 +00:00
ares_writev.c use HAVE_LIMITS_H symbol to protect limits.h inclusion 2009-04-14 13:50:32 +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 when running automake copy missing files instead of symlinking them 2009-06-11 17:46:12 +00:00
buildconf.bat Ensure that buildconf.bat does nothing unless it is used with a CVS checkout. 2009-06-08 14:27:36 +00:00
config-win32.h use HAVE_LIMITS_H symbol to protect limits.h inclusion 2009-04-14 13:50:32 +00:00
config.dos initial step towards decoupling c-ares from libcurl for DOS 2009-06-13 18:13:00 +00:00
configure.ac c-ares' --enable-curldebug adjustments 2009-05-28 14:38:04 +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 Include .pdf versions of c-ares man pages in distribution tarball. 2009-05-21 17:40:55 +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 Initial step towards a configure time ares_socklen_t definition 2009-04-28 16:47:33 +00:00
setup_once.h Adjusted to take in account that... 2009-06-10 02:49:42 +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.