Chiebot-Mirror
/
c-ares
mirror of https://github.com/c-ares/c-ares.git
8
0
Fork 0
Code Issues Projects Releases Wiki Activity
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.
1675 Commits
14 Branches
96 Tags
22 MiB
 
 
 
 
 
Tag: Branch: Tree: f0d04b2909
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'f0d04b2909'
${ noResults }
c-ares/test
Daniel Stenberg f0d04b2909
test/configure: build silently by default 		9 years ago
..
fuzzinput test: Add initial unit tests for c-ares library 9 years ago
gmock-1.7.0 test: Add local copy of GoogleMock/GoogleTest 1.7.0 9 years ago
.gitignore test: Get test code building under Windows 9 years ago
Makefile.am test: Move file lists into Makefile.inc 9 years ago
Makefile.inc test: Add framework for containerized testing 9 years ago
Makefile.msvc test: Get test code building under Windows 9 years ago
README.md test: Add README.md documentation 9 years ago
ares-fuzz.cc test: Add initial unit tests for c-ares library 9 years ago
ares-test-fuzz.cc test: Add initial unit tests for c-ares library 9 years ago
ares-test-init.cc Use "resolve" as synonym of "dns" in nsswitch.conf 9 years ago
ares-test-internal.cc test: Get test code building under Windows 9 years ago
ares-test-live.cc test: Make failure tests more robust 9 years ago
ares-test-main.cc test: Ignore SIGPIPE in tests 9 years ago
ares-test-misc.cc test: Get test code building under Windows 9 years ago
ares-test-mock.cc Add ares_set_socket_configure_callback() 9 years ago
ares-test-ns.cc test: Improve containerized test mechanism 9 years ago
ares-test-parse-a.cc test: more testing, including of internal static functions 9 years ago
ares-test-parse-aaaa.cc test: Add more tests for edge cases 9 years ago
ares-test-parse-mx.cc test: Add more tests for edge cases 9 years ago
ares-test-parse-naptr.cc test: More parsing tests 9 years ago
ares-test-parse-ns.cc test: More parsing tests 9 years ago
ares-test-parse-ptr.cc test: Make failure tests more robust 9 years ago
ares-test-parse-soa.cc test: More parsing tests 9 years ago
ares-test-parse-srv.cc test: Add more tests for edge cases 9 years ago
ares-test-parse-txt.cc test: Check ares_parse_txt_reply_ext() entrypoint 9 years ago
ares-test-parse.cc test: More parsing tests 9 years ago
ares-test.cc test: Make contained tests easier to write 9 years ago
ares-test.h test: Improve containerized test mechanism 9 years ago
buildconf test: Add initial unit tests for c-ares library 9 years ago
configure.ac test/configure: build silently by default 9 years ago
dns-proto-test.cc test: Add initial unit tests for c-ares library 9 years ago
dns-proto.cc test: more tests, especially fallback processing 9 years ago
dns-proto.h test: Add more tests for edge cases 9 years ago

README.md

c-ares Unit Test Suite

This directory holds unit tests for the c-ares library. To build the tests:

  • Build the main c-ares library first, in the directory above this. To enable tests of internal functions, configure the library build to expose hidden symbols with ./configure --disable-symbol-hiding.
  • Generate a configure file by running autoreconf -iv (which requires a local installation of autotools).
  • ./configure
  • make
  • Run the tests with ./arestest, or ./arestest -v for extra debug info.

Points to note:

  • The tests are written in C++11, and so need a C++ compiler that supports this. To avoid adding this as a requirement for the library, the configuration and build of the tests is independent from the library.
  • The tests include some live queries, which will fail when run on a machine without internet connectivity. To skip live tests, run with ./arestest --gtest_filter=-*.Live*.
  • The tests include queries of a mock DNS server. This server listens on port 5300 by default, but the port can be changed with the -p 5300 option to arestest.

Test Types

The test suite includes various different types of test.

  • There are live tests (ares-test-live.cc), which assume that the current machine has a valid DNS setup and connection to the internet; these tests issue queries for real domains but don't particularly check what gets returned. The tests will fail on an offline machine.
  • There are some mock tests (ares-test-mock.cc) that set up a fake DNS server and inject its port into the c-ares library configuration. These tests allow specific response messages to be crafted and injected, and so are likely to be used for many more tests in future.
    • To make this generation/injection easier, the dns-proto.h file includes C++ helper classes for building DNS packets.
  • Other library entrypoints that don't require network activity (e.g. ares_parse_*_reply) are tested directly.
  • A couple of the tests use a helper method of the test fixture to inject memory allocation failures, using a recent change to the c-ares library that allows override of malloc/free.
  • There are some tests of the internal entrypoints of the library (ares-test-internal.c), but these are only enabled if the library was configured with --disable-symbol-hiding and/or --enable-expose-statics.
  • There is also an entrypoint to allow Clang's libfuzzer to drive the packet parsing code in ares_parse_*_reply, together with a standalone wrapper for it (./aresfuzz) to allow use of command line fuzzers (such as afl-fuzz) for further fuzz testing.

Code Coverage Information

To generate code coverage information:

  • Configure both the library and the tests with ./configure --enable-code-coverage before building. This requires the relevant code coverage tools (gcov, lcov) to be installed locally.
  • Run the tests with test/arestest.
  • Generate code coverage output with make code-coverage-capture in the library directory (i.e. not in test/).