freebsd-nq/libexec/atrun/atrun.man

.\" $FreeBSD$
.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 .
.Pp
Root's
.Xr crontab 5
file
.Pa /etc/crontab
has to contain the line
.nf
*/5     *       *       *       *       root    /usr/libexec/atrun
.fi
so that
.Xr atrun 8
gets invoked every five minutes.
.Pp
At every invocation, 
.Nm
will start all the jobs in the lowercase queues whose start
time has elapsed.
In addition, if the load average over the last minute was less than 
the specified limit then a maximum of one batch job (denoted by the 
uppercase queues) is started.
.Sh OPTIONS
.Bl -tag -width indent
.It Fl l Ar load_avg
Specify a limiting load factor, over which batch jobs should
not be run, instead of the compiled in default of 1.5.
.It Fl d
Debug; print error messages to standard error instead of using
.Xr syslog 3 .
.El
.Sh WARNINGS
For
.Nm
to work, you have to start up a
.Xr cron 8
daemon.
.Sh FILES
.Bl -tag -width /var/at/spool -compact
.It Pa /var/at/spool
Directory containing output spool files
.It Pa /var/at/jobs
Directory containing job files
.El
.Sh SEE ALSO
.Xr at 1 ,
.Xr crontab 1 ,
.Xr syslog 3 ,
.Xr crontab 5 ,
.Xr cron 8
.Sh BUGS
The functionality of 
.Nm
should be merged into
.Xr cron 8 .
$Id$ -> $FreeBSD$ 1999-08-28 00:22:10 +00:00			`.\" $FreeBSD$`
Upgrade. Close security holes reported. 1995-04-12 02:52:21 +00:00			`.Dd April 12, 1995`
			`.Dt ATRUN 8`
Clean up some .Os macro uses: quotes are not needed, multiple arguments don't really work if the first one isn't "FreeBSD", and "FreeBSD-Experimental" isn't an OS name. 1999-02-15 08:34:14 +00:00			`.Os FreeBSD 2.1`
Upgrade. Close security holes reported. 1995-04-12 02:52:21 +00:00			`.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 .`
Clean up grammar. Provide proper pathnames for spool directories. Document dependency on current load average for starting new batch jobs. PR: 7109 1998-07-01 05:47:58 +00:00			`.Pp`
Upgrade. Close security holes reported. 1995-04-12 02:52:21 +00:00			`Root's`
			`.Xr crontab 5`
			`file`
			`.Pa /etc/crontab`
			`has to contain the line`
			`.nf`
Clean up grammar. Provide proper pathnames for spool directories. Document dependency on current load average for starting new batch jobs. PR: 7109 1998-07-01 05:47:58 +00:00			`/5 * * * root /usr/libexec/atrun`
Upgrade. Close security holes reported. 1995-04-12 02:52:21 +00:00			`.fi`
Clean up grammar. Provide proper pathnames for spool directories. Document dependency on current load average for starting new batch jobs. PR: 7109 1998-07-01 05:47:58 +00:00			`so that`
Upgrade. Close security holes reported. 1995-04-12 02:52:21 +00:00			`.Xr atrun 8`
Clean up grammar. Provide proper pathnames for spool directories. Document dependency on current load average for starting new batch jobs. PR: 7109 1998-07-01 05:47:58 +00:00			`gets invoked every five minutes.`
Upgrade. Close security holes reported. 1995-04-12 02:52:21 +00:00			`.Pp`
Clean up grammar. Provide proper pathnames for spool directories. Document dependency on current load average for starting new batch jobs. PR: 7109 1998-07-01 05:47:58 +00:00			`At every invocation,`
Cosmetic in error strings. Sort Xrefs. Add usage (with syslog capability). 1997-11-20 07:21:55 +00:00			`.Nm`
Clean up grammar. Provide proper pathnames for spool directories. Document dependency on current load average for starting new batch jobs. PR: 7109 1998-07-01 05:47:58 +00:00			`will start all the jobs in the lowercase queues whose start`
			`time has elapsed.`
			`In addition, if the load average over the last minute was less than`
			`the specified limit then a maximum of one batch job (denoted by the`
			`uppercase queues) is started.`
Upgrade. Close security holes reported. 1995-04-12 02:52:21 +00:00			`.Sh OPTIONS`
			`.Bl -tag -width indent`
			`.It Fl l Ar load_avg`
Cosmetic in error strings. Sort Xrefs. Add usage (with syslog capability). 1997-11-20 07:21:55 +00:00			`Specify a limiting load factor, over which batch jobs should`
Clean up grammar. Provide proper pathnames for spool directories. Document dependency on current load average for starting new batch jobs. PR: 7109 1998-07-01 05:47:58 +00:00			`not be run, instead of the compiled in default of 1.5.`
Upgrade. Close security holes reported. 1995-04-12 02:52:21 +00:00			`.It Fl d`
			`Debug; print error messages to standard error instead of using`
			`.Xr syslog 3 .`
			`.El`
			`.Sh WARNINGS`
			`For`
Cosmetic in error strings. Sort Xrefs. Add usage (with syslog capability). 1997-11-20 07:21:55 +00:00			`.Nm`
Upgrade. Close security holes reported. 1995-04-12 02:52:21 +00:00			`to work, you have to start up a`
			`.Xr cron 8`
			`daemon.`
			`.Sh FILES`
Clean up grammar. Provide proper pathnames for spool directories. Document dependency on current load average for starting new batch jobs. PR: 7109 1998-07-01 05:47:58 +00:00			`.Bl -tag -width /var/at/spool -compact`
			`.It Pa /var/at/spool`
Upgrade. Close security holes reported. 1995-04-12 02:52:21 +00:00			`Directory containing output spool files`
Clean up grammar. Provide proper pathnames for spool directories. Document dependency on current load average for starting new batch jobs. PR: 7109 1998-07-01 05:47:58 +00:00			`.It Pa /var/at/jobs`
Upgrade. Close security holes reported. 1995-04-12 02:52:21 +00:00			`Directory containing job files`
			`.El`
			`.Sh SEE ALSO`
Cosmetic in error strings. Sort Xrefs. Add usage (with syslog capability). 1997-11-20 07:21:55 +00:00			`.Xr at 1 ,`
Upgrade. Close security holes reported. 1995-04-12 02:52:21 +00:00			`.Xr crontab 1 ,`
Cosmetic in error strings. Sort Xrefs. Add usage (with syslog capability). 1997-11-20 07:21:55 +00:00			`.Xr syslog 3 ,`
Upgrade. Close security holes reported. 1995-04-12 02:52:21 +00:00			`.Xr crontab 5 ,`
Cosmetic in error strings. Sort Xrefs. Add usage (with syslog capability). 1997-11-20 07:21:55 +00:00			`.Xr cron 8`
Upgrade. Close security holes reported. 1995-04-12 02:52:21 +00:00			`.Sh BUGS`
			`The functionality of`
Cosmetic in error strings. Sort Xrefs. Add usage (with syslog capability). 1997-11-20 07:21:55 +00:00			`.Nm`
Upgrade. Close security holes reported. 1995-04-12 02:52:21 +00:00			`should be merged into`
			`.Xr cron 8 .`