TIMEOUT_SIGNAL_NAMEΒΆ
New 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:
SIGINT
Interrupt.
SIGQUIT
Quit.
SIGTERM
Terminate.
SIGUSR1
User defined signal 1.
SIGUSR2
User 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 via- SIGSTOPand- SIGKILL.
See also CTEST_TEST_TIMEOUT,
TIMEOUT, and TIMEOUT_AFTER_MATCH.
