Added in version 3.27.
Specify a custom signal to send to a test process when its timeout is reached. This is available only on platforms supporting POSIX signals. It is not available on Windows.
The name must be one of the following:
SIGINTInterrupt.
SIGQUITQuit.
SIGTERMTerminate.
SIGUSR1User defined signal 1.
SIGUSR2User defined signal 2.
The custom signal is sent to the test process to give it a chance to exit gracefully during a grace period:
If the test process created any children, it is responsible for terminating them too.
The grace period length is determined by the
TIMEOUT_SIGNAL_GRACE_PERIOD test property.
If the test process does not terminate before the grace period ends,
ctest(1) will force termination of its entire process tree
via SIGSTOP and SIGKILL.
See also CTEST_TEST_TIMEOUT,
TIMEOUT, and TIMEOUT_AFTER_MATCH.