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.
 
 
 
 
 
Alexander Klauer 2e0c3076e5 library init: be recursive 12 years ago
m4 configure: use XC_LIBTOOL for portability across libtool versions 12 years ago
vc vc6cares.dsp: add ares_create_query.c and ares_parse_soa_reply.c 12 years ago
.gitignore .gitignore: ignore patch files 12 years ago
AUTHORS AUTHORS: synced with 83093ac450 12 years ago
CHANGES CHANGES: generate from script 13 years ago
CHANGES.0 CHANGES: generate from script 13 years ago
GIT-INFO GIT-INFO: mention buildconf 13 years ago
INSTALL INSTALL: some adjustments 13 years ago
Makefile.Watcom Makefile.Watcom: 13 years ago
Makefile.am ares.h: stricter CARES_EXTERN linkage decorations logic 12 years ago
Makefile.dj build: config.dos renamed to config-dos.h 14 years ago
Makefile.inc ares_inet_pton/ntop: cleanup 12 years ago
Makefile.m32 Create ares_build.h when buidling from Git. 12 years ago
Makefile.msvc Makefile.msvc: add four VS version strings 12 years ago
Makefile.netware Makefile.netware: SIZEOF_SHORT definition 13 years ago
NEWS - Fixed a few variable return types for some system calls. Made configure 21 years ago
README Fix a couple of typos and grammar nits. 15 years ago
README.cares made README the primary readme file 15 years ago
README.msvc build: add install target to Makefile.msvc 14 years ago
RELEASE-NOTES RELEASE-NOTES: 1.9.1 coming up 13 years ago
TODO ares_reinit() 15 years ago
acinclude.m4 configure: NATIVE_WINDOWS no longer defined in config file 13 years ago
acountry.1 man pages: docs for the c-ares utility programs 14 years ago
acountry.c ares_inet_pton/ntop: cleanup 12 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 man pages: docs for the c-ares utility programs 14 years ago
ahost.c ares_inet_pton/ntop: cleanup 12 years ago
ares.h ares.h: stricter CARES_EXTERN linkage decorations logic 12 years ago
ares__close_sockets.c setup_once.h: refactor inclusion of <unistd.h> and <sys/socket.h> 12 years ago
ares__get_hostent.c ares_inet_pton/ntop: cleanup 12 years ago
ares__read_line.c Header inclusion clean-up 12 years ago
ares__timeval.c remove all $Id$ lines 15 years ago
ares_build.h.dist ares_build.h.dist: enhance non-configure GCC ABI detection logic 12 years ago
ares_build.h.in Revert "Do not use sized constants in public headers" 14 years ago
ares_cancel.3 Documentation: properly document ARES_ECANCELLED 12 years ago
ares_cancel.c ares_cancel(): cancel requests safely 12 years ago
ares_create_query.3 ares_create_query.3: mention when this is added 12 years ago
ares_create_query.c setup_once.h: refactor inclusion of <unistd.h> and <sys/socket.h> 12 years ago
ares_data.c ares_get_datatype: removed unused function 12 years ago
ares_data.h ares_get_datatype: removed unused function 12 years ago
ares_destroy.3 ares_destroy() documentation: no new requests 12 years ago
ares_destroy.c Header inclusion clean-up 12 years ago
ares_destroy_options.3 remove all $Id$ lines 15 years ago
ares_dns.h Added new feature (rfc2671) 12 years ago
ares_dup.3 remove all $Id$ lines 15 years ago
ares_expand_name.3 ares_expand_name.3: clarify how to free the data 12 years ago
ares_expand_name.c protocol parsing: check input data stricter 12 years ago
ares_expand_string.3 remove all $Id$ lines 15 years ago
ares_expand_string.c setup_once.h: refactor inclusion of <unistd.h> and <sys/socket.h> 12 years ago
ares_fds.3 remove all $Id$ lines 15 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 Header inclusion clean-up 12 years ago
ares_free_string.3 remove all $Id$ lines 15 years ago
ares_free_string.c Header inclusion clean-up 12 years ago
ares_get_servers.3 remove all $Id$ lines 15 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 ares_inet_pton/ntop: cleanup 12 years ago
ares_gethostbyname.3 Documentation: properly document ARES_ECANCELLED 12 years ago
ares_gethostbyname.c ares_inet_pton/ntop: cleanup 12 years ago
ares_gethostbyname_file.3 remove all $Id$ lines 15 years ago
ares_getnameinfo.3 Documentation: properly document ARES_ECANCELLED 12 years ago
ares_getnameinfo.c ares_inet_pton/ntop: cleanup 12 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 Header inclusion clean-up 12 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: Last, not first instance of domain or search should win 15 years ago
ares_init.c ares_inet_pton/ntop: cleanup 12 years ago
ares_init_options.3 remove all $Id$ lines 15 years ago
ares_iphlpapi.h ares_iphlpapi.h: Watcom C fix 13 years ago
ares_ipv6.h ipv6: Fix some build issues related to the local-bind feature. 15 years ago
ares_library_cleanup.3 remove all $Id$ lines 15 years ago
ares_library_init.3 remove all $Id$ lines 15 years ago
ares_library_init.c library init: be recursive 12 years ago
ares_library_init.h winsock: compilation fixes 14 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 setup_once.h: refactor inclusion of <unistd.h> and <sys/socket.h> 12 years ago
ares_nowarn.h Kill compiler warning 13 years ago
ares_options.c ares_inet_pton/ntop: cleanup 12 years ago
ares_parse_a_reply.3 remove all $Id$ lines 15 years ago
ares_parse_a_reply.c protocol parsing: check input data stricter 12 years ago
ares_parse_aaaa_reply.3 remove all $Id$ lines 15 years ago
ares_parse_aaaa_reply.c protocol parsing: check input data stricter 12 years ago
ares_parse_mx_reply.3 added ares_parse_mx_reply 15 years ago
ares_parse_mx_reply.c protocol parsing: check input data stricter 12 years ago
ares_parse_naptr_reply.3 Added support for parsing NAPTR records 13 years ago
ares_parse_naptr_reply.c protocol parsing: check input data stricter 12 years ago
ares_parse_ns_reply.3 Vlad Dinulescu added ares_parse_ns_reply() 18 years ago
ares_parse_ns_reply.c protocol parsing: check input data stricter 12 years ago
ares_parse_ptr_reply.3 remove all $Id$ lines 15 years ago
ares_parse_ptr_reply.c protocol parsing: check input data stricter 12 years ago
ares_parse_soa_reply.3 SOA parser added 13 years ago
ares_parse_soa_reply.c setup_once.h: refactor inclusion of <unistd.h> and <sys/socket.h> 12 years ago
ares_parse_srv_reply.3 Daniel wants upcoming release to be 1.7.0 15 years ago
ares_parse_srv_reply.c protocol parsing: check input data stricter 12 years ago
ares_parse_txt_reply.3 Daniel wants upcoming release to be 1.7.0 15 years ago
ares_parse_txt_reply.c protocol parsing: check input data stricter 12 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 ares__generate_new_id: moved to ares_query.c 12 years ago
ares_process.3 remove all $Id$ lines 15 years ago
ares_process.c ares__swap_lists: make private and static 12 years ago
ares_query.3 Documentation: properly document ARES_ECANCELLED 12 years ago
ares_query.c ares__generate_new_id: moved to ares_query.c 12 years ago
ares_rules.h Revert "Do not use sized constants in public headers" 14 years ago
ares_save_options.3 remove all $Id$ lines 15 years ago
ares_search.3 Documentation: properly document ARES_ECANCELLED 12 years ago
ares_search.c Header inclusion clean-up 12 years ago
ares_send.3 Documentation: properly document ARES_ECANCELLED 12 years ago
ares_send.c setup_once.h: refactor inclusion of <unistd.h> and <sys/socket.h> 12 years ago
ares_set_local_dev.3 ares_set_local_*: added in 1.7.4, not before 14 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 local-bind: Support binding to local interface/IPs 15 years ago
ares_set_servers_csv.3 local-bind: Support binding to local interface/IPs 15 years ago
ares_set_socket_callback.3 remove all $Id$ lines 15 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 remove all $Id$ lines 15 years ago
ares_strdup.h remove all $Id$ lines 15 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 ares_timeout.3: fix the NAME section 13 years ago
ares_timeout.c Header inclusion clean-up 12 years ago
ares_version.3 remove all $Id$ lines 15 years ago
ares_version.c remove all $Id$ lines 15 years ago
ares_version.h version: bumped to 1.10.0 12 years ago
ares_writev.c remove all $Id$ lines 15 years ago
ares_writev.h remove all $Id$ lines 15 years ago
bitncmp.c ares__bitncmp: use two underscores for private functions 12 years ago
bitncmp.h ares__bitncmp: use two underscores for private functions 12 years ago
buildconf configure: libtool 1.5 tweaks 13 years ago
buildconf.bat remove all $Id$ lines 15 years ago
cares.rc Added copyright string to ares_version.h and make use of it in other files. 15 years ago
config-dos.h config-dos.h: define HAVE_CLOSE_S for MSDOS/Watt-32 12 years ago
config-win32.h setup_once.h cleanup and sync 13 years ago
configure.ac ares.h: stricter CARES_EXTERN linkage decorations logic 12 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 ares_inet_pton/ntop: cleanup 12 years ago
inet_ntop.c inet_ntop.c: s/socklen_t/ares_socklen_t 12 years ago
install-sh added for completeness 21 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 repair the file mode 15 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

c-ares
======

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/bagder/c-ares

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:

http://c-ares.haxx.se/


NOTES FOR C-ARES HACKERS

The following notes apply to c-ares version 1.7.0 and later.

* 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 of compiling 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 */