Scroll to navigation

TIMEOUT(1) 使用者命令 TIMEOUT(1)

名稱

timeout - 在規定時限內執行一個命令

概述

timeout [選項列表] 持續時間 命令 [引數列表]...
timeout [選項列表]

描述

執行所給命令,如果它超過指定時間後仍在執行,則殺死其程序。

必選引數對長短選項同時適用。

--preserve-status

將退出狀態值設為與所執行指令的退出狀態相同的值,即使
指令執行超時

--foreground

當不是直接在 shell 命令提示符下執行 timeout 的情況下使用,
允許所執行命令直接由 TTY 讀取資料,並且接收 TTY 的訊號;在這種模式下,所執行命令的子程序將不會被 timeout 的超時控制所考慮

-k, --kill-after=持續時間

如果初始訊號已發出且再次等待了指定時間之後
所執行命令仍在執行則發出 KILL 訊號

-s, --signal=訊號

指定超時發生時應當送出的訊號;
訊號可以是類似“HUP”的訊號名或是訊號數;從“kill -l”的輸出可獲得訊號的列表
對任何超時後傳送的訊號,向標準錯誤輸出診斷資訊
顯示此幫助資訊並退出
顯示版本資訊並退出

持續時間應當是一個浮點數,字尾是可選的:“s”表示秒(預設值),“m”表示分鐘,“h”表示小時,或者使用“d”表示天數。若持續時間為 0,將禁用所關聯的超時配置。

如果命令執行超時,而且 --preserve-status 未設定,則將退出狀態值設為 124。否則,將退出狀態值設定為與所執行命令的退出狀態值相同。如果沒有指定訊號型別,程式將在超時發生時送出 TERM 訊號。TERM 訊號能夠殺死任何沒有阻塞或捕獲該訊號的程序。您也可能需要使用 KILL (9) 訊號,因為該訊號不能被捕獲。此時,退出狀態值將為 128+9 而非 124。

BUGS

某些平臺目前不支援將超時時間設定為超過 2038 年。

作者

由 Padraig Brady 編寫。

報告錯誤

GNU coreutils 的線上幫助: <https://www.gnu.org/software/coreutils/>
請向 <https://translationproject.org/team/zh_CN.html> 報告翻譯錯誤。

版權

請向 <https://translationproject.org/team/zh_CN.html> 報告翻譯錯誤。
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

參見

kill(1)

完整文件請見: <https://www.gnu.org/software/coreutils/timeout>
或者在本地使用: info '(coreutils) timeout invocation'

本頁面中文版由中文 man 手冊頁計劃提供。
中文 man 手冊頁計劃:https://github.com/man-pages-zh/manpages-zh

2020年三月 GNU coreutils 8.32