Cron

This page is a translated version of the page Cron and the translation is 38% complete.

Outdated translations are marked like this.

Other languages:

Resources

Wikipedia

本文介绍如何在 Gentoo Linux 中设置和使用 cron 守护程序。

Cron基础

cron能做什么

Cron 是一种守护程序，它基于 crontab 命令以及向该命令输入的内容。它的工作方式为，每分钟唤醒并检查用户是否有 crontab 清单，以及清单上是否有应该执行的计划工作。

附注
注意 crontab 既是计划工作清单的名字，也是编辑这一清单的命令。

附注
When using the systemd init system, (persistent) timers are available as a replacement of (ana)cron.

实际上的cron程序

在 Portage 里有几个可供选择的 cron 实现。他们都提供了相似的界面，即使用crontab或相似的命令。还有一个叫做 Anacron 的应用，在没有持续运行的系统上协同 cron 一起工作。

所有可用的 cron 包都依赖于 sys-process/cronbase。这个包在技术上不依赖任何 cron 包，但它确实提供了大多数用户认可的类似 cron 的功能。

在开始使用 cron 之前，必须选择合适的 cron 实现。

哪个 cron 适合这份工作？

附注
Emerge virtual/cron 以安装 Gentoo 默认的 cron 实现。

cronie

sys-process/cronie is a fork of the venerable vixie-cron, hosted at [1]. Because of it being a fork, it has the same feature set the original vixie-cron provides. Additionally, cronie comes with an anacron implementation which is enabled by default, through the anacron USE flag. Be aware of the configuration differences as noted in bug #551352 when migrating from another cron system. Expected jobs may not run at all.

dcron (Dillon 的 Cron)

sys-process/dcron aims to be a simple, elegant and secure implementation of cron. It does not allow the specification of environment variables in crontabs and all cron-jobs are run from /bin/sh. Like vixie-cron, each user has their own crontab. As of version 4 it contains anacron-like features.

sys-process/dcron 的特点：

Fast, simple and free of unnecessary features;
Access to crontab is limited to the cron group, i.e. it doesn't rely on any external faculties.

fcron

sys-process/fcron aims at replacing vixie-cron and anacron. It is designed to work on systems that are not continuously running and it is packed with extra features. It has job startup constraints, job serialization controls, the ability to assign nice values to jobs and the ability to schedule jobs to run at system startup.

sys-process/fcron 的特点：

Designed to work on systems that are not continuously running, i.e. it can run a job after restarting if it was missed;
Setting of environment variables and many other options in crontabs;
Enhanced crontab syntax with support for many new features;
Each user can have a personal crontab, access is controlled by cron.allow and cron.deny

bcron

sys-process/bcron is a new cron system designed with secure operations in mind. To do this, the system is divided into several separate programs, each responsible for a separate task, with strictly controlled communications between them. The user interface is a drop-in replacement for similar systems (such as vixie-cron), but the internals differ greatly.

sys-process/bcron 的特点：

vixie-cron 的替代品；；
多进程设计；
本机夏令时支持。

anacron

Anacron is not a cron daemon, it is something that usually works in conjunction with one. It executes commands at intervals specified in days and it does not assume that the system is running continuously; it will run jobs that were missed while the system was down. Anacron usually relies on a cron daemon to run it each day.

使用 cron

安装

为作业选择正确的 cron 实现，然后将其安装：

root #emerge --ask dcron

确保选择的 cron 守护进程已添加到系统的初始化进程中；如果没有这一步，cron 守护进程将无法执行其工作。

root #

/etc/init.d/dcron start

root #rc-update add dcron default

Optionally, if Fcron or dcron have not been installed, installing Anacron as a helper to the cron daemon might be a wise choice.

root #emerge --ask anacron

同样，不要忘记将 anacron 添加到系统的初始化进程中。

root #

/etc/init.d/anacron start

root #rc-update add anacron default

For anacron, there is usually no init process. Instead, anacron needs to be launched through a different cron implementation.

One method is to launch anacron through a cron definition. By default, it installs an hourly run script, which is consumed by most cron implementations. If that isn't the case though, then it can still be launched through manual definitions:

文件 /etc/crontabLaunching anacron through a cron definition

# Start anacron every 10 minutes
*/10 * * *  root  /usr/sbin/anacron
 
# Alternatively, run the anacron-provided 0anacron script every hour
# 59 * * * *  root  /etc/cron.hourly/0anacron

系统 crontab

