cron

cron
	cronの使用例
開発元	AT&Tベル研究所
初版	1975年5月 (49年前)
プログラミング; 言語	C言語
対応OS	Unix、Unix系、Plan 9、Inferno
種別	ジョブ管理システム
	テンプレートを表示

cronは、Unix系オペレーティングシステムのジョブ管理ツールである。cronジョブ^[1]^[2]（コマンドまたはシェルスクリプト）を予約すると^[3]、指定した日時または間隔でジョブを実行する^[4]。cronは、主にシステムの管理・維持を自動化する目的で使用されるが、一定の間隔でファイルや電子メールをインターネットからダウンロードするなどの用途にも応用できる^[5]。

cronは、反復的なタスクを予約するのに有用である。一度だけ実行するタスクの予約には、atコマンドを使用する。

名称は、「時間」を指すギリシア語の単語「chronos」に由来する^[6]。

概要

cronの動作は、crontab（cron table）ファイルで指定する。crontabは、一定のスケジュールで定期的に実行するシェルコマンドを指定する設定ファイルである。crontabファイルには、ジョブの一覧と、その他のcronデーモンへの指示が記録される。ユーザーは自分のcrontabを作成することができ、通常それとは別に、管理者のみが編集できるシステム全体のcrontabファイルが/etcまたはそのサブディレクトリ（例: /etc/cron.d）に存在する^[7]。

各行は、次の形式でジョブを定義する。

# ┌───────────── 分（0〜59）
# │ ┌───────────── 時（0〜23）
# │ │ ┌───────────── 日（1〜31）
# │ │ │ ┌───────────── 月（1〜12）
# │ │ │ │ ┌───────────── 曜日（0〜6〈日〜土〉、一部のシステムでは7も日曜日）
# │ │ │ │ │
# │ │ │ │ │
# * * * * * [予約するコマンド]

各行は、コマンドを実行するタイミングを指定する5つの欄に続いて、実行するシェルコマンドを記入するという形式を取る。

通常、日時指定欄がすべて現在の日時と一致する場合にジョブが実行されるが、日（3つ目の欄）と曜日（5つ目の欄）の両方が指定されている（*ではない）場合、どちらかのみ一致する場合にもジョブが実行される^[8]。

例えば、以下は、cronのユーザーのデフォルトのシェルがBourne shellの場合に、Apacheのエラーログを毎日深夜から1分経過後に消去するジョブである。

1 0 * * * printf "" > /var/log/apache/error_log

また、以下は、export_dump.shを毎週土曜日23時45分に実行するジョブである。

45 23 * * 6 /home/oracle/scripts/export_dump.sh

一部のシステムでは、*/nを指定して、n日・時間・分ごとにジョブを実行することができる。また、コンマを使って複数の時間間隔を指定することもできる（例: 1,2,3）。例えば、以下の行は、1時から3時55分まで5分ごと（1時0分、1時5分、1時10分、…3時55分）にコマンドラインに「hello world」を出力する。

*/5 1,2,3 * * * echo hello world

各ユーザーは、実際に設定ファイルが保存されている場所によらず、crontab -eを呼び出して自分の設定ファイルを編集できる。

多くのLinuxディストリビューションにインストールされているポール・ヴィクシーのBSD版cron実装は、ジョブを実行するアカウントのユーザー名を指定する6番目の欄を追加する。これは、システムのcrontabでのみ許可され、各ユーザーが単独で設定するよう割り当てられたその他のファイルでは使用できない。また、WindowsのnnCronデーモンなど、6番目の欄をアカウントのユーザー名ではなく年の指定に使うものもある。

Amazon EventBridgeのcron実装では、0を基底とせず、日曜日から土曜日まで1〜7で曜日を指定し、月の最初の平日や月末などを指定する追加の機能を持つ^[9]。

非標準のマクロ

一部のcron実装^[10]は、以下の非標準のマクロをサポートしている。

マクロ	説明	等価の表現
`@yearly`（`@annually`）	毎年1月1日の0時0分に実行	`0 0 1 1 *`
`@monthly`	毎月1日の0時0分に実行	`0 0 1 * *`
`@weekly`	毎週日曜日の0時0分に実行	`0 0 * * 0`
`@daily`（`@midnight`）	毎日0時0分に実行	`0 0 * * *`
`@hourly`	毎時0分に実行	`0 * * * *`
`@reboot`	起動時に実行	—

