TIMEOUT_SIGNAL_NAME

於版本 3.27 新增。

指定當測試程序達到逾時時要發送的自訂訊號。此功能僅在支援 POSIX 訊號的平台上可用，在 Windows 上不可用。

名稱必須是以下其中之一

SIGINT

中斷。

SIGQUIT

退出。

SIGTERM

終止。

SIGUSR1

使用者定義訊號 1。

SIGUSR2

使用者定義訊號 2。

自訂訊號會發送給測試程序，使其有機會在寬限期內優雅地退出。

• 如果測試程序建立了任何子程序，它也有責任終止這些子程序。

• 寬限期的長度由 TIMEOUT_SIGNAL_GRACE_PERIOD 測試屬性決定。

• 如果測試程序在寬限期結束前沒有終止，ctest(1) 將透過 SIGSTOP 和 SIGKILL 強制終止其整個程序樹。

另請參閱 CTEST_TEST_TIMEOUT、TIMEOUT 和 TIMEOUT_AFTER_MATCH。