xref: /netbsd-src/libexec/atrun/atrun.8 (revision 3b01aba77a7a698587faaae455bbfe740923c1f5)
1.\" $NetBSD: atrun.8,v 1.10 2000/11/07 06:43:25 lukem Exp $
2.\" $OpenBSD: atrun.8,v 1.4 1998/05/22 22:16:29 deraadt Exp $
3.\" $FreeBSD: atrun.man,v 1.3 1997/02/22 14:20:55 peter Exp $
4.Dd April 12, 1995
5.Dt ATRUN 8
6.Os
7.Sh NAME
8.Nm atrun
9.Nd run jobs queued for later execution
10.Sh SYNOPSIS
11.Nm atrun
12.Op Fl l Ar load_avg
13.Op Fl d
14.Sh DESCRIPTION
15.Nm
16runs jobs queued by
17.Xr at 1 .
18Root's
19.Xr crontab 5
20must contain the line:
21.nf
22
23*/10     *       *       *       *       root    /usr/libexec/atrun
24
25.fi
26so that
27.Xr atrun 8
28gets called every ten minutes.
29.Pp
30At every invocation, every job in lowercase queues whose starting time
31has passed is started.
32A maximum of one batch job (denoted by uppercase queues) is started
33each time
34.Nm
35is invoked.
36.Sh OPTIONS
37.Bl -tag -width indent
38.It Fl l Ar load_avg
39Specifies a limiting load factor, over which batch jobs should
40not be run, instead of the compiled-in value 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 cron 8 ,
60.Xr crontab 1 ,
61.Xr crontab 5 ,
62.Xr at 1 ,
63.Xr syslog 3
64.Sh BUGS
65The functionality of
66.Nm
67should be merged into
68.Xr cron 8 .
69.Sh AUTHOR
70Thomas Koenig <ig25@rz.uni-karlsruhe.de>.
71