diff options
author | Rich Felker <dalias@aerifal.cx> | 2011-03-19 22:26:06 -0400 |
---|---|---|
committer | Rich Felker <dalias@aerifal.cx> | 2011-03-19 22:26:06 -0400 |
commit | a9baddd7d07b9fe15e212985a808a79773ec72e4 (patch) | |
tree | fce0a089eedeacef8b25b409c2ba50f5f30a8327 /README | |
download | libc-testsuite-a9baddd7d07b9fe15e212985a808a79773ec72e4.tar.gz |
initial check-in, taken from old libc svn repo with significant additions
Diffstat (limited to 'README')
-rw-r--r-- | README | 32 |
1 files changed, 32 insertions, 0 deletions
@@ -0,0 +1,32 @@ + +libc-testsuite README + + +This package is a collection of unit tests to measure the correctness +and robustness of a C/POSIX standard library implementation. It was +developed as a tool for testing musl and its first-generation +predecessor. As such, most of the tests were written to be +self-contained and not to make assumptions about other library +interfaces being present or working correctly. + +At present the whole testsuite builds as a single binary and runs as a +single process (aside from a few child processes that are part of the +tests). This makes it extremely fast, but also means that corruption +of the global state due to bugs in one set of interfaces may affect +later tests. If necessary, the main test dispatch module could be +modified to fork before running each test, ensuring that each one +begins with a clean working state. + + +Building and running the tests + +If needed, a file named config.mak can be created to override the +default CC, CFLAGS, etc. used by the build process. Otherwise, simply +run "make" in the libc-testsuite directory to build the tests. Then +run "./testsuite" or "make test" to run the tests. + +The following additional CFLAGS options may be of interest: + +-DHAVE_BSD_STRL - tests the BSD strlcpy and strlcat functions. +-DDISABLE_SLOW_TESTS - disables testing 2GB snprintf. + |