The post install messages from some of these cron packages instruct the user to run crontab /etc/crontab. The /etc/crontab file is the system crontab. A cron installation can use it in conjunction with sys-process/cronbase to run the scripts in /etc/cron.{daily,hourly,weekly,monthly}. Note that only cronie schedules jobs in /etc/crontab automatically. Dcron users will need to run crontab /etc/crontab every time changes are made to the /etc/crontab file. Fcron users need to run emerge --config sys-process/fcron to configure the system crontab.

Please note that jobs scheduled in the system crontab might not show up in the list of cron-jobs displayed by running crontab -l.

Of course, users can choose not to use any system crontab at all. If dcron or fcron has been chosen, do not run crontab /etc/crontab. If cronie or bcron has been chosen comment all lines in /etc/crontab.

A quick and easy way to comment out all the lines in a file is by using the sed command. Run the following command to comment out all the lines in etc/crontab

root #sed -i -e "s/^/#/" /etc/crontab

授予受信任的用户访问 cron

For users other than root to have access to the cron daemon, read this section, otherwise proceed to the next section.

附注
Giving another user access to crontab does not let him run cron-jobs as root. For a user to be able to edit the root crontab, look into using sudo (app-admin/sudo). Please read the Gentoo Sudo(ers) Guide for more details.

No matter which cron package has been chosen, to allow a user to use crontab he will first have to be in the cron group. As an example, to add the user larry to the cron group run:

root #gpasswd -a wepy cron

附注
When adding a user to the cron group, make sure that the user logs out and logs back in for the group change to take effect.

dcron

When using dcron, the above step is all that is needed to give a user access to crontab. Dcron users may proceed to the next section, all others need to keep reading.

fcron

When using fcron, edit the /etc/fcron/fcron.deny and /etc/fcron/fcron.allow files. The most secure way to run a system is to first deny all users in /etc/fcron/fcron.deny, and then explicitly allow users in /etc/fcron/fcron.allow.

重要
If neither /etc/fcron/fcron.allow nor /etc/fcron/fcron.deny exist then all users in the cron group will be allowed to use crontab. fcron comes with a default fcron.allow which allows all users in the cron group access to fcrontab.

代码 fcron.deny 中的权限

all

If a user (larry again for this example) should be able to schedule his own cron-jobs, then add him to /etc/fcron/fcron.allow as follows:

代码 fcron.allow 中的权限

wepy

cronie

If cronie has been chosen, then simply edit the /etc/cron.allow file.

重要
It is important to note that if only /etc/cron.allow exists, then only the cron group users listed there will have access. Otherwise, if only an empty /etc/cron.deny exists, then all cron group users will be allowed. Do not leave an empty /etc/cron.deny if no /etc/cron.allow file exists!

For example, to allow access to the user larry, add him to /etc/cron.allow as follows:

代码 /etc/cron.allow 中的权限

wepy

调度 cron 作业

The process of editing crontabs is different for each package, but they all support the same basic set of commands: adding and replacing crontabs, editing crontabs, deleting crontabs, and listing cron-jobs in crontabs. The following list shows how to run various commands for each package.

Version	Edit crontab	Remove crontab	New crontab	List cron-jobs
dcron	crontab -e	crontab -d [user]	crontab file	crontab -l
fcron	fcrontab -e	fcrontab -r [user]	fcrontab file	fcrontab -l
cronie and bcron	crontab -e	crontab -r -u [user]	crontab file	crontab -l

附注
When using the remove command, if no argument is supplied, it deletes the current user's crontab.

附注
Fcron also has a symlink from crontab to fcrontab.

Before any of these commands can be used, first understanding of the crontab itself is needed. Each line in a crontab specifies five time fields in the following order: the minutes (0-59), hours (0-23), days of the month (1-31), months (1-12), and days of the week (0-7, Monday is day 1, Sunday is day 0 and day 7). The days of the week and months can be specified by three-letter abbreviations like mon, tue, jan, feb, etc. Each field can also specify a range of values (e.g. 1-5 or mon-fri), a comma separated list of values (e.g. 1,2,3 or mon,tue,wed) or a range of values with a step (e.g. 1-6/2 as 1,3,5).

That sounds a little confusing, but with a few examples it is easy to see it is not as complicated as it sounds.

代码示例

# 全年每分钟运行 /bin/false
*     *     *     *     *        /bin/false
  
# 在每个月的周一、周二、周三和 4 号的 1:35 运行 /bin/false
35    1     4     *     mon-wed  /bin/false
  
