curl/ares
Daniel Stenberg e5963dae48 ignore aclocal.m4 2004-03-12 08:57:10 +00:00
..
vc ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
.cvsignore ignore aclocal.m4 2004-03-12 08:57:10 +00:00
CHANGES Gisle Vanem improved build on Windows. 2004-03-10 11:28:34 +00:00
FILES added the better debug option logic from curl by adding acinclude.m4 to the 2004-02-25 14:32:39 +00:00
Makefile.in Dirk Manske fixed the attempt to install the removed errmem manpage 2004-02-29 18:39:31 +00:00
NEWS ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +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 add link to the new cares web site 2004-02-03 09:40:19 +00:00
acinclude.m4 updated the debug option function from curl's acinclude.m4 2004-02-27 11:29:36 +00:00
adig.c make ares_expand_name() take a long * instead of an int *, since we do 2004-02-23 07:52:20 +00:00
ahost.c Gisle Vanem fixed the bad argc check 2004-03-09 09:43:30 +00:00
ares.h Don't check for HAVE_ defines in this header file, it is meant to be public 2004-02-25 07:22:00 +00:00
ares__close_sockets.c remove rcsid stuff from c files, it serves no useful purpose 2004-02-02 15:59:35 +00:00
ares__get_hostent.c remove rcsid stuff from c files, it serves no useful purpose 2004-02-02 15:59:35 +00:00
ares__read_line.c attempted typecase to silence the MIPSpro warning: 2004-03-03 13:03:35 +00:00
ares_destroy.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_destroy.c include ares_private.h to make sure we get the memdebug stuff included 2004-02-17 07:40:31 +00:00
ares_dns.h ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_expand_name.3 removed odd newline 2004-02-03 08:47:26 +00:00
ares_expand_name.c make ares_expand_name() take a long * instead of an int *, since we do 2004-02-23 07:52:20 +00:00
ares_fds.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_fds.c remove rcsid stuff from c files, it serves no useful purpose 2004-02-02 15:59:35 +00:00
ares_free_hostent.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_free_hostent.c include ares_private.h to make sure we get the memdebug stuff included 2004-02-17 07:40:31 +00:00
ares_free_string.3 takes a void *, not a char * anymore 2004-02-04 07:50:18 +00:00
ares_free_string.c ares_free_string() now takes a void * instead 2004-02-04 07:49:33 +00:00
ares_gethostbyaddr.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_gethostbyaddr.c typecase the bitfiddling results since we get a long and we store an int, 2004-02-23 07:55:58 +00:00
ares_gethostbyname.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_gethostbyname.c remove rcsid stuff from c files, it serves no useful purpose 2004-02-02 15:59:35 +00:00
ares_init.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_init.c fixed a "comparison between signed and unsigned" warning 2004-02-26 22:19:20 +00:00
ares_init_options.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_mkquery.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_mkquery.c remove rcsid stuff from c files, it serves no useful purpose 2004-02-02 15:59:35 +00:00
ares_parse_a_reply.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_parse_a_reply.c make ares_expand_name() take a long * instead of an int *, since we do 2004-02-23 07:52:20 +00:00
ares_parse_ptr_reply.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_parse_ptr_reply.c make ares_expand_name() take a long * instead of an int *, since we do 2004-02-23 07:52:20 +00:00
ares_private.h minor size_t fix to kill a warning 2004-02-27 13:21:47 +00:00
ares_process.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_process.c minor size_t fix to kill a warning 2004-02-27 13:21:47 +00:00
ares_query.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_query.c remove rcsid stuff from c files, it serves no useful purpose 2004-02-02 15:59:35 +00:00
ares_search.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_search.c more int vs long/size_t fixes after icc compiler warnings 2004-02-23 08:04:31 +00:00
ares_send.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_send.c remove rcsid stuff from c files, it serves no useful purpose 2004-02-02 15:59:35 +00:00
ares_strerror.3 added notes about incompatible functions 2004-02-03 09:16:40 +00:00
ares_strerror.c don't compare signed and unsigned 2004-02-04 07:48:46 +00:00
ares_timeout.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_timeout.c remove rcsid stuff from c files, it serves no useful purpose 2004-02-02 15:59:35 +00:00
ares_version.3 added notes about incompatible functions 2004-02-03 09:16:40 +00:00
ares_version.c return a const char * 2004-01-29 12:07:34 +00:00
ares_version.h return a const char * 2004-01-29 12:07:34 +00:00
config.guess ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
config.sub ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
configure.ac added the better debug option logic from curl by adding acinclude.m4 to the 2004-02-25 14:32:39 +00:00
install-sh added for completeness 2003-10-08 20:18:15 +00:00
maketgz use the name 'c-ares' for this package 2004-01-29 11:33:31 +00:00
mkinstalldirs added for completeness 2003-10-08 20:18:15 +00:00
nameser.h mingw has str(n)casecmp() functions 2004-03-09 10:18:09 +00:00
windows_port.c mingw has str(n)casecmp() functions 2004-03-09 10:18:09 +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.