BSD 4_4 release

[unix-history] / usr / src / usr.sbin / cron / cron.8

diff --git a/usr/src/usr.sbin/cron/cron.8 b/usr/src/usr.sbin/cron/cron.8
index d124313..009e46e 100644 (file)
--- a/usr/src/usr.sbin/cron/cron.8
+++ b/usr/src/usr.sbin/cron/cron.8
@@ -1,16 +1,24 @@
-.\"    @(#)cron.8      6.1 (Berkeley) %G%
+.\" Copyright (c) 1986, 1993
+.\"    The Regents of the University of California.  All rights reserved.

 .\"
 .\"

-.TH CRON 8 ""
+.\" This module is believed to contain source code proprietary to AT&T.
+.\" Use and redistribution is subject to the Berkeley Software License
+.\" Agreement and your Software Agreement with AT&T (Western Electric).
+.\"
+.\"    @(#)cron.8      8.1 (Berkeley) 6/6/93
+.\"
+.TH CRON 8 "June 6, 1993"

 .AT 3
 .SH NAME
 cron \- clock daemon
 .SH SYNOPSIS
 .AT 3
 .SH NAME
 cron \- clock daemon
 .SH SYNOPSIS

-.B /etc/cron
+.B cron

 .SH DESCRIPTION
 .I Cron
 executes commands at specified dates and times
 .SH DESCRIPTION
 .I Cron
 executes commands at specified dates and times

-according to the instructions in the file
-/usr/lib/crontab.
+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
 .I cron
 never exits,
 Since
 .I cron
 never exits,


@@ -23,37 +31,70 @@ process through the file
 see
 .IR init (8).
 .PP
 see
 .IR init (8).
 .PP

-Crontab
-consists of lines of six fields each.
+The
+crontab files
+consist of lines of seven fields each.

 The fields are separated by spaces or tabs.
 The fields are separated by spaces or tabs.

-The first five are integer patterns to
-specify the
-minute (0-59),
-hour (0-23),
-day of the month (1-31),
-month of the year (1-12),
-and day of the week (1-7 with 1=Monday).
-Each of these patterns may
-contain a number in the range above;
-two numbers separated by
-a minus
-meaning a range inclusive;
+The first five are integer patterns to specify:
+.in +2m
+.TP 2m
+\(bu
+minute (0-59)
+.nr .0 \n()Pu
+.nr )P 0
+.TP 2m
+\(bu
+hour (0-23)
+.TP 2m
+\(bu
+day of the month (1-31)
+.TP 2m
+\(bu
+month of the year (1-12)
+.TP 2m
+\(bu
+day of the week (1-7 with 1 = Monday)
+.nr )P \n(.0u
+.in -2m
+.LP
+Each of these patterns may contain:
+.in +2m
+.TP 2m
+\(bu
+a number in the range above
+.nr .0 \n()Pu
+.nr )P 0
+.TP 2m
+\(bu
+two numbers separated by a minus
+meaning a range inclusive
+.TP 2m
+\(bu

 a list of numbers separated by
 a list of numbers separated by

-commas meaning any of the numbers;
-or an asterisk meaning all legal values.
-The sixth field is a string
-that is executed by the Shell at the
+commas meaning any of the numbers
+.TP 2m
+\(bu
+an asterisk meaning all legal values
+.nr )P \n(.0u
+.in -2m
+.LP
+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.
 specified times.

-A percent character
+A percent character (``%'')

 in this field is translated to a new-line
 character.
 in this field is translated to a new-line
 character.

-Only the first line (up to a % or end of line)
-of the command field is executed by the Shell.
-The other lines are made available to the
-command as standard input.

 .PP
 .PP

-Crontab is examined by
+Both
+crontab files are checked by

 .I cron
 .I cron

-every minute.
+every minute, on the minute.

 .SH FILES
 .SH FILES

-/usr/lib/crontab
+/etc/crontab
+.br
+/etc/crontab.local