TIMEOUT_SIGNAL_NAME — CMake 4.3.0 Documentation

# 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`.