C++ C M4 Python Roff CMake Other
Latest commit 4a89071 Feb 1, 2017 Calle Wilund committed with daviddrysdale ares test: fix win32 build errors with virtual socket function tests
The added api requires both some typedefs not previously imported
into the test build + the test code did not fully deal with
socket differences on windows.
Permalink
Failed to load latest commit information.
m4 test: namespaces unavailable when cross-compiling Feb 13, 2016
test ares test: fix win32 build errors with virtual socket function tests Feb 6, 2017
travis travis: Move build scripts under travis/ Oct 26, 2016
vc vc6cares.dsp: add ares_create_query.c and ares_parse_soa_reply.c Dec 18, 2012
.gitignore build: Add a code coverage option Feb 2, 2016
.travis.yml Updated Travis to pull CMake 2.8.12 from kubuntu-backports ppa. Jan 3, 2017
AUTHORS AUTHOR: maybe gitgub isn't really an author =) Aug 21, 2016
CHANGES CHANGES: generate from script Aug 21, 2011
CHANGES.0 CHANGES: generate from script Aug 21, 2011
CMakeLists.txt Always use check_symbol_exists instead of check_function_exists. Jan 14, 2017
CONTRIBUTING.md doc: Update docs on contributing Feb 2, 2016
GIT-INFO docs: convert INSTALL to MarkDown & tweak (#83) Jan 11, 2017
INSTALL.md docs: convert INSTALL to MarkDown & tweak (#83) Jan 11, 2017
LICENSE.md LICENSE.md: add a stand-alone license file Aug 21, 2016
Makefile.Watcom Makefile.Watcom: Aug 10, 2011
Makefile.am Update Makefile.am for renamed INSTALL.md Jan 11, 2017
Makefile.dj email: use Gisle's "new" address Apr 30, 2016
Makefile.inc dist: add ares_library_initialized.* to the tarball Sep 30, 2016
Makefile.m32 Makefile.m32: add support for CROSSPREFIX Mar 3, 2016
Makefile.msvc build: commonize MSVC version detection Mar 11, 2016
Makefile.netware headers: remove checks for and defines of variable sizes Sep 26, 2016
NEWS - Fixed a few variable return types for some system calls. Made confi… Jul 22, 2004
README.cares web: http => https Aug 15, 2016
README.md docs: convert INSTALL to MarkDown & tweak (#83) Jan 11, 2017
README.msvc build: add install target to Makefile.msvc Jan 17, 2011
RELEASE-NOTES RELEASE-NOTES: 1.12.0 Sep 29, 2016
SECURITY.md SECURITY: point to the vulnerabilities page now Sep 27, 2016
TODO ares_reinit() Feb 17, 2010
acinclude.m4 nowarn: use <limits.h> instead of configure for size of long Aug 27, 2013
acountry.1 man pages: docs for the c-ares utility programs May 9, 2011
acountry.c email: use Gisle's "new" address Apr 30, 2016
adig.1 man pages: docs for the c-ares utility programs May 9, 2011
adig.c ares_inet_pton/ntop: cleanup Feb 17, 2013
ahost.1 Add -t u option to ahost Jul 24, 2014
ahost.c ahost.c: add cast to fix C++ compile Mar 9, 2016
appveyor.yml test: disable MinGW tests Aug 16, 2016
ares.h Add virtual function set for socket IO Jan 31, 2017
ares__close_sockets.c Implement using virtual socket IO functions when set Jan 31, 2017
ares__get_hostent.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares__read_line.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares__timeval.c Mark unhittable lines Feb 2, 2016
ares_build.h.cmake Adds cmake build system support to C-Ares. Sep 27, 2016
ares_build.h.dist headers: remove checks for and defines of variable sizes Sep 26, 2016
ares_build.h.in headers: remove checks for and defines of variable sizes Sep 26, 2016
ares_cancel.3 man pages: minor formatting edits Sep 30, 2016
ares_cancel.c ares_cancel(): cancel requests safely Apr 8, 2013
ares_config.h.cmake Adds cmake build system support to C-Ares. Sep 27, 2016
ares_create_query.3 ares_create_query.3: edit language Sep 27, 2016
ares_create_query.c ares_create_query: avoid single-byte buffer overwrite Sep 29, 2016
ares_data.c txt: introduce `ares_parse_txt_reply_ext` Feb 4, 2016
ares_data.h txt: introduce `ares_parse_txt_reply_ext` Feb 4, 2016
ares_destroy.3 man pages: minor formatting edits Sep 30, 2016
ares_destroy.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_destroy_options.3 docs: minor formatting edits Sep 27, 2016
ares_dns.h Added new feature (rfc2671) Aug 16, 2012
ares_dup.3 docs: minor formatting edits Sep 27, 2016
ares_expand_name.3 ares_expand_name.3: clarify how to free the data Feb 13, 2013
ares_expand_name.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_expand_string.3 remove all $Id$ lines Mar 27, 2010
ares_expand_string.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_fds.3 man pages: minor formatting edits Sep 30, 2016
ares_fds.c Header inclusion clean-up Dec 14, 2012
ares_free_data.3 SOA parser added Jun 15, 2012
ares_free_hostent.3 remove all $Id$ lines Mar 27, 2010
ares_free_hostent.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_free_string.3 docs: minor formatting edits Sep 27, 2016
ares_free_string.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_get_servers.3 Fix man page typos detected by Lintian Feb 21, 2016
ares_get_servers_ports.3 api: Add entrypoints to allow use of per-server ports Feb 2, 2016
ares_getenv.c build: use getenv() replacement function for systems which lack it Mar 23, 2011
ares_getenv.h build: use getenv() replacement function for systems which lack it Mar 23, 2011
ares_gethostbyaddr.3 Documentation: properly document ARES_ECANCELLED Apr 8, 2013
ares_gethostbyaddr.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_gethostbyname.3 Documentation: properly document ARES_ECANCELLED Apr 8, 2013
ares_gethostbyname.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_gethostbyname_file.3 remove all $Id$ lines Mar 27, 2010
ares_getnameinfo.3 ares_getnameinfo.3: there is no ares_getaddrinfo Oct 30, 2014
ares_getnameinfo.c Explicitly clear struct servent before use Mar 16, 2016
ares_getopt.c remove all $Id$ lines Mar 27, 2010
ares_getopt.h Fix macro redefinition. Nov 22, 2009
ares_getsock.3 remove all $Id$ lines Mar 27, 2010
ares_getsock.c Fix integer shift overflow if both tcp_socket and udp_socket are set Sep 30, 2014
ares_inet_net_pton.h ares_inet_pton/ntop: cleanup Feb 17, 2013
ares_inet_ntop.3 ares_inet_ntop.3: s/socklen_t/ares_socklen_t Mar 8, 2013
ares_inet_pton.3 spell inet correctly! Feb 17, 2013
ares_init.3 ares_init.3: split the init docs into two separate man pages Sep 27, 2016
ares_init.c Add virtual function set for socket IO Jan 31, 2017
ares_init_options.3 man pages: minor formatting edits Sep 30, 2016
ares_iphlpapi.h ares_iphlpapi.h: Watcom C fix Aug 10, 2011
ares_ipv6.h headers: remove checks for and defines of variable sizes Sep 26, 2016
ares_library_cleanup.3 man pages: minor formatting edits Sep 30, 2016
ares_library_init.3 ares_library_init.3: corrected the ares_library_init_mem proto Sep 29, 2016
ares_library_init.c ares_library_cleanup: reset ares_realloc too Mar 9, 2016
ares_library_init.h winsock: compilation fixes May 20, 2011
ares_library_initialized.3 ares_library_initialized.3: added Sep 29, 2016
ares_llist.c ares__swap_lists: make private and static Feb 13, 2013
ares_llist.h ares__swap_lists: make private and static Feb 13, 2013
ares_mkquery.3 Added new feature (rfc2671) Aug 16, 2012
ares_mkquery.c Added new feature (rfc2671) Aug 16, 2012
ares_nowarn.c headers: remove checks for and defines of variable sizes Sep 26, 2016
ares_nowarn.h Kill compiler warning Jun 14, 2012
ares_options.c api: Add entrypoints to allow use of per-server ports Feb 2, 2016
ares_parse_a_reply.3 nroff: fix two syntax mistakes May 2, 2013
ares_parse_a_reply.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_parse_aaaa_reply.3 nroff: fix two syntax mistakes May 2, 2013
ares_parse_aaaa_reply.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_parse_mx_reply.3 added ares_parse_mx_reply Apr 17, 2010
ares_parse_mx_reply.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_parse_naptr_reply.3 Added support for parsing NAPTR records Feb 23, 2012
ares_parse_naptr_reply.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_parse_ns_reply.3 Vlad Dinulescu added ares_parse_ns_reply() Feb 19, 2007
ares_parse_ns_reply.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_parse_ptr_reply.3 remove all $Id$ lines Mar 27, 2010
ares_parse_ptr_reply.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_parse_soa_reply.3 SOA parser added Jun 15, 2012
ares_parse_soa_reply.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_parse_srv_reply.3 Daniel wants upcoming release to be 1.7.0 Nov 23, 2009
ares_parse_srv_reply.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_parse_txt_reply.3 txt: introduce `ares_parse_txt_reply_ext` Feb 4, 2016
ares_parse_txt_reply.c txt: introduce `ares_parse_txt_reply_ext` Feb 4, 2016
ares_platform.c compiler warning: fix May 26, 2011
ares_platform.h getservbyport replacement for Win CE Mar 27, 2011
ares_private.h Implement using virtual socket IO functions when set Jan 31, 2017
ares_process.3 man pages: minor formatting edits Sep 30, 2016
ares_process.c ares_process: fix return type of socket_create function (win32 warning) Feb 6, 2017
ares_query.3 Documentation: properly document ARES_ECANCELLED Apr 8, 2013
ares_query.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_rules.h headers: remove checks for and defines of variable sizes Sep 26, 2016
ares_save_options.3 Fix man page typos detected by Lintian Feb 21, 2016
ares_search.3 Documentation: properly document ARES_ECANCELLED Apr 8, 2013
ares_search.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_send.3 Documentation: properly document ARES_ECANCELLED Apr 8, 2013
ares_send.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_set_local_dev.3 Fix typos detected by lintian Jan 23, 2016
ares_set_local_ip4.3 ares_set_local_*: added in 1.7.4, not before Dec 8, 2010
ares_set_local_ip6.3 ares_set_local_*: added in 1.7.4, not before Dec 8, 2010
ares_set_servers.3 Fix man page typos detected by Lintian Feb 21, 2016
ares_set_servers_csv.3 Fix man page typos detected by Lintian Feb 21, 2016
ares_set_servers_ports.3 api: Add entrypoints to allow use of per-server ports Feb 2, 2016
ares_set_servers_ports_csv.3 api: Add entrypoints to allow use of per-server ports Feb 2, 2016
ares_set_socket_callback.3 ares_set_socket_callback: make manpage match code Feb 11, 2016
ares_set_socket_configure_callback.3 Add ares_set_socket_configure_callback() Feb 9, 2016
ares_set_socket_functions.3 ares_set_socket_functions: Add man page Jan 31, 2017
ares_set_sortlist.3 Fix man page typos detected by Lintian Feb 21, 2016
ares_setup.h Check for __ANDROID__ in addition to ANDROID macro. Apr 16, 2012
ares_strcasecmp.c remove all $Id$ lines Mar 27, 2010
ares_strcasecmp.h remove all $Id$ lines Mar 27, 2010
ares_strdup.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_strdup.h api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_strerror.3 remove all $Id$ lines Mar 27, 2010
ares_strerror.c remove all $Id$ lines Mar 27, 2010
ares_timeout.3 man pages: minor formatting edits Sep 30, 2016
ares_timeout.c timeoffset: made static and private Aug 27, 2013
ares_version.3 man pages: minor formatting edits Sep 30, 2016
ares_version.c remove all $Id$ lines Mar 27, 2010
ares_version.h ares_version.h: bump, working on 1.12.1 now Oct 19, 2016
ares_writev.c api: Allow injection of user-specified malloc/free functions Feb 2, 2016
ares_writev.h remove all $Id$ lines Mar 27, 2010
bitncmp.c bitncmp: update comment to match code behaviour Jan 24, 2016
bitncmp.h ares__bitncmp: use two underscores for private functions Feb 13, 2013
buildconf buildconf: run test/buildconf too if present Feb 13, 2016
buildconf.bat remove all $Id$ lines Mar 27, 2010
c-ares-config.cmake.in CMake: Export targets Jan 14, 2017
cares.rc web: http => https Aug 15, 2016
config-dos.h headers: remove checks for and defines of variable sizes Sep 26, 2016
config-win32.h headers: remove checks for and defines of variable sizes Sep 26, 2016
configure.ac configure: clock_gettime workaround (#75) Dec 26, 2016
get_ver.awk Cleaned up version awk script. Jul 11, 2012
git2changes.pl CHANGES: generate from script Aug 21, 2011
inet_net_pton.c Mark unhittable lines Feb 2, 2016
inet_ntop.c inet_ntop.c: s/socklen_t/ares_socklen_t Feb 19, 2013
install-sh refresh: updated now with automake 1.14 Nov 15, 2013
libcares.pc.in Fix libcares.pc generation for static MingW* cross builds May 25, 2012
maketgz CHANGES: generate from script Aug 21, 2011
mkinstalldirs refresh: updated now with automake 1.14 Nov 15, 2013
msvc_ver.inc Update msvc_ver.inc Jul 19, 2016
nameser.h c-ares/nameser.h: add some T_* defines for ns_t_* values Nov 23, 2012
setup_once.h curl_setup_once.h: definition of HAVE_CLOSE_S defines sclose() to clo… Feb 15, 2013
windows_port.c build: move platform stuff to ares_platform.c and ares_platform.h Mar 24, 2011

README.md

c-ares

Build Status Windows Build Status Coverage Status CII Best Practices

This is c-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.

The full source code is available in the 'c-ares' release archives, and in a git repository: http://github.com/c-ares/c-ares. See the INSTALL.md file for build information.

If you find bugs, correct flaws, have questions or have comments in general in regard to c-ares (or by all means the original ares too), get in touch with us on the c-ares mailing list: http://cool.haxx.se/mailman/listinfo/c-ares

c-ares is of course distributed under the same MIT-style license as the original ares.

You'll find all c-ares details and news here: https://c-ares.haxx.se/

Notes for c-ares hackers

  • The distributed ares_build.h file is only intended to be used on systems which can not run the also distributed configure script.

  • The distributed ares_build.h file is generated as a copy of ares_build.h.dist when the c-ares source code distribution archive file is originally created.

  • If you check out from git on a non-configure platform, you must run the appropriate buildconf* script to set up ares_build.h and other local files before being able to compile the library.

  • On systems capable of running the configure script, the configure process will overwrite the distributed ares_build.h file with one that is suitable and specific to the library being configured and built, this new file is generated from the ares_build.h.in template file.

  • If you intend to distribute an already compiled c-ares library you MUST also distribute along with it the generated ares_build.h which has been used to compile it. Otherwise the library will be of no use for the users of the library that you have built. It is your responsibility to provide this file. No one at the c-ares project can know how you have built the library.

  • File ares_build.h includes platform and configuration dependent info, and must not be modified by anyone. Configure script generates it for you.

  • We cannot assume anything else but very basic compiler features being present. While c-ares requires an ANSI C compiler to build, some of the earlier ANSI compilers clearly can't deal with some preprocessor operators.

  • Newlines must remain unix-style for older compilers' sake.

  • Comments must be written in the old-style /* unnested C-fashion */

  • Try to keep line lengths below 80 columns.