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_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 viaSIGSTOP
andSIGKILL
.
See also CTEST_TEST_TIMEOUT
,
TIMEOUT
, and TIMEOUT_AFTER_MATCH
.