curl/ares
Yang Tse 94b253fde7 Steve Little's fixes to allow compilation on VMS 64-bit mode 2007-04-25 03:00:10 +00:00
..
vc ares_getopt() command-line parser function does not belong to actual 2007-04-16 09:01:16 +00:00
.cvsignore ignore this 2004-10-24 13:02:46 +00:00
AUTHORS add the recent crowd of contributors 2006-11-05 23:11:07 +00:00
CHANGES ares_getopt() command-line parser function does not belong to actual 2007-04-16 09:08:15 +00:00
FILES Added Makefile.vc6. 2005-11-09 22:17:13 +00:00
Makefile.am Install ares_dns.h too 2006-11-22 22:51:01 +00:00
Makefile.dj No need for USE_MANUAL. Use select_s() instead of select(). 2007-04-16 16:52:56 +00:00
Makefile.inc ares_getopt() command-line parser function does not belong to actual 2007-04-16 09:01:16 +00:00
Makefile.m32 use Makefile.inc to determine sources. 2007-04-16 13:53:58 +00:00
Makefile.netware fixed ARFLAGS for CodeWarrior build. 2007-04-21 15:32:35 +00:00
Makefile.vc6 ares_getopt() command-line parser function does not belong to actual 2007-04-16 09:01:16 +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 Cleanup. Warnings related with FD_SET, FD_ISSET, and FD_ZERO macros 2007-04-03 02:45:04 +00:00
adig.c move linkage var declarations to ares_getopt.h 2007-04-16 15:35:34 +00:00
ahost.c move linkage var declarations to ares_getopt.h 2007-04-16 15:35:34 +00:00
ares.h ares_getopt() command-line parser function does not belong to actual 2007-04-16 09:01:16 +00:00
ares__close_sockets.c 2nd try adding CVS id. 2006-07-22 15:37:10 +00:00
ares__get_hostent.c Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +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 avoid a couple of potential zero size memory allocations 2006-11-06 13:56:51 +00:00
ares_destroy.3 NORECURSE clarification, minor formatting update 2004-12-07 10:43:21 +00:00
ares_destroy.c avoid a couple of potential zero size memory allocations 2006-11-06 13:56:51 +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 Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +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 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 Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +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 fix compiler warning "discards qualifiers from pointer target type" in debug builds 2007-01-29 20:56:27 +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 edits, mainly to make the generated html output nicer 2004-04-02 09:56:01 +00:00
ares_gethostbyaddr.c Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +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 Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +00:00
ares_getnameinfo.3 Added ares_getnameinfo which mimics the getnameinfo API 2005-05-16 18:06:54 +00:00
ares_getnameinfo.c Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +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 update copyright year 2007-04-03 18:25:18 +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 inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +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 Change the ai_addrlen type of struct addrinfo from size_t to socklen_t, per RFC 3493. 2006-07-14 10:30:44 +00:00
ares_mkquery.3 minor edits 2004-04-02 09:50:42 +00:00
ares_mkquery.c Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +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 Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +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 Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +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 Moved select_s() to Makefile.dj since select() is used in applications. 2006-11-07 13:29:15 +00:00
ares_process.3 minor edits 2004-04-02 09:50:42 +00:00
ares_process.c Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +00:00
ares_query.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_query.c Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +00:00
ares_search.3 ares 1.1.1 with collected applied patches 2003-10-07 21:54:04 +00:00
ares_search.c add debug messages for initialization failures 2007-02-19 02:03:58 +00:00
ares_send.3 Dominick Meglio man page fixes 2004-04-01 06:10:56 +00:00
ares_send.c Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +00:00
ares_strerror.3 mention incompatibilities with ares 2004-10-26 08:08:41 +00:00
ares_strerror.c curlassert macro replaced with DEBUGASSERT macro defined in setup_once.h 2007-02-21 19:03:20 +00:00
ares_timeout.3 minor edits 2004-04-02 09:50:42 +00:00
ares_timeout.c Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +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 did 1.3.2 and are now on the 1.3.3 track! 2006-11-11 22:23:48 +00:00
bitncmp.c Removed inclusion of <sys/types.h> in .c-files 2007-02-26 04:33:19 +00:00
bitncmp.h Change multiple header inclusion prevention definition to __ARES_BITNCMP_H 2006-07-26 10:47:11 +00:00
buildconf Use $ACLOCAL_FLAGS too, pointed out by Alexander Lazic 2006-01-06 22:07:51 +00:00
config-win32.h Added HAVE_PROCESS_H for DOS/Win32. 2007-02-06 19:09:57 +00:00
configure.ac show better description for AMD64-linux static libraries PIC check 2007-03-15 15:35:51 +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 Change multiple header inclusion prevention definition to __ARES_INET_NET_PTON_H 2006-07-26 10:43:15 +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 Sync header with source code 2006-07-26 10:33:17 +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 Move portable error number symbolic name definitions to setup_once.h 2007-02-17 13:51:24 +00:00
setup.h Support for OpenWatcom (Win32): It do have getpid(), but no 2007-01-30 13:15:07 +00:00
setup_once.h Steve Little's fixes to allow compilation on VMS 64-bit mode 2007-04-25 03:00:10 +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.