curl/ares
Daniel Stenberg 4969ca768d Alexander Lazic improved the getservbyport_r() configure check. 2006-01-09 08:31:48 +00:00
..
vc HAVE_xx defines moved to config-win32.h. 2005-11-11 19:14:51 +00:00
.cvsignore ignore this 2004-10-24 13:02:46 +00:00
AUTHORS Yang Tse has been helping out 2006-01-05 07:56:43 +00:00
CHANGES Alexander Lazic improved the getservbyport_r() configure check. 2006-01-09 08:31:48 +00:00
FILES Added Makefile.vc6. 2005-11-09 22:17:13 +00:00
Makefile.am removed files no longer existing 2005-11-12 00:01:50 +00:00
Makefile.dj Added '-DHAVE_SOCKADDR_IN6_SIN6_SCOPE_ID'. 2005-11-14 13:40:16 +00:00
Makefile.inc Added ares_getsock() to extract sockets to wait for action on, without being 2005-12-22 15:27:41 +00:00
Makefile.m32 Defines moved to config-win32.h. 2005-11-10 16:52:43 +00:00
Makefile.netware minor Makefile fix. 2005-08-10 21:45:59 +00:00
Makefile.vc6 Added ares_getsock.obj. 2006-01-04 14:21:57 +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
acinclude.m4 Alexander Lazic improved the getservbyport_r() configure check. 2006-01-09 08:31:48 +00:00
adig.c Fix compiler warning 2005-12-17 23:34:21 +00:00
ahost.c Update using ares_inet_pton() and ares_inet_ntop(). 2005-11-11 04:28:23 +00:00
ares.h Added ares_getsock() to extract sockets to wait for action on, without being 2005-12-22 15:27:41 +00:00
ares__close_sockets.c Changes for Watt-32 on Windows. I've assumed Configure 2004-08-20 13:45:26 +00:00
ares__get_hostent.c Added include for inet_net_pton.h to ares__get_hostent.c 2005-04-08 16:22:51 +00:00
ares__read_line.c Fix PellesC warning. 2005-12-20 20:58:51 +00:00
ares_cancel.3 This function was added in c-ares [version] 2005-12-22 15:31:32 +00:00
ares_cancel.c - Fixed a few variable return types for some system calls. Made configure 2004-07-22 22:18:45 +00:00
ares_destroy.3 NORECURSE clarification, minor formatting update 2004-12-07 10:43:21 +00:00
ares_destroy.c - Fixed a few variable return types for some system calls. Made configure 2004-07-22 22:18:45 +00:00
ares_dns.h Detect big/little endian in the configure script and adjust the ares_dns.h 2005-11-14 23:14:54 +00:00
ares_expand_name.3 removed odd newline 2004-02-03 08:47:26 +00:00
ares_expand_name.c William Ahern: 2005-06-02 11:09:10 +00:00
ares_expand_string.3 Dominick Meglio's new ares_expand_string() function 2004-03-30 09:06:42 +00:00
ares_expand_string.c Changes for Watt-32 on Windows. I've assumed Configure 2004-08-20 13:45:26 +00:00
ares_fds.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_fds.c Detabified. Added CVS id. 2005-11-11 19:20:22 +00:00
ares_free_hostent.3 Made ares_free_hostent man page refer to ares_parse_aaaa_reply 2005-05-16 19:23:57 +00:00
ares_free_hostent.c Changes for Watt-32 on Windows. I've assumed Configure 2004-08-20 13:45:26 +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 - Fixed a few variable return types for some system calls. Made configure 2004-07-22 22:18:45 +00:00
ares_gethostbyaddr.3 edits, mainly to make the generated html output nicer 2004-04-02 09:56:01 +00:00
ares_gethostbyaddr.c Detabified. Added CVS id. 2005-11-11 19:20:22 +00:00
ares_gethostbyname.3 edits, mainly to make the generated html output nicer 2004-04-02 09:56:01 +00:00
ares_gethostbyname.c detabified 2005-08-18 08:48:31 +00:00
ares_getnameinfo.3 Added ares_getnameinfo which mimics the getnameinfo API 2005-05-16 18:06:54 +00:00
ares_getnameinfo.c Undo last changes 2005-12-11 23:37:58 +00:00
ares_getsock.3 This function was added in c-ares [version] 2005-12-22 15:31:32 +00:00
ares_getsock.c Added ares_getsock() to extract sockets to wait for action on, without being 2005-12-22 15:27:41 +00:00
ares_init.3 NORECURSE clarification, minor formatting update 2004-12-07 10:43:21 +00:00
ares_init.c James Bursa fixes: find the hosts file on RISC OS, and made it build with 2006-01-05 07:57:32 +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 Added some checks for the addrinfo structure. 2005-06-19 16:58:40 +00:00
ares_mkquery.3 minor edits 2004-04-02 09:50:42 +00:00
ares_mkquery.c Tupone Alfredo fixed includes of arpa/nameser_compat.h to build fine on Mac OS 2005-04-06 22:27:42 +00:00
ares_parse_a_reply.3 Dominick Meglio man page fixes 2004-04-01 06:10:56 +00:00
ares_parse_a_reply.c Tupone Alfredo fixed includes of arpa/nameser_compat.h to build fine on Mac OS 2005-04-06 22:27:42 +00:00
ares_parse_aaaa_reply.3 the ares_parse_aaaa_reply man page 2005-03-11 08:34:51 +00:00
ares_parse_aaaa_reply.c Fixed for Mac OS X builds based on excellent feedback from Heinz Stockinger. 2005-04-22 15:01:02 +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 Tupone Alfredo fixed includes of arpa/nameser_compat.h to build fine on Mac OS 2005-04-06 22:27:42 +00:00
ares_private.h James Bursa fixes: find the hosts file on RISC OS, and made it build with 2006-01-05 07:57:32 +00:00
ares_process.3 minor edits 2004-04-02 09:50:42 +00:00
ares_process.c Changes for PellesC for Win32. It needs <unistd.h> for 'ssize_t'. Hence the 2005-12-20 20:48:38 +00:00
ares_query.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_query.c Tupone Alfredo fixed includes of arpa/nameser_compat.h to build fine on Mac OS 2005-04-06 22:27:42 +00:00
ares_search.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_search.c removed tabs and trailing whitespace from source 2004-10-06 07:50:18 +00:00
ares_send.3 Dominick Meglio man page fixes 2004-04-01 06:10:56 +00:00
ares_send.c Tupone Alfredo fixed includes of arpa/nameser_compat.h to build fine on Mac OS 2005-04-06 22:27:42 +00:00
ares_strerror.3 mention incompatibilities with ares 2004-10-26 08:08:41 +00:00
ares_strerror.c Added ares_getnameinfo which mimics the getnameinfo API 2005-05-16 18:06:54 +00:00
ares_timeout.3 minor edits 2004-04-02 09:50:42 +00:00
ares_timeout.c removed tabs and trailing whitespace from source 2004-10-06 07:50:18 +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 we're working on 1.3.1 (or more) 2006-01-02 09:13:56 +00:00
bitncmp.c Removed usage of u_int and u_char 2005-04-09 23:46:31 +00:00
bitncmp.h Added preliminary IPv6 support to ares_gethostbyname 2005-04-08 19:46:46 +00:00
buildconf Use $ACLOCAL_FLAGS too, pointed out by Alexander Lazic 2006-01-06 22:07:51 +00:00
config-win32.h Changes for PellesC for Win32. It needs <unistd.h> for 'ssize_t'. Hence the 2005-12-20 20:48:38 +00:00
configure.ac Checking for function getnameinfo and its arguments is finally 2005-12-21 20:44:54 +00:00
inet_net_pton.c indented source to look more like other ares code, 2005-04-19 23:36:21 +00:00
inet_net_pton.h Attempted to fix c-ares not building on non-IPv6 systems 2005-04-15 15:25:16 +00:00
inet_ntop.c Added CVS id, Detabified, applied c-ares coding-style. 2005-11-12 14:59:33 +00:00
inet_ntop.h Added an inet_ntop function from BIND for systems that do not have it 2005-05-14 18:35:20 +00:00
install-sh added for completeness 2003-10-08 20:18:15 +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 Undo previous change. This header file belongs to the public 2005-12-19 00:15:04 +00:00
setup.h Changes for PellesC for Win32. It needs <unistd.h> for 'ssize_t'. Hence the 2005-12-20 20:48:38 +00:00
windows_port.c Replace IsNT with IS_NT(). 2004-11-10 14:23:20 +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.