diff options
Diffstat (limited to 'usr.sbin/cron/crontab.5')
| -rw-r--r-- | usr.sbin/cron/crontab.5 | 54 |
1 files changed, 33 insertions, 21 deletions
diff --git a/usr.sbin/cron/crontab.5 b/usr.sbin/cron/crontab.5 index 29081f6ec5f..fdfa54990e3 100644 --- a/usr.sbin/cron/crontab.5 +++ b/usr.sbin/cron/crontab.5 @@ -15,7 +15,7 @@ .\" * Paul Vixie <paul@vix.com> uunet!decwrl!vixie!paul .\" */ .\" -.\" $Id: crontab.5,v 1.9 2000/01/10 08:19:18 deraadt Exp $ +.\" $Id: crontab.5,v 1.10 2000/03/19 17:57:03 aaron Exp $ .\" .Dd June 8, 1999 .Dt CRONTAB 5 @@ -63,14 +63,15 @@ Creation, modification, and removal of a should be done using .Xr crontab 1 . .Pp -Blank lines, leading spaces, and tabs are ignored. Lines whose first -non-space character is a pound sign +Blank lines, leading spaces, and tabs are ignored. +Lines whose first non-space character is a pound sign .Pq Ql # are comments, and are ignored. Note that comments are not allowed on the same line as .Xr cron 8 commands, since -they will be taken to be part of the command. Similarly, comments are not +they will be taken to be part of the command. +Similarly, comments are not allowed on the same line as environment variable settings. .Pp An active line in a @@ -84,7 +85,8 @@ command. Environment variable settings create the environment any command in the .Nm -is run in. An environment variable setting is of the form: +is run in. +An environment variable setting is of the form: .Pp .Dl name \&= value .Pp @@ -151,12 +153,14 @@ commands in If .Ev MAILTO is defined (and non-empty), -mail is sent to the user so named. If +mail is sent to the user so named. +If .Ev MAILTO is defined but empty .Pq Ev MAILTO \&= Sq , no -mail will be sent. Otherwise mail is sent to the owner of the +mail will be sent. +Otherwise mail is sent to the owner of the .Nm crontab . This option is useful if you decide on .Pa /bin/mail @@ -176,7 +180,8 @@ usually doesn't read its mail. The format of a .Xr cron 8 command is very much the V7 standard, with a number of -upward-compatible extensions. Lines in the system +upward-compatible extensions. +Lines in the system .Nm have six fields in the form: .Bd -ragged -offset indent @@ -204,7 +209,7 @@ have five fields in the form: Fields are separated by blanks or tabs. The allowed values for the fields are: .Pp -.Bl -tag -width "day-of-month" -compact -offset indent +.Bl -tag -width "day-of-month" -compact -offset indent .It field allowed values .It ----- @@ -225,25 +230,29 @@ a valid username text .El .Pp -Lists are allowed. A list is a set of numbers (or ranges) -separated by commas. Examples: +Lists are allowed. +A list is a set of numbers (or ranges) separated by commas. +Examples: .Sm off .Dq 1 , 2 , 5 , 9 , .Dq 0\&-4 , 8\&-12 . .Sm on .Pp -Ranges of numbers are allowed. Ranges are two numbers separated -with a hyphen. The specified range is inclusive. For example, +Ranges of numbers are allowed. +Ranges are two numbers separated with a hyphen. +The specified range is inclusive. +For example, 8\-11 for an .Fa hour entry specifies execution at hours 8, 9, 10 and 11. .Pp -Step values can be used in conjunction with ranges. Following -a range with +Step values can be used in conjunction with ranges. +Following a range with .No \&/ Ns Ar number specifies skips of .Fa number -through the range. For example, +through the range. +For example, .Dq 0-23/2 can be used in the .Fa hour @@ -263,9 +272,10 @@ Names can be used in the .Fa month and .Fa day\&-of\&-week -fields. Use the first three letters of the particular -day or month (case doesn't matter). Ranges or -lists of names are not allowed. +fields. +Use the first three letters of the particular +day or month (case doesn't matter). +Ranges or lists of names are not allowed. .Pp The .Fa command @@ -315,7 +325,8 @@ and If both fields are restricted (i.e., aren't *), the command will be run when .Em either -field matches the current time. For example, +field matches the current time. +For example, .Pp .Dl 30 4 1\&,15 \&* 5 .Pp @@ -393,7 +404,8 @@ is the same as .Pp Months or days of the week can be specified by name. .Pp -Environment variables can be set in the crontab. In BSD or ATT, the +Environment variables can be set in the crontab. +In BSD or ATT, the environment handed to child processes is basically the one from /etc/rc. .Pp Command output is mailed to the crontab owner (BSD can't do this), can be |