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

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.