xref: /netbsd-src/libexec/atrun/atrun.8 (revision 6cb10275d08f045e872662c371fe2f2724f2f6e6)
1.\" $NetBSD: atrun.8,v 1.14 2014/03/18 18:20:38 riastradh 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
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.Bd -literal
22*/10	*	*	*	*	/usr/libexec/atrun
23.Ed
24.Pp
25so that
26.Nm
27gets called every ten minutes.
28.Pp
29At every invocation, every job in lowercase queues whose starting time
30has passed is started.
31A maximum of one batch job (denoted by uppercase queues) is started
32each time
33.Nm
34is invoked.
35.Sh OPTIONS
36.Bl -tag -width indent
37.It Fl l Ar load_avg
38Specifies a limiting load factor, over which batch jobs should
39not be run, instead of the compiled-in value of 1.5.
40.It Fl d
41Debug; print error messages to standard error instead of using
42.Xr syslog 3 .
43.El
44.Sh WARNINGS
45For
46.Nm
47to work, a
48.Xr cron 8
49daemon needs to be running.
50.Sh FILES
51.Bl -tag -width /var/at/spool -compact
52.It Pa /var/at/spool
53Directory containing output spool files
54.It Pa /var/at/jobs
55Directory containing job files
56.El
57.Sh SEE ALSO
58.Xr at 1 ,
59.Xr crontab 1 ,
60.Xr syslog 3 ,
61.Xr crontab 5 ,
62.Xr cron 8
63.Sh AUTHORS
64.An Thomas Koenig Aq Mt ig25@rz.uni-karlsruhe.de
65.Sh BUGS
66The functionality of
67.Nm
68should be merged into
69.Xr cron 8 .
70