Man page - timeout(1)

Packages contains this manual

Available languages:

en fr es pl nl da sv ja ro zh_TW zh_CN de

Manual

TIMEOUT

名 稱
概 述
描 述
退 出 狀 態 :
缺 陷
作 者
報 告 錯 誤
版 權
參 見


名 稱

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

概 述

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

描 述

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

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

--preserve-status

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

指 令 執 行 超 時

--foreground

當 不 是 直 接 在 shell 命 令 提 示 符 下 執 行 timeout 的 情 況 下 使 用 ,

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

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

如 果 初 始 訊 號 已 發 出 且 再 次 等 待 了 指 定 時 間 之 後

所 執 行 命 令 仍 在 執 行 則 發 出 KILL 訊 號

-s , --signal = 訊 號

指 定 超 時 發 生 時 應 當 送 出 的 訊 號 ;

訊 號 可 以 是 類 似 “HUP”的 訊 號 名 或 是 訊 號 數 ; 從 “kill -l ”的 輸 出 可 獲 得 訊 號 的 列 表

-v , --verbose

對 任 何 超 時 後 傳 送 的 訊 號 , 向 標 準 錯 誤 輸 出 診 斷 資 訊

--help

顯 示 此 幫 助 資 訊 並 退 出

--version

顯 示 版 本 資 訊 並 退 出

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

超 時 以 後 , 如 果 沒 有 指 定 其 他 “訊 號 ”, 則 向 給 定 “命 令 ”傳 送 TERM 訊 號 。 TERM 訊 號 將 殺 死 沒 有 阻 塞 或 捕 獲 該 訊 號 的 程 序 。 有 時 可 能 需 要 使 用 KILL 訊 號 , 因 為 此 訊 號 無 法 被 捕 獲 。

退 出 狀 態 :

124

如 果 指 定 “命 令 ”超 時 , 且 未 指 定 --preserve-status 選 項

125

如 果 timeout 命 令 本 身 執 行 失 敗

126

如 果 找 到 了 命 令 , 但 無 法 執 行

127

如 果 未 找 到 命 令

137

如 果 命 令 ( 或 timeout 命 令 本 身 ) 收 到 了 KILL (9) 訊 號 ( 即 128+9)

-

其 他 情 況 下 , 退 出 狀 態 是 命 令 的 退 出 狀 態

缺 陷

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

作 者

由 Padraig Brady 編 寫 。

報 告 錯 誤

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

版 權

Copyright © 2022 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.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