manページ  — CRONTAB

空行と、先頭の空白およびタブは無視されます。 最初の非空白文字がポンド記号 (#) である行は注釈行であり、無視されます。 注釈は cron コマンドと同じ行にあってはいけません。 なぜなら、注釈自身がコマンドの一部とみなされるからです。 同様に、注釈は環境変数を設定する行と同じ行にあって はいけません。

crontab の中で有効なのは環境変数の設定かまたは cron コマンドのどちらかです。 環境変数の設定は次のような形で行います。

    name = value

ここで等号 (=) の周囲の空白は有っても良いですが、 value の中で = に引き続くスペースでない部分だけが name に割当てられる値となります。 value 文字列はクォート (シングルクォートまたはダブルクォートですがどちらかに統一します) で囲うこともでき、そのときには = に続くブランクや末尾のブランク を含むことができます。 name 文字列もクォート (シングルクォートまたはダブルクォートですがどちらかに統一します) で囲うこともでき、前置、後置および内部の空白を保ちます。

いくつかの環境変数は自動的に cron(8) デーモンによって設定されます。 SHELL は /bin/sh に設定され、 LOGNAME と HOME はその crontab の所有者の /etc/passwd 行を元に設定されます。 HOME と SHELL は、crontab ファイル中で設定することで上書きできますが、 LOGNAME はできません。

(別注: LOGNAME 変数は BSD システム上では USER と呼ばれることがあります。このようなシステム上では USER も設定されます。)

LOGNAME, HOME, SHELL に加え、 ``この'' crontab で実行したコマンドの実行結果をメールで送る理由がある場合、 cron(8) は MAILTO を見ます。 MAILTO が定義されていて (かつ空でない) とき、そこで指定された名前のユーザへメール が送られます。 なお MAILTO に複数の受信者をコンマで区切って指定すると、複数の受信者へメールを送れます。 MAILTO が定義されているが空のとき (MAILTO="")、メールは送られません。 その他の場合にはメールは crontab の所有者に送られます。 cron インストール時に、メーラとして /usr/lib/sendmail ではなく /bin/mail を使う場合、このオプションは有用です -- /bin/mail はエイリアスを行いませんし、UUCP は通常自分宛のメールを読みません。

cron コマンドのフォーマットはほとんど V7 標準であり、多くの上位互換拡張を 持っています。各行は 5 つの時間と日付の欄、システム crontab ファイルの場合は続いてユーザ名 (``:<グループ>'' および ``/<ログインクラス>'' の添字が付くこともあります)、 その後にコマンドが続きます。分、時間、月の欄と現在の時刻が一致し、 かつ 2 つの日付欄 (月における日または曜日) のうちの少なくとも 1 つと 現在の時刻が一致したとき (下記の ``注'' 参照) に、コマンドは cron(8) により実行されます。 cron(8) は 1 分ごとに cron エントリを調べます。時間と日付の欄は次のとおりです。

     欄          　　　　　　　　　許される値
------------   ------------------------------------------------
     分       0-59
    時間      0-23
月における日  1-31
     月       1-12 (または名前、下記参照)
    曜日      0-7 (0 および 7 は日曜のこと。名前を用いてもよい)

欄はアスタリスク (*) でも良いですが、このときには常に "最初-最後" を表すこ とになります。

数値領域を指定できます。領域指定は、2 つの数をハイフンでつなげたものです。 指定された領域は、両端を含みます。 たとえば ``時間'' エントリの 8-11 は、 8, 9, 10, 11 時の実行を指定することになります。

リスト指定もできます。リスト指定はコンマによって数 (または領域指定) をつな げた 1 組のことです。例: ``1,2,5,9'', ``0-4,8-12''。

間隔値は領域指定と共に用いることができます。領域指定に続けて ``/<数>'' を指定すると、その領域を通じてその数の値だけ飛ばす値になります。 たとえば ``0-23/2'' は時間の欄で用いられると、2 時間おきにコマンドを実行 することになります (別の方法で V7 標準で表せば ``0,2,4,6,8,10,12,14,16,18,20,22'' となります)。間隔指定はアスタリスクの 後で付けても構いません。たとえば ``2 時間おきに全て'' ということをしたい なら ``*/2'' とするだけです。

``月'' および ``曜日'' の指定には、名前を使用することができます。 曜日と月の指定には、最初の 3 文字を使ってください (この場合、 大文字・小文字の区別はありません)。名前による領域指定やリスト指定はでき ません。

``6 番目'' の欄 (行の残りの部分) には実行したいコマンドを指定します。行の 中のコマンド部全体、これは改行または % 文字までですが、は /bin/sh かまたはその cron ファイルの SHELL 変数で指定されたシェルによって実行されます。コマンド内のパーセント記号 (%) はバックスラッシュ (\) でエスケープされない限り改行文字に変換され、そ の最初の % 以降の全てのデータはそのコマンドの標準入力となります。

注: コマンド実行の日付は 2 つの欄 &#151; 1 ヶ月中の日 および曜日 &#151; で指定できます。両方の欄が領域限定されている (すなわち * でない ) 場合、コマンドは どちらかの 欄が現在の時刻と一致するときに実行されます。たとえば ``30 4 1,15 * 5'' は各月の 1 日および 15 日に加えて全ての金曜日において、 午前 4:30 にコマンドを実行させます。

最初の 5 個の欄の代りに、 8 種類の特殊文字列のうちのいずれかが登場しても良いです:

文字列             意味
------          -------
@reboot         起動時に 1 回実行。
@yearly         年に 1 回実行、すなわち "0 0 1 1 *"。
@annually       (@yearly と同じ)
@monthly        月に 1 回実行、すなわち "0 0 1 * *"。
@weekly         週に 1 回実行、すなわち "0 0 * * 0"。
@daily          日に 1 回実行、すなわち "0 0 * * *"。
@midnight       (@daily と同じ)
@hourly         時間に 1 回実行、すなわち "0 * * * *"。

US タイムゾーンでは (IN, AZ, HI を除き)、時刻シフトは午前 2 時に起ります。 他の国では、 zdump(8) プログラムの冗長 -( -v) オプションを使用して、時刻シフトがいつ起るのかを判定してください。