Provided by: manpages-ja_0.5.0.0.20210215+dfsg-1_all bug

名前

       crontab - cron を駆動するための一覧表

説明

       crontab ファイルには cron(8) デーモンへの命令が 「この日付のこの時刻にこのコマンドを使用せ
       よ」 という形式で書き込まれている。  ユーザはそれぞれ自分用の  crontab  を持っており、  各
       crontab に与えられたコマンドは、 その crontab を所有しているユーザの権限で実行されることに
       なる。 UUCP や News はたいていそれぞれの crontab を持っているので、 cron  コマンドの一部で
       su(1) を明示的に実行する必要性はない。

       空行および行頭のスペース・タブは無視される。 行先頭の空白以外の文字が # の行はコメント行で
       あり、無視される。  cron  コマンドとしての行に注釈としてのコメントを入れることはできない。
       それらはコマンドの一部とみなされてしまう。  同様に、環境変数を設定している行にコメントを入
       れることはできない。

       crontab の動作行は、 環境変数の設定か cronコマンドのいずれかである。  環境変数の設定は以下
       の形式をとる:

           name = value

       ただし、等号  (=)  両側のスペースはなくても良い。 value 内部の (先頭ではない) スペース文字
       は、値の一部として name に与えられる。 value 文字列は引用符で括ってもよい  (シングルクォー
       トでもダブルクォートでも良いが、  揃っている必要がある)。 こうすれば先頭や末尾の空白を値に
       渡すことができる。 value の文字列は、環境変数の置換のためにパースされることは ない  。した
       がって、

           PATH = $HOME/bin:$PATH

       のような行は期待どおりの動作をしないだろう。

       いくつかの環境変数は  cron(8) デーモンによって自動的に設定される。 SHELL は /bin/sh に設定
       され、 LOGNAME とHOME は  /etc/passwd  の  crontab  の所有者の行から設定される。  PATH  は
       "/usr/bin:/bin"  に設定される。  HOME  と  SHELL、PATH は crontab 内部の記述で変更できる。
       LOGNAME はジョブを実行しているユーザなので変更できない。

       (さらに注意:LOGNAME 変数は、 BSD システムではまれに USER と称される...   これらのシステム
       上では USER も設定される。) LOGNAME, HOME, SHELL の他に、 cron(8) は「この」crontab を実行
       した結果メールを送る必要が生じた場合、  MAILTO  も参照する。  もしMAILTOが定義されていたら
       (およびそれが空でなかったら)  その名前のユーザーにメールを送る。 MAILTO が定義されていても
       値が設定されていなければ (MAILTO="")、 メールは送信されない。 MAILTO  が定義もされていなけ
       れば、メールは crontab の所有者に送られる。

       Debian    GNU/Linux    システムでは、cron    は   pam_env   モジュールをサポートしており、
       /etc/security/pam_env.conf で指定された環境変数をロードする。 しかし PAM  の設定は、前述の
       設定や  crontab ファイル自体に書かれた設定を上書きでき ない 。特に、"/usr/bin:/bin" 以外の
       値を PATH に設定したい場合は、 その設定を  crontab  ファイル内で行う必要があることに注意せ
       よ。

       デフォルトでは、cron  が送るメールの  "Content-Type:" ヘッダの値には "text/plain" が使用さ
       れ、その "charset=" パラメータには crond(8) を起動したロケールの文字マップやコードセットが
       設定される。  つまり、使用されるロケールは、 LC_* 環境変数が設定されていない場合はシステム
       のデフォルトのロケール、   そうでなければ   LC_*   環境変数で指定されたロケールとなる    (
       locale(7)     を参照)。     crontab     ファイル内で、     変数     CONTENT_TYPE    または
       CONTENT_TRANSFER_ENCODING の値に、  それらの名前をもつメールヘッダの値として適切な値を設定
       すれば、 メールされる cron ジョブの出力に異なる文字エンコーディングを使用できる。

       cron コマンドの形式は V7 標準そのものであるが、 多くの上位互換な拡張がある。 各行には 5 つ
       の時刻・日付フィールドがあり、 さらにコマンドと改行文字 ('\n') が続く。 システムの crontab
       ファイル  (/etc/crontab) は同様のフォーマットを使用するが、 時刻・日付フィールドとコマンド
       の間で、 コマンドを実行するユーザ名を指定する。 フィールドはスペース区切りでもタブ区切りで
       もかまわない。

       分・時・月が現在時刻と一致し、 かつ、 2 つの日フィールド (月内日または曜日) のいずれかが現
       在時刻と一致すれば  (以下の「注意」を参照)、   コマンドが   cron(8)   によって実行される。
       cron(8) は毎分に一度 cron エントリを調べる。 時間と日付フィールドは以下の通り:

              フィールド 指定可能な値
              ---------- --------------
              分         0-59
              時         0-23
              月内日     1-31
              月         1-12 (もしくは名前。下記を参照)
              曜日       0-7 (0 と 7 は日曜日。もしくは名前)

       フィールドにはアスタリスク (*) も指定できる。 これはあらゆるフィールドで ``first-last'' と
       いう意味になる。

       数値の範囲も指定できる。範囲は二つの数をハイフンでつなげる。  指定数値も領域に含まれる。例
       えば「時」に 8-11 を指定すると、 8時, 9時, 10時, 11時に実行することになる。

       リストもできる。リストはコンマで区切られた数値        (または範囲)        のセットである。
       例:``1,2,5,9'', ``0-4,8-12''

       間隔値を範囲とともに指定することもできる。 範囲の後に ``/<number>'' と指定すると、  範囲内
       で指定数値ずつ飛ばすことになる。 例えば「時」フィールドに ``0-23/2'' と指定すると、 コマン
       ドは 2 時間おきに実行される (V7  標準の別形式で書けば  ``0,2,4,6,8,10,12,14,16,18,20,22'')
       間隔はアスタリスクの後にも指定できる。「2 時間おき」といいたければ ``*/2''とする。

       「月」フィールドや「曜日」フィールドには名前を使用することもできる。  その日または月の最初
       の3文字を用いる  (大文字小文字は問わない)。   範囲やリストを名前に対して用いることはできな
       い。

       「第  6」フィールド (行の残りの部分) には実行されるコマンドを指定する。 その行のコマンド部
       (改行文字または % 文字まで) が /bin/sh (またはその crontab ファイルの SHELL 環境変数で指定
       されたシェル)  によって実行される。 コマンド中にパーセント記号 (%) が バックスラッシュ (\)
       によってエスケープされずに置かれていると、 改行文字に置き換えられ、最初に現れた % 以降の全
       てのデータは 標準入力としてコマンドに送られる。 シェルの行末の "\" のような、 コマンドの単
       一の行を複数行に分割して記述する方法は、crontab にはない。

       注意: コマンド実行の日は 2 つのフィールドで指定できる — 月内日および曜日である。  もし両方
       のフィールドが制限指定  (* 以外) であると、 いずれかのフィールドが現在時刻と合った時にコマ
       ンドが実行される。 例えば、
       ``30 4 1,15 * 5''
       とすると、毎月 1 日と 15 日および毎週金曜日の 午前 4:30 にコマンドが実行される。

       最初の 5 つのフィールドの代わりに、 8 つの特殊な文字列のいずれか 1  つを指定してもかまわな
       い:

              文字列         意味
              ------         ----
              @reboot        起動時に一度だけ実行。
              @yearly        年に一度だけ実行 ("0 0 1 1 *" と等価)。
              @annually      (@yearly と同様)
              @monthly       月に一度だけ実行 ("0 0 1 * *" と等価)。
              @weekly        週に一度だけ実行 ("0 0 * * 0" と等価)。
              @daily         一日に一度だけ実行 ("0 0 * * *" と等価)。
              @midnight      (@daily と同様)
              @hourly        一時間に一度だけ実行 ("0 * * * *" と等価)。

