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:

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 via SIGSTOP and SIGKILL.

See also CTEST_TEST_TIMEOUT, TIMEOUT, and TIMEOUT_AFTER_MATCH.