@rebootを指定すると、デーモン起動時にジョブが1回実行される。cronは通常再起動されることがないため、これは通常マシンの起動時と一致する。Debian版のcronなど、一部の種類のcronはマシンの起動時にのみ実行するよう設計されており^[11]、デーモンの再起動時には@rebootのジョブが再実行されないようになっている。

@rebootは、特定のユーザーでサーバーやデーモンを起動する必要があり、ユーザーがプログラムを起動するようinitを設定する権限がない場合に有用である。

cronのパーミッション

次の2つのファイルは重要な役割を担っている。

/etc/cron.allow – このファイルが存在する場合、cronジョブを使用するにはユーザー名がこのファイルに含まれている必要がある。
/etc/cron.deny – cron.arrowファイルが存在せず、cron.denyファイルが存在する場合、cronジョブを使用するにはユーザー名がcron.denyファイルに含まれていない必要がある。

どちらのファイルも存在しない場合、サイト固有の設定パラメーターにより、スーパーユーザーのみがcronジョブを使用できるか、すべてのユーザーがcronジョブを使用できるかが決定される。

タイムゾーンの処理

多くのcron実装は、crontabの項目をcronデーモンが実行されているシステムのタイムゾーンの設定に基づいて解釈する。複数のユーザー向けの大規模なマシンで、ユーザーが地理的に複数のタイムゾーンに分散しているケースで、特にシステムのデフォルトのタイムゾーンが混乱を招くおそれのある夏時間を採用している場合、これは問題となる場合がある。このため、cron実装の中には、ユーザーのcrontabのCRON_TZ=[タイムゾーン]の形式を取る行を認識して、その行以降のcrontabの項目を指定されたタイムゾーンに基づいて解釈するものもある^[12]。

式

cronの式は、時間を指定するホワイトスペースで区切られた5つまたは6つの欄の文字列で^[13]、特定の作業を予約する。

コメントは#で始まる。

欄	必須	許容される値	許容される特殊文字	備考
分	Yes	0〜59	`*` `,` `-`
時	Yes	0〜23	`*` `,` `-`
日	Yes	1〜31	`*` `,` `-` `?` `L` `W`	`?` `L` `W`は一部の実装でのみ許容される。
月	Yes	1〜12 JAN〜DEC	`*` `,` `-`
曜日	Yes	0〜6 SUN〜SAT	`*` `,` `-` `?` `L` `#`	`?` `L` `#` は一部の実装でのみ許容される。
年	No	1970〜2099	`*` `,` `-`	この欄は標準・デフォルトの実装ではサポートされない。

月と曜日の省略記法は大文字・小文字が区別されない。

システムのcrontabファイル（/etc/crontab）には、コマンドを指定する欄の直前にユーザー名を指定する欄が存在する。この欄は通常rootに設定される。

また、一部の実装では、行の最初に秒の指定欄が存在する場合もある。この場合、各行に6つまたは7つの欄が存在することになる^[14]。

アスタリスク（*）: アスタリスク（ワイルドカード）は「すべて」を表す。例えば、* * * * *を指定すると、ジョブが毎分実行される。* * * * 1を指定すると、ジョブが月曜日にのみ毎分実行される。秒の指定に対応している場合、アスタリスクを6個指定するとジョブが毎秒実行される。

コンマ（,）: コンマは、値を複数指定するのに使う。例えば、5番目の欄でMON,WED,FRIは「月曜日・水曜日・金曜日」を指す。

ハイフン（-）: ハイフンは範囲を表す。例えば、2000-2010は、2000年から2010年までのすべての年を指す。

パーセント（%）: コマンド内のパーセント（%）は、バックスラッシュ（\）でエスケープされていない場合、改行文字に変換され、最初の%以降のデータが標準入力としてコマンドに渡される^[15]。

非標準文字

以下は、Javaのジョブ管理ツールQuartzなど、一部のcron実装にのみ存在する非標準の文字である。