CRON ファイルの例

       # コマンドの実行に、デフォルトの /bin/sh ではなく /bin/bash を使用する。
       SHELL=/bin/bash
       # (この crontab の所有者に関らず) あらゆる出力を `paul' にメールする。
       MAILTO=paul
       #
       # 毎日、日付変更の 5 分後に実行する
       5 0 * * *       $HOME/bin/daily.job >> $HOME/tmp/out 2>&1
       # 毎月初日の 2:15pm に実行する -- 出力は paul にメールされる
       15 14 1 * *     $HOME/bin/monthly
       # 平日の午後 10 時に実行してジョーを心配させる
       0 22 * * 1-5    mail -s "午後10時だ" joe%ジョー、%%お前の子どもはどこだい?%
       23 0-23/2 * * * echo "毎日 0,2,4..時 23 分に実行する"
       5 4 * * sun     echo "日曜 4 時 5 分に実行する"

システム CRON ファイルの例

       システム CRON ファイルはユーザ名のフィールドを含み、 /etc/crontab によって使用される。
       # /etc/crontab: システム規模の crontab
       # 他の crontab ファイルとは異なり、このファイルを編集する際には、新し
       # いバージョンをインストールするための `crontab' コマンドを実行する必
       # 要はない。またこのファイルには、他の crontab ファイルのいずれにも含
       # まれないユーザ名のフィールドが含まれる。

       SHELL=/bin/sh
       PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin

       # m h dom mon dow user    command
       42 6 * * *        root    run-parts --report /etc/cron.daily
       47 6 * * 7        root    run-parts --report /etc/cron.weekly
       52 6 1 * *        root    run-parts --report /etc/cron.monthly
       #
       # anacron の呼び出しは /etc/cron.d ファイルによって行われるようになっ
       # たので、削除された。

関連項目

       cron(8), crontab(1)

拡張

       曜日指定において、 0 も 7 も日曜日とみなされる。 BSD と ATT ではこのようにはなっていないよ
       うだ。

       リストと範囲は同じフィールドに共存できる。 ATT や BSD の cron では "1-3,7-9"  は拒否される
       だろう -- "1-3" または "7,8,9" のいずれかだけしか指定できない。

       範囲に「間隔値」を指定できる。すなわち "1-9/2" が "1,3,5,7,9" と同じ。

       月または曜日を名前で指定できる。

       環境変数を  crontab の内部で設定できる。 BSD や ATT では、子プロセスに渡される環境は基本的
       に /etc/rc のものである。

       コマンドの出力は crontab の所有者にメールされる (BSD ではこれを行わない)。 また crontab の
       所有者以外の人にもメールできる (SysV ではこれができない)。 さらにこの機能を無効にし、 誰に
       もメールを送らないようにもできる (SysV ではこれもできない)。

       最初の 5 つのフィールドの代わりに指定できる `@' コマンドは全て拡張である。

著者

       Paul Vixie <paul@vix.com>