2016-12-09 07:18:27 +00:00
|
|
|
This subdirectory contains infrastructure which is not put into
|
|
|
|
installed libraries, but may be linked into programs (installed or
|
|
|
|
not) and tests.
|
|
|
|
|
|
|
|
# Error-checking wrappers
|
|
|
|
|
|
|
|
These wrappers test for error return codes an terminate the process on
|
|
|
|
error. They are declared in these header files:
|
|
|
|
|
|
|
|
* support.h
|
|
|
|
* xsignal.h
|
|
|
|
* xthread.h
|
2019-05-08 14:58:17 +00:00
|
|
|
* xtime.h
|
2016-12-09 07:18:27 +00:00
|
|
|
|
|
|
|
In general, new wrappers should be added to support.h if possible.
|
|
|
|
However, support.h must remain fully compatible with C90 and therefore
|
2023-05-20 13:37:47 +00:00
|
|
|
cannot include headers which use identifiers not reserved in C90. If
|
2016-12-09 07:18:27 +00:00
|
|
|
the wrappers need additional types, additional headers such as
|
|
|
|
signal.h need to be introduced.
|
|
|
|
|
|
|
|
# Test framework
|
|
|
|
|
|
|
|
The test framework provides a main program for tests, including a
|
|
|
|
timeout for hanging tests. See README-testing.c for a minimal
|
|
|
|
example, and test-driver.c for details how to use it. The following
|
|
|
|
header files provide related declarations:
|
|
|
|
|
|
|
|
* check.h
|
|
|
|
* temp_file.h
|
|
|
|
* test-driver.h
|
2019-05-09 17:19:21 +00:00
|
|
|
|
|
|
|
For tests that make use of struct timespec, the following header files
|
|
|
|
contain additional macros and helper functions:
|
|
|
|
|
|
|
|
* timespec.h
|