Manpages

名 稱

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, 將 禁 用 所 關 聯 的 超 時 配 置 。 如 果 命 令 運 行 超 時 , 而 且 --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