1997-11-20 07:21:55 +00:00
|
|
|
.\" $Id: atrun.man,v 1.3 1997/02/22 14:20:55 peter Exp $
|
1995-04-12 02:52:21 +00:00
|
|
|
.Dd April 12, 1995
|
|
|
|
.Dt ATRUN 8
|
|
|
|
.Os "FreeBSD 2.1"
|
|
|
|
.Sh NAME
|
|
|
|
.Nm atrun
|
|
|
|
.Nd run jobs queued for later execution
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Nm atrun
|
|
|
|
.Op Fl l Ar load_avg
|
|
|
|
.Op Fl d
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
.Nm Atrun
|
|
|
|
runs jobs queued by
|
|
|
|
.Xr at 1 .
|
|
|
|
Root's
|
|
|
|
.Xr crontab 5
|
|
|
|
file
|
|
|
|
.Pa /etc/crontab
|
|
|
|
has to contain the line
|
|
|
|
.nf
|
|
|
|
*/5 * * * * root _ATLIB_DIR/atrun
|
|
|
|
.fi
|
|
|
|
so
|
|
|
|
.Xr atrun 8
|
|
|
|
gets called every five minutes.
|
|
|
|
.Pp
|
|
|
|
At every invocation, every job in lowercase queues whose starting time
|
|
|
|
has passed is started.
|
|
|
|
A maximum of one batch jobs (denoted by uppercase queues) are started
|
|
|
|
each time
|
1997-11-20 07:21:55 +00:00
|
|
|
.Nm
|
1995-04-12 02:52:21 +00:00
|
|
|
is invoked.
|
|
|
|
.Sh OPTIONS
|
|
|
|
.Bl -tag -width indent
|
|
|
|
.It Fl l Ar load_avg
|
1997-11-20 07:21:55 +00:00
|
|
|
Specify a limiting load factor, over which batch jobs should
|
1995-04-12 02:52:21 +00:00
|
|
|
not be run, instead of the compiled \- in value of _LOADAVG_MX.
|
|
|
|
.It Fl d
|
|
|
|
Debug; print error messages to standard error instead of using
|
|
|
|
.Xr syslog 3 .
|
|
|
|
.El
|
|
|
|
.Sh WARNINGS
|
|
|
|
For
|
1997-11-20 07:21:55 +00:00
|
|
|
.Nm
|
1995-04-12 02:52:21 +00:00
|
|
|
to work, you have to start up a
|
|
|
|
.Xr cron 8
|
|
|
|
daemon.
|
|
|
|
.Sh FILES
|
|
|
|
.Bl -tag -width _ATSPOOL_DIR -compact
|
|
|
|
.It Pa _ATSPOOL_DIR
|
|
|
|
Directory containing output spool files
|
|
|
|
.It Pa _ATJOB_DIR
|
|
|
|
Directory containing job files
|
|
|
|
.El
|
|
|
|
.Sh SEE ALSO
|
1997-11-20 07:21:55 +00:00
|
|
|
.Xr at 1 ,
|
1995-04-12 02:52:21 +00:00
|
|
|
.Xr crontab 1 ,
|
1997-11-20 07:21:55 +00:00
|
|
|
.Xr syslog 3 ,
|
1995-04-12 02:52:21 +00:00
|
|
|
.Xr crontab 5 ,
|
1997-11-20 07:21:55 +00:00
|
|
|
.Xr cron 8
|
1995-04-12 02:52:21 +00:00
|
|
|
.Sh BUGS
|
|
|
|
The functionality of
|
1997-11-20 07:21:55 +00:00
|
|
|
.Nm
|
1995-04-12 02:52:21 +00:00
|
|
|
should be merged into
|
|
|
|
.Xr cron 8 .
|