TIMEOUT_SIGNAL_NAMEΒΆ
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_PERIODtest property.If the test process does not terminate before the grace period ends,
ctest(1)will force termination of its entire process tree viaSIGSTOPandSIGKILL.
See also CTEST_TEST_TIMEOUT,
TIMEOUT, and TIMEOUT_AFTER_MATCH.