# 在 3 月 2 日的 22:25 运行 /bin/true
25    22    2     3     *        /bin/true
  
# 在每周一、周三和周五的 2:00 运行 /bin/false
0     2     *     *     1-5/2    /bin/false

附注
Notice how to specify specific days of the week and days of the month before they are combined. If * is used for only one of them, the other takes precedence, while * for both just means every day.

To test what was just covered go through the steps of actually inputting a few cron-jobs. First, create a file called crons.cron and make it look like the this:

文件 crons.cron创建 crons.cron 文件

#Mins  Hours  Days   Months  Day of the week
10     3      1      1       *       /bin/echo "I don't really like cron"
30     16     *      1,2     *       /bin/echo "I like cron a little"
*      *      *      1-12/2  *       /bin/echo "I really like cron"

Now add that crontab to the system with the "new command" from the table above.

root #crontab crons.cron

附注
除非使用重定向，否则不会看到 echo 命令的输出。

To verify the scheduled cron-jobs, use the proper list command from the table above.

root #crontab -l

A list resembling crons.cron should be displayed; if not maybe the wrong command was issued to input the crontab.

This crontab should echo "I really like cron" every minute of every hour of every day every other month. Obviously a user would only do that if they really liked cron. The crontab will also echo "I like cron a little" at 16:30 every day in January and February. It will also echo "I don't really like cron" at 3:10 on the January 1st.

If using anacron keep reading this section. Otherwise, proceed to the next section on Editing crontabs.

Anacron users will want to edit /etc/anacrontab. This file has four fields: the number of days between each run, the delay in minutes after which it runs, the name of the job, and the command to run.

For example, to have it run echo "I like anacron" every 5 days, 10 minutes after anacron is started, enter the following:

文件 /etc/anacrontab

5 10 wasting-time /bin/echo "I like anacron"

Anacron exits after all of the jobs in anacrontab have finished. To check to see if these jobs should be performed every day, a cron daemon will be used. The instructions at the end of the next section explain how this should be handled.

编辑 crontab

Being realistic, no user would want their system telling them how much they like cron every minute. As a step forward, remove the previous example crontab using the corresponding remove command from the table above. Use the corresponding list command to view the cron-jobs afterward to make sure it worked.

root #

crontab -d

root #crontab -l

No cron-jobs should be displayed in the output from crontab -l. If cron jobs are listed, then the remove command failed to remove the crontab; verify the correct remove command for the system's cron package.

Now that we have a clean state, let's put something useful into the root crontab. Most people will want to run updatedb on a weekly basis to make sure that mlocate works properly. To add that to the system's crontab, first edit crons.cron again so that it looks like the following:

代码 一个真正的 crontab

22 2 * * 1    /usr/bin/updatedb

That would make cron run updatedb at 2:22 A.M. on Monday morning every week. Now input the crontab with the proper new command from the table above, and check the list again.

root #

crontab crons.cron

root #crontab -l

Now let's say emerge --sync should be ran on a daily schedule in order to keep the Portage tree up to date. This could be done by first editing crons.cron and then using crontab crons.cron as was done in the example above, or by using the proper edit command from the table above. This provides a way to edit the user's crontab in situ, without depending on external files like crons.cron.

root #crontab -e

The above command should open the user's crontab with an editor. For example, if emerge --sync is to be run every day at 6:30 A.M., make the crontab look something like this:

代码 A real crontab

22 2 * * 1    /usr/bin/updatedb
30 6 * * *    /usr/bin/emerge --sync
## (if using anacron, add this line)
30 7 * * *    /usr/sbin/anacron -s

Again, check the cron-jobs list as done in the previous examples to make sure the jobs are scheduled. If they are all there, then the system is ready to rock and roll.

使用 cronbase

As mentioned earlier, all of the available cron packages depend on sys-process/cronbase. The cronbase package creates /etc/cron.{hourly,daily,weekly,monthly}, and a script called run-crons. Notice the default /etc/crontab file contains something like this:

代码 Default system crontab

*/15 * * * *     test -x /usr/sbin/run-crons && /usr/sbin/run-crons
0  *  * * *      rm -f /var/spool/cron/lastrun/cron.hourly
0  3  * * *      rm -f /var/spool/cron/lastrun/cron.daily
15 4  * * 6      rm -f /var/spool/cron/lastrun/cron.weekly
30 5  1 * *      rm -f /var/spool/cron/lastrun/cron.monthly

