xref: /freebsd/libexec/atrun/atrun.man (revision 6e8394b8baa7d5d9153ab90de6824bcd19b3b4e1)
1.\" $Id: atrun.man,v 1.5 1998/07/01 05:47:58 jkoshy Exp $
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 .
16.Pp
17Root's
18.Xr crontab 5
19file
20.Pa /etc/crontab
21has to contain the line
22.nf
23*/5     *       *       *       *       root    /usr/libexec/atrun
24.fi
25so that
26.Xr atrun 8
27gets invoked every five minutes.
28.Pp
29At every invocation,
30.Nm
31will start all the jobs in the lowercase queues whose start
32time has elapsed.
33In addition, if the load average over the last minute was less than
34the specified limit then a maximum of one batch job (denoted by the
35uppercase queues) is started.
36.Sh OPTIONS
37.Bl -tag -width indent
38.It Fl l Ar load_avg
39Specify a limiting load factor, over which batch jobs should
40not be run, instead of the compiled in default of 1.5.
41.It Fl d
42Debug; print error messages to standard error instead of using
43.Xr syslog 3 .
44.El
45.Sh WARNINGS
46For
47.Nm
48to work, you have to start up a
49.Xr cron 8
50daemon.
51.Sh FILES
52.Bl -tag -width /var/at/spool -compact
53.It Pa /var/at/spool
54Directory containing output spool files
55.It Pa /var/at/jobs
56Directory containing job files
57.El
58.Sh SEE ALSO
59.Xr at 1 ,
60.Xr crontab 1 ,
61.Xr syslog 3 ,
62.Xr crontab 5 ,
63.Xr cron 8
64.Sh BUGS
65The functionality of
66.Nm
67should be merged into
68.Xr cron 8 .
69