PERIODIC(8)

名称
periodic - 定期的なシステム機能を実行する

書式
periodic < daily | weekly | monthly | path [path ...] >

解説
periodic プログラムは指定されたディレクトリにあるシェルスクリプトを実行するために、 cron(8) に呼び出されることを意図しています。

以下の引数からひとつだけを必ず指定しなければいけません :

daily
    標準的な 1 日周期の実行ファイルを実行します。 これはよく (その地域の時刻で) 朝早くに行なわれます。

weekly
    標準的な 1 週間周期の実行ファイルを実行します。 これはよく日曜日の朝に行なわれます。

monthly
    標準的な 1 ヶ月周期の実行ファイルを実行します。 これはよく月の 1 日目に行なわれます。

path
    実行すべき一連の実行ファイルがあるディレクトリの絶対パスを指定します。

periodic プログラムは指定されたディレクトリ (複数指定可) にある 各実行可能ファイルを実行します。もし実行可能ビットが セットされていないファイルがあっても、無視するだけで それに関するメッセージも表示しません。

環境変数
periodic コマンドは環境変数 PATH をすべての標準的なシステムディレクトリを含むように設定します。 ただし、 /usr/local/bin のような追加的なディレクトリは含めません。もし他のパスに 依存するような実行ファイルを加えるなら、それぞれの実行ファイルが 自己の環境変数を適切に設定する責任を負う必要があります。

関連ファイル

/etc/crontab
    典型的な periodic プログラムの呼び出しはシステムのデフォルト cron テーブル内の エントリから行なわれます。

/etc/periodic
    サブディレクトリとして daily, weekly, monthly を含む上層のディレクトリです。これらのサブディレクトリには システムの標準的な定期的実行ファイルが置かれます。

/etc/rc.conf
    rc.conf システムレジストリは変数 local_periodic を含みます。これは /usr/local/etc/periodic や /usr/X11R6/etc/periodic などのような、定期的に実行する標準の上層ディレクトリを 追加指定するのに使用できます。

使用例
システム crontab には下の例のような periodic のエントリが記述されているはずです :

    # do daily/weekly/monthly maintenance
    0 2 * * * root periodic daily 2>&1
    0 3 * * 6 root periodic weekly 2>&1
    0 5 1 * * root periodic monthly 2>&1

さらに、典型的なシステムレジストリには変数 local_cron について次のように記述してあるでしょう :
    local_cron="/usr/local/etc/periodic /usr/X11R6/etc/periodic" # cron script dirs.

関連項目
sh(1), crontab(5), rc.conf(5), cron(8)

診断
終了状態は成功時には 0 です。もし以下のいずれかの理由で コマンドが失敗すれば、終了状態は 1 になります :

usage: periodic <directory of files to execute> スクリプトフラグメントがどこにあるかを指定する ディレクトリパス引き数が periodic に渡されませんでした。

<directory> not found 説明するまでもありません。(訳注: 指定したディレクトリが見つかりません。)

歴史
periodic プログラムは FreeBSD 3.0 に初めて登場しました。

作者
Paul Traina <pst@FreeBSD.org>