source: trunk/minix/man/man8/cron.8@ 9

.TH CRON 8
.SH NAME
cron \- clock daemon
.SH SYNOPSIS
.B cron
.RB [ \-d\c
.RI [ level ]]
.SH DESCRIPTION
The
.B cron
daemon executes tasks that must be repeated every now and then (cron jobs),
and tasks that must be run just once (at jobs).  It is normally used to run
daily or weekly system maintenance scripts.  What it needs to run and when
is specified in a number of "cron tables", or crontab files for short.
These tables are:
.PP
.RS
.nf
.ft B
/usr/lib/crontab
/usr/local/lib/crontab
/var/lib/crontab
/var/opt/\fIname\fP/lib/crontab\ \ \fR(Minix-vmd only)\fB
/usr/spool/crontabs/\fIuser\fP
.ft R
.fi
.RE
.PP
These files follow the usual pattern:  One for the standard things, one for
local tasks per organization, one for tasks per system, and one crontab per
installed package.  (Cron reads
.B /usr/lib/packages
to find names of installed packages, it doesn't just grab everything in
.BR /var/opt .)
The last set of files fall outside the normal pattern, they are per user
crontabs that one can create with the
.BR crontab (1)
command.  The file names in
.B /usr/spool/crontabs/
are login names of the file owners.
.PP
The format of a crontab file is described in
.BR crontab (5).
.SS "AT jobs"
.B Cron
also takes care of the execution of jobs issued by
.BR at (1)
that are found in
.BR /usr/spool/at/ .
Cron simply runs the AT job as if there were an "sh at-job" as a cron job at
the appropriate time under the user-id of the owner of the script.  The
script takes care of the rest.  See
.BR at (1)
for the details.
.SS "Job I/O"
Standard input, output and error are the same as cron's if the job is
started by the system crontabs or from package crontabs.  This means that
output from system jobs usually ends up on the console and in the log file.
Output from personal cron jobs or at jobs are mailed to the owner of the
job.  No mail is sent if the job is silent.
.SH OPTIONS
.TP 5
[\fB\-d\fR[\fIlevel\fR]]
Set the debug level, by default 1.  Makes
.B cron
print info on what it happens to be doing.  Level 1 just tells about sleep
times and what job is executed, level 2 also shows the internal crontab
data on a table load.  (With time fields translated to match those of
.BR "struct tm" ,
see
.BR ctime (3).)
.SS SIGNALS
.B Cron
takes the following actions when sent one of the following signals:
.TP 12
.B SIGHUP
Reload the crontab tables if they changed since the last time they were
loaded, and reexamine the AT job spool.  Used by
.BR at (1)
and
.BR crontab (1).
.TP
.B SIGUSR1
Increase the debug level by 1.
.TP
.B SIGUSR2
Turn debugging off.
.SH ENVIRONMENT
.B Cron
sets the environment variables
.BR USER ,
.BR LOGNAME ,
.BR HOME ,
and
.BR SHELL
to the user's login name (2x), home directory, and shell if a job is
executed for a given user.  The working directory is set to the user's home
directory.  Everything else is inherited from
.BR cron ,
exactly as
.B cron
got it when it started.  Note that commands are always passed to
.BR /bin/sh ,
not to the user's shell.
.PP
System cron jobs are in principle executed with
.BR cron 's
environment, use
.B "\-u root"
or the crontab file
.B /usr/spool/crontabs/root
if you want to give root the same treatment as ordinary users.
.SH FILES
.TP 25n
.B /usr/lib/crontab
Main MINIX 3 crontab file.
.TP
.B /usr/local/lib/crontab
Local jobs for all systems in an organization.
.TP
.B /var/lib/crontab
System specific jobs.
.TP
.B /var/opt/\fIname\fP/lib/crontab
Per package jobs for Minix-vmd.
.TP
.B /usr/lib/packages
List of installed packages.
.TP
.B /usr/spool/crontabs/\fIuser\fP
Per user jobs.
.TP
.B /usr/spool/at/*
Jobs issued by
.BR at (1).
.TP
.B /usr/run/cron.pid
Process id of cron when cron is running.  Used by
.BR at (1)
and
.BR crontab (1)
to send cron a hangup signal.
.SH "SEE ALSO"
.BR at (1),
.BR crontab (1).
.SH NOTES
A job is not reissued until a previous instance of it has exited.  The next
time to execute is computed from the previous time it ran.  If job issuing
lags behind on the system time then the next time to run it is computed from
the current system time.
.SH BUGS
.B Cron
doesn't like it if the system time is changed.  If set forward then cron
will react when it next wakes up by running all jobs within the skipped time
once or twice before it catches up.  Setting the clock backwards makes cron
play dead until the system time passes the old time.  (Changing the system
time is bad idea anyway, and not just because of cron.)
.PP
Jobs that fall in the missing hour in a change to Daylight Saving Time are
skipped.  Nothing is done in the extra hour on the change out of DST.
.SH AUTHOR
Kees J. Bot (kjb@cs.vu.nl)

.\"
.\" $PchId: cron.8,v 1.3 2000/07/17 18:49:18 philip Exp $