名前

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

書式

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

説明

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

長いオプションに必須の引数は短いオプションにも必須です。

--foreground

timeout がシェルプロンプトから直接実行されていない場合、COMMAND が TTY から読み込みを行い、TTY シグナルを受信できるようにする。このモードでは COMMAND の子プロセスはタイムアウトしない。

-k, --kill-after= DURATION

最初にシグナルを送ってから DURATION を経過しても COMMAND がまだ動作している場合は KILL シグナルを送る。

-s, --signal= SIGNAL

タイムアウト時に送るシグナルを指定する。SIGNAL には 'HUP' のようなシグナル名かシングル番号を使用する。シグナル一覧については 'kill -l' を参照

--help

この使い方を表示して終了する

--version

バージョン情報を表示して終了する

DURATION は浮動小数点数で指定し、追加で次の接尾辞を指定できます: 秒を表す 's' (デフォルト)、分を表す 'm'、時間を表す 'h'、日を表す 'd'。

コマンドがタイムアウトした場合、終了ステータスは 124 になります。それ以外の場合、COMMAND の終了ステータスが終了ステータスになります。シグナルが指定されていない場合、タイムアウト時には TERM シグナルが送られます。この TERM シグナルにより、TERM シグナルをブロックもしくは捕捉していないプロセスは、すべて終了されます。TERM で終了できないプロセスを終了させるためには KILL (9) シグナルを使う必要です (KILL シグナルは捕捉することができません)。 KILL (9) シングルが送信された場合は、終了ステータスは 124 ではなく 128+9 にないます。

バグ

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

作者

作者 Pádraig Brady。

バグの報告

timeout のバグを発見した場合は bug-coreutils@gnu.org に報告してください。 GNU coreutils のホームページ: <http://www.gnu.org/software/coreutils/> GNU ソフトウェアを使用する際の一般的なヘルプ: <http://www.gnu.org/gethelp/> timeout の翻訳に関するバグは <http://translationproject.org/team/ja.html>に連絡してください。完全な文書を参照する場合は info coreutils 'timeout invocation' を実行してください。

著作権

Copyright © 2012 Free Software Foundation, Inc. ライセンス GPLv3+: GNU GPL version 3 or later <http://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)

timeout の完全なマニュアルは Texinfo マニュアルとして整備されている。もし、 info および timeout のプログラムが正しくインストールされているならば、コマンド

info timeout

を使用すると完全なマニュアルを読むことができるはずだ。