timeout - コマンドを指定時間で実行する
概要
timeout [オプション] 期間 コマンド [引数]...
timeout [オプション]
説明
コマンドを開始し、指定された期間が経過しても実行中の場合は強制終了します。
長いオプションの必須引数は、短いオプションでも必須です。
-f, --foreground
timeout をシェルプロンプトから直接実行しない場合、コマンドが TTY から読み取り、TTY 信号を受け取ることができるようにします。このモードでは、コマンドの子プロセスはタイムアウトされません。
-k, --kill-after=期間
最初の信号が送信されてから、指定された時間が経過してもコマンドが実行中の場合は、KILL 信号も送信します。
-p, --preserve-status
コマンドがタイムアウトした場合でも、コマンドの終了ステータスを保持して終了します。
-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/] に報告してください。
関連項目
kill(1)
完全なドキュメント [https://www.gnu.org/software/coreutils/timeout] または、ローカルで利用可能な info '(coreutils) timeout invocation'
Debian によってパッケージ化 (9.7-3) Copyright © 2025 Free Software Foundation, Inc. ライセンス GPLv3+: GNU GPL バージョン 3 またはそれ以降 [https://gnu.org/licenses/gpl.html]。 これはフリーソフトウェアであり、変更および再配布が可能です。 法で許可されている範囲で、保証はありません。