L: Lは「最後の（last）」を意味する。曜日欄で、「最後の金曜日」（5L）などを指定するのに使う。日欄では、月の最終日を指定するのに使う。

W: Wは、日欄で使用でき、その日に最も近い平日（月曜日〜金曜日）を指定できる。例えば、15Wと記入すると、15日に最も近い平日が指定され、15日が土曜日であれば、14日（金曜日）にジョブが実行される。また、15日が日曜日であれば、16日（月曜日）に実行される。15日が火曜日であれば、そのまま15日（火曜日）に実行される。ただし、日欄に1Wを指定し、1日が土曜日であった場合、ジョブは月を跨がず3日（月曜日）に実行される。Wは、日の範囲指定や一覧指定には使用できない。

ハッシュ（#）: #は、曜日欄で使用でき、この記号に続いて1〜5の数字を指定する。月の「第2金曜日」などを指定するのに使う^[16]。例えば、5#3と記入すると、毎月第3金曜日にジョブが実行される。

クエスチョンマーク（?）: 一部の実装では、月・曜日欄を空欄にする際に*の代わりに?を使う。その他の実装では、?がデーモンが起動した時間に置き換えられる。例えば、デーモンが午前8時25分に起動した場合には? ? * * * *が25 8 * * * *と解釈され、再起動されるまで毎日この時間に実行される^[17]。

スラッシュ（/）: Vixie Cronでは、スラッシュは範囲と組み合わせて刻み値を指定するのに使う^[18]。例えば、分欄に*/5と記入すると、毎5分が指定される。より冗長なPOSIXの5,10,15,20,25,30,35,40,45,50,55,00の省略表記である。POSIXにはスラッシュの用法に関する定義がない^[8]。

H: HはJenkins継続的インテグレーションシステムで使用できる。例えば、20 * * * *（毎時20分）を指定する代わりに、H * * * *を指定して、ジョブを1時間に1回、未指定（ただし一定）の時間に継続的に実行するよう指定できる。これにより、各ジョブがそれぞれ別のタイミングで分散して実行されるようになり、複数のジョブが同じタイミングで実行されてリソースを奪い合うことを防ぐことができる^[19]。

脚注

^ “Difference between cron, crontab, and cronjob?” (英語). Stack Overflow. 2023年8月31日閲覧。
^ “What Is a Cron Job: Understanding Cron Syntax and How to Configure Cron Jobs”. Hostinger (2023年4月14日). 2023年8月31日閲覧。
^ “Automation with Cron job on Centos 8”. Comtronic (April 6, 2020). 2023年8月31日閲覧。
^ “Crontab – Quick Reference”. Admin's Choice (2009年12月21日). 2023年8月31日閲覧。
^ “Newbie Introduction to cron”. Unix Geeks (1999年12月30日). 2023年8月31日閲覧。
^ “Linux – cron and crontab”. Cornell University. 2019年6月4日時点のオリジナルよりアーカイブ。2023年8月31日閲覧。
^ ディストリビューションの種類による。
^ ^a ^b “crontab”. The Open Group Base Specifications. The IEEE and The Open Group. (2018) 2023年8月31日閲覧。
^ “Cron expressions reference”. Amazon Web Services. 2023年8月31日閲覧。
^ “crontab(5)”. FreeBSD File Formats Manual. The FreeBSD Project 2023年8月31日閲覧。
^ “#77563 – cron: crontab(5) lies, '@reboot' is whenever cron restarts, not the system”. Debian BTS. 2023年8月31日閲覧。
^ “crontab(5): tables for driving cron – Linux man page”. die.net. 2023年8月31日閲覧。
^ “Ubuntu Cron Howto”. Ubuntu (2016年11月20日). 2023年8月31日閲覧。
^ “CronTrigger Tutorial”. Quartz Scheduler. 25 October 2011時点のオリジナルよりアーカイブ。2023年9月1日閲覧。
^ “mcron crontab reference”. GNU. 2023年8月31日閲覧。
^ “Oracle® Role Manager Integration Guide”. Oracle. 2023年8月31日閲覧。
^ “Cron format”. nnCron. 2023年8月31日閲覧。
^ “FreeBSD File Formats Manual for CRONTAB(5)”. The FreeBSD Project. 2023年8月31日閲覧。
^ “Timer Trigger Syntax”. Jenkins. 2023年8月31日閲覧。

