TIMEOUT

Section: ユーザーコマンド (1)
Updated: 2025/09
Index JM Home Page

名前

timeout - 時間制限付きでコマンドを実行する

書式

timeout [,OPTION/]... ,DURATION COMMAND /[,ARG/]...

説明

COMMAND を開始し、DURATION 経過後も実行中の場合は終了させます。

長いオプションで必須となっている引数は短いオプションでも必須です。

-f, --foreground: timeout がシェルプロンプトから直接実行されていない場合、COMMAND が TTY から読み込みを行い、TTY シグナルを受信できるようにします。このモードでは COMMAND の子プロセスはタイムアウトしません。
-k, --kill-after=,DURATION/: 最初にシグナルを送ってから DURATION を経過しても COMMAND がまだ動作している場合は KILL シグナルを送ります。
--preserve-status: コマンドがタイムアウトした場合であっても、COMMAND の終了ステータスを返します。
-s, --signal=,SIGNAL/: タイムアウト時に送るシグナルを指定します。SIGNAL には 'HUP' のようなシグナル名かシングル番号を使用します。シグナル一覧については 'kill -l' を参照。
-v, --verbose: タイムアウト時に送信されたシグナル情報を標準エラーに出力します。
--help: 使い方を表示して終了します。
--version: バージョン情報を表示して終了します。

DURATION は浮動小数点数で指定し、追加で次の接尾辞を指定できます: 秒を表す 's' (デフォルト)、分を表す 'm'、時間を表す 'h'、日を表す 'd'。 DURATION に 0 が指定された場合、タイムアウトは無効になります。

タイムアウト時に、他の SIGNAL が指定されていない場合は、COMMAND に TERM シグナルを送信します。TERM シグナルは、そのシグナルをブロックまたはキャッチしないプロセスを強制終了します。このシグナルはキャッチできないため、KILL シグナルを使用する必要がある場合があります。

終了ステータス:

124: タイムアウト、かつ、--preserve-status が指定されていない
125: timeout コマンド自身が失敗
126: COMMAND が見つかったが、起動できない
127: COMMAND が見つからない 137 コマンド (あるいはそれ自身がタイムアウト) が KILL (9) シグナル (128+9) を送った
-: COMMAND の終了ステータスなど

バグ

現時点では、いくつかのプラットフォームは、 2038 年を越えるタイムアウトに対応していません。

作者

作者 Padraig Brady。

バグのレポートについて

バグのレポートは bug-coreutils@gnu.org までお寄せ下さい。
GNU coreutils のホームページ: <https://www.gnu.org/software/coreutils/>
一般的な GNU ソフトウェア使用に関するヘルプは <https://www.gnu.org/gethelp/> です。
翻訳に関するバグは <https://translationproject.org/team/ja.html> に連絡してください。

著作権

Copyright © 2025 Free Software Foundation, Inc. ライセンス 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.