To avoid going into much detail, assume these commands will effectively run hourly, daily, weekly and monthly scripts. This method of scheduling cron-jobs has some important advantages:

They will run even if the computer was off when they were scheduled to run;
It is easy for package maintainers to place scripts in those well defined places;
The administrators know exactly where the cron-jobs and crontab are stored, making it easy to backup and restore these parts of their systems.

附注
Again, it is useful to point out that cronie and bcron automatically read /etc/crontab, while dcron and fcron do not. Please read the System crontab section to learn more about this.

使用 anacron

As mentioned earlier, anacron is used on systems not meant to be run continuously (like most of the desktop installations). Its default configuration file, /etc/anacrontab, is usually similar to the following:

文件 /etc/anacrontab

SHELL=/bin/sh
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
# format: period delay job-identifier command
1       5       cron.daily      run-parts /etc/cron.daily
7       10      cron.weekly     run-parts /etc/cron.weekly
30      15      cron.monthly    run-parts /etc/cron.monthly

The main difference between this and other common crontabs is that with anacron there is no fixed date/hour for the job scheduling, but only the period between every run. When anacron is started, it will check the contents of a set of files in /var/spool/anacron and calculate if the corresponding entry in the configuration file has expired since the last run. If it has, then the command is invoked again.

As a final note, it is important to comment out any overlapping entry in any other cron installed in the system, such as in the following vixie-cron crontab example:

文件 /etc/crontab

# for cronie
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
# Global variables
SHELL=/bin/bash
PATH=/sbin:/bin:/usr/sbin:/usr/bin
MAILTO=root
HOME=/
  
# check scripts in cron.hourly, cron.daily, cron.weekly, and cron.monthly
59  *  * * *    root    rm -f /var/spool/cron/lastrun/cron.hourly
#9  3  * * *    root    rm -f /var/spool/cron/lastrun/cron.daily
#19 4  * * 6    root    rm -f /var/spool/cron/lastrun/cron.weekly
#29 5  1 * *    root    rm -f /var/spool/cron/lastrun/cron.monthly
#*/10  *  * * * root    test -x /usr/sbin/run-crons && /usr/sbin/run-crons
@hourly         root    test ! -e /var/spool/cron/lastrun/cron.hourly && touch /var/spool/cron/lastrun/cron.hourly && run-parts --report /etc/cron.hourly

Without doing this, the daily, weekly, and monthly parts will be executed - at different times - by both the cron daemon and anacron, leading to possible double job executions.

故障排除

当让 cron 正常工作遇到问题时，这个快速检查清单可能会有所帮助。

Remember, each cron package is different and the range of features varies greatly. Be sure to consult the man pages for crontab, fcrontab, or anacrontab, depending on which cron daemon has been activated!

cron 正在运行？

To verify that cron is running, see if it shows up in the process list:

root #ps ax | grep cron

'/var/spool/cron/crontabs' is not a directory

Ensure that the user is in the "cron" group. Remember to log out and log; in order for the group changes to take effect. If that did not work, ensure that the username is in /etc/cron.allow. And if that didn't work, set crontab to be suid root.

root #chmod u+s /usr/bin/crontab

cron 是否工作？

请尝试以下操作：

代码 crontab 查看 cron 是否正在运行

* * * * * /bin/echo "foobar" >> /file_you_own

然后定期检查 /file_you_own 是否被修改。

命令是否有效？

和以前一样，但也可能重定向标准错误输出：

代码 crontab 验证应用程序运行

* * * * * /bin/echo "foobar" >> /file_you_own 2>&1

cron 可以运行作业吗？

检查 cron 日志，通常是 /var/log/cron.log 或 /var/log/messages 是否有错误。

有没有 dead.letter？

cron usually sends mail when there is a problem; check for mail and look for the creation of a ~/dead.letter file.

为什么cron 邮件没有发出？

In order to receive mails from cron, a valid MTA setup must be implemented. This is provided by any package from virtual/mta.

If the cron mails are only to be sent locally, and not through a fully configured mail server, the system can use mbox (/var/spool/mail) mails, by enabling the mbox useflag with the respective package which provides the MTA.

External resources

https://crontab.guru/

This page is based on a document formerly found on our main website gentoo.org.
The following people contributed to the original document: Eric Brown, Xavier Neys,
They are listed here because wiki history does not allow for any external attribution. If you edit the wiki article, please do not add yourself here; your contributions are recorded on each article's associated history page.