You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
42 lines
1.0 KiB
42 lines
1.0 KiB
TIMEOUT_SIGNAL_NAME
|
|
-------------------
|
|
|
|
.. versionadded:: 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
|
|
:prop_test:`TIMEOUT_SIGNAL_GRACE_PERIOD` test property.
|
|
|
|
* If the test process does not terminate before the grace period ends,
|
|
:manual:`ctest(1)` will force termination of its entire process tree
|
|
via ``SIGSTOP`` and ``SIGKILL``.
|
|
|
|
See also :variable:`CTEST_TEST_TIMEOUT`,
|
|
:prop_test:`TIMEOUT`, and :prop_test:`TIMEOUT_AFTER_MATCH`.
|