xref: /freebsd/libexec/atrun/atrun.man (revision 952d112864d8008aa87278a30a539d888a8493cd)
1.\" $Id$
2.Dd April 12, 1995
3.Dt ATRUN 8
4.Os "FreeBSD 2.1"
5.Sh NAME
6.Nm atrun
7.Nd run jobs queued for later execution
8.Sh SYNOPSIS
9.Nm atrun
10.Op Fl l Ar load_avg
11.Op Fl d
12.Sh DESCRIPTION
13.Nm Atrun
14runs jobs queued by
15.Xr at 1 .
16Root's
17.Xr crontab 5
18file
19.Pa /etc/crontab
20has to contain the line
21.nf
22*/5     *       *       *       *       root    _ATLIB_DIR/atrun
23.fi
24so
25.Xr atrun 8
26gets called every five minutes.
27.Pp
28At every invocation, every job in lowercase queues whose starting time
29has passed is started.
30A maximum of one batch jobs (denoted by uppercase queues) are started
31each time
32.Nm atrun
33is invoked.
34.Sh OPTIONS
35.Bl -tag -width indent
36.It Fl l Ar load_avg
37Specifies a limiting load factor, over which batch jobs should
38not be run, instead of the compiled \- in value of _LOADAVG_MX.
39.It Fl d
40Debug; print error messages to standard error instead of using
41.Xr syslog 3 .
42.El
43.Sh WARNINGS
44For
45.Nm atrun
46to work, you have to start up a
47.Xr cron 8
48daemon.
49.Sh FILES
50.Bl -tag -width _ATSPOOL_DIR -compact
51.It Pa _ATSPOOL_DIR
52Directory containing output spool files
53.It Pa _ATJOB_DIR
54Directory containing job files
55.El
56.Sh SEE ALSO
57.Xr cron 8 ,
58.Xr crontab 1 ,
59.Xr crontab 5 ,
60.Xr at 1 ,
61.Xr syslog 3 .
62.Sh BUGS
63The functionality of
64.Nm atrun
65should be merged into
66.Xr cron 8 .
67