外部リンク

GNU mcron

[1] “Difference between cron, crontab, and cronjob?” (英語). Stack Overflow. 2023年8月31日閲覧。

[2] “What Is a Cron Job: Understanding Cron Syntax and How to Configure Cron Jobs”. Hostinger (2023年4月14日). 2023年8月31日閲覧。

[3] “Automation with Cron job on Centos 8”. Comtronic (April 6, 2020). 2023年8月31日閲覧。

[4] “Crontab – Quick Reference”. Admin's Choice (2009年12月21日). 2023年8月31日閲覧。

[5] “Newbie Introduction to cron”. Unix Geeks (1999年12月30日). 2023年8月31日閲覧。

[6] “Linux – cron and crontab”. Cornell University. 2019年6月4日時点のオリジナルよりアーカイブ。2023年8月31日閲覧。

[7] ディストリビューションの種類による。

[:0-8] “crontab”. The Open Group Base Specifications. The IEEE and The Open Group. (2018) 2023年8月31日閲覧。

[amazon_eventbridge-9] “Cron expressions reference”. Amazon Web Services. 2023年8月31日閲覧。

[10] “crontab(5)”. FreeBSD File Formats Manual. The FreeBSD Project 2023年8月31日閲覧。

[debiancron-11] “#77563 – cron: crontab(5) lies, '@reboot' is whenever cron restarts, not the system”. Debian BTS. 2023年8月31日閲覧。

[man_5_crontab-12] “crontab(5): tables for driving cron – Linux man page”. die.net. 2023年8月31日閲覧。

[13] “Ubuntu Cron Howto”. Ubuntu (2016年11月20日). 2023年8月31日閲覧。

[14] “CronTrigger Tutorial”. Quartz Scheduler. 25 October 2011時点のオリジナルよりアーカイブ。2023年9月1日閲覧。

[15] “mcron crontab reference”. GNU. 2023年8月31日閲覧。

[16] “Oracle® Role Manager Integration Guide”. Oracle. 2023年8月31日閲覧。

[17] “Cron format”. nnCron. 2023年8月31日閲覧。

[freebsd2-18] “FreeBSD File Formats Manual for CRONTAB(5)”. The FreeBSD Project. 2023年8月31日閲覧。

[jenkins-19] “Timer Trigger Syntax”. Jenkins. 2023年8月31日閲覧。

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[9]

[10]

[11]

[12]

[13]

[14]

[15]

[16]

[17]

[18]

[19]

表話編歴 Unix コマンド
ファイルとファイルシステム管理	cat chattr（英語版） chmod chown chgrp cksum cmp cp dd du df（英語版） file fsck fuser（英語版） ln ls lsof mkdir mount mv pax pwd rm rmdir size split tee touch type（英語版） umask（英語版）
プロセス管理	at bg chroot cron fg kill killall nice pgrep pidof pkill ps pstree（英語版） reboot shutdown time top
ユーザ管理/環境	clear env exit finger history（英語版） id logname（英語版） mesg passwd su sudo uptime talk tput（英語版） uname w wall who whoami write
テキスト処理	awk banner basename comm（英語版） csplit（英語版） cut diff dirname ed ex（英語版） fmt fold（英語版） head iconv join（英語版） less m4 more nkf nl paste（英語版） patch printf（英語版） read（英語版） sed sort spell（英語版） strings tail tr troff uniq vi wc xargs yes
シェルビルトイン	alias cd echo test（英語版） unset wait
通信	dig host（英語版） ifconfig inetd ip (iproute2) netcat netstat nslookup ping rdate（英語版） rlogin route ssh traceroute
検索	find grep locate（英語版） whatis（英語版） whereis（英語版）
マニュアル	apropos（英語版） help（英語版） man
ソフトウェア開発	ar ctags lex make nm strip（英語版） yacc
その他	bc dc cal date expr false lp（英語版） lpr od sl sleep stty true tty
Category:UNIXのソフトウェア UNIXユーティリティの一覧

概要

非標準のマクロ

cronのパーミッション

タイムゾーンの処理

式

非標準文字

関連項目

脚注

外部リンク