99 lines
3.5 KiB
Groff
99 lines
3.5 KiB
Groff
|
.TH ANACRONTAB 5 2009-08-17 "Marcela Mašláňová" "Anacron Users' Manual"
|
||
|
.SH NAME
|
||
|
/etc/anacrontab \- configuration file for Anacron
|
||
|
.SH DESCRIPTION
|
||
|
The
|
||
|
.I /etc/anacrontab
|
||
|
configuration file describes the jobs controlled by \fBanacron(8)\fR. It can contain three types of lines:
|
||
|
job-description lines, environment assignments, or empty lines.
|
||
|
.PP
|
||
|
Job-description lines can have the following format:
|
||
|
.PP
|
||
|
period in days delay in minutes job-identifier command
|
||
|
.PP
|
||
|
The
|
||
|
.I period in days
|
||
|
variable specifies the frequency of execution of a job in days. This variable can be represented by an integer or a macro (@daily, @weekly, @monthly), where @daily denotes the same value as the integer 1, @weekly the same as 7, and @monthly specifies that the job is run once a month, independent on the length of the month.
|
||
|
.PP
|
||
|
The
|
||
|
.I delay in minutes
|
||
|
variable specifies the number of minutes anacron waits, if necessary, before executing a job. This variable is represented by an integer where 0 means no delay.
|
||
|
.PP
|
||
|
The
|
||
|
.I job-identifier
|
||
|
variable specifies a unique name of a job which is used in the log files.
|
||
|
.PP
|
||
|
The
|
||
|
.I command
|
||
|
variable specifies the command to execute. The command can either be a command such as \fBls /proc >> /tmp/proc\fR or a command to execute a custom script.
|
||
|
.PP
|
||
|
Environment assignment lines can have the following format:
|
||
|
.PP
|
||
|
VAR=VALUE
|
||
|
.PP
|
||
|
Any spaces around
|
||
|
.I VAR
|
||
|
are removed. No spaces around
|
||
|
.I VALUE
|
||
|
are allowed (unless you want them to be part of the value). The specified assignment
|
||
|
takes effect from the next line until the end of the file, or to the next
|
||
|
assignment of the same variable.
|
||
|
.PP
|
||
|
The
|
||
|
.I START_HOURS_RANGE
|
||
|
variable defines an interval (in hours) when scheduled jobs can be run. In case this time interval is missed, for example, due to a power down, then scheduled jobs are not executed that day.
|
||
|
.PP
|
||
|
The
|
||
|
.I RANDOM_DELAY
|
||
|
variable denotes the maximum number of minutes that will be added to the delay in minutes variable which is specified for each job. A
|
||
|
.I RANDOM_DELAY
|
||
|
set to 12 would therefore add, randomly, between 0 and 12 minutes to the delay in minutes for each job in that particular anacrontab. When set to 0, no random delay is added.
|
||
|
.PP
|
||
|
Empty lines are either blank lines, line containing white spaces only, or
|
||
|
lines with white spaces followed by a '#' followed by an arbitrary comment.
|
||
|
.PP
|
||
|
You can continue a line onto the next line by adding a '\\' at the end of it.
|
||
|
.PP
|
||
|
In case you want to disable Anacron, add the
|
||
|
.I 0anacron
|
||
|
cron job (which is a part of
|
||
|
.IR crontabs(4) )
|
||
|
into the
|
||
|
.I /etc/cron.hourly/jobs.deny
|
||
|
directory.
|
||
|
.SH EXAMPLE
|
||
|
This example shows how to set up an Anacron job similar in functionality to
|
||
|
.I /etc/crontab
|
||
|
which starts all regular jobs
|
||
|
between 6:00 and 8:00
|
||
|
.I only.
|
||
|
A
|
||
|
.I RANDOM_DELAY
|
||
|
which can be 30 minutes at the most is specified. Jobs will run serialized in a queue where each job is started only after the previous one is finished.
|
||
|
.nf
|
||
|
# environment variables
|
||
|
SHELL=/bin/sh
|
||
|
PATH=/sbin:/bin:/usr/sbin:/usr/bin
|
||
|
MAILTO=root
|
||
|
RANDOM_DELAY=30
|
||
|
# Anacron jobs will start between 6am and 8am.
|
||
|
START_HOURS_RANGE=6-8
|
||
|
# delay will be 5 minutes + RANDOM_DELAY for cron.daily
|
||
|
1 5 cron.daily nice run-parts /etc/cron.daily
|
||
|
7 0 cron.weekly nice run-parts /etc/cron.weekly
|
||
|
@monthly 0 cron.monthly nice run-parts /etc/cron.monthly
|
||
|
.fi
|
||
|
.SH "SEE ALSO"
|
||
|
.BR anacron (8),
|
||
|
.BR crontabs (4)
|
||
|
.PP
|
||
|
The Anacron
|
||
|
.I README
|
||
|
file.
|
||
|
.SH AUTHOR
|
||
|
Itai Tzur <itzur@actcom.co.il>
|
||
|
.PP
|
||
|
Currently maintained by Pascal Hakim <pasc@(debian.org|redellipse.net)>.
|
||
|
.PP
|
||
|
For Fedora, maintained by Marcela Mašláňová <mmaslano@redhat.com>.
|