xref: /original-bsd/usr.sbin/cron/cron.8 (revision c3e32dec)
Copyright (c) 1986, 1993
The Regents of the University of California. All rights reserved.

%sccs.include.proprietary.roff%

@(#)cron.8 8.1 (Berkeley) 06/06/93

CRON 8 ""
.AT 3
NAME
cron - clock daemon
SYNOPSIS
cron
DESCRIPTION
Cron executes commands at specified dates and times according to the instructions in the files /etc/crontab and /etc/crontab.local. None, either one, or both of these files may be present. Since cron never exits, it should only be executed once. This is best done by running cron from the initialization process through the file /etc/rc; see init (8).

The crontab files consist of lines of seven fields each. The fields are separated by spaces or tabs. The first five are integer patterns to specify:

2m minute (0-59) .nr .0 \n()Pu .nr )P 0

2m hour (0-23)

2m day of the month (1-31)

2m month of the year (1-12)

2m day of the week (1-7 with 1 = Monday) .nr )P \n(.0u

Each of these patterns may contain:

2m a number in the range above .nr .0 \n()Pu .nr )P 0

2m two numbers separated by a minus meaning a range inclusive

2m a list of numbers separated by commas meaning any of the numbers

2m an asterisk meaning all legal values .nr )P \n(.0u

The sixth field is a user name: the command will be run with that user's uid and permissions. The seventh field consists of all the text on a line following the sixth field, including spaces and tabs; this text is treated as a command which is executed by the Shell at the specified times. A percent character (``%'') in this field is translated to a new-line character.

Both crontab files are checked by cron every minute, on the minute.

FILES
/etc/crontab

/etc/crontab.local