1.Dd June 22, 2015 2.Dt ATRUN 8 3.Os 4.Sh NAME 5.Nm atrun 6.Nd run jobs queued for later execution 7.Sh SYNOPSIS 8.Nm atrun 9.Op Fl l Ar load_avg 10.Op Fl d 11.Sh DESCRIPTION 12.Nm Atrun 13runs jobs queued by 14.Xr at 1 . 15.Pp 16The system 17.Xr crontab 5 18file 19.Pa /etc/crontab 20must contain the line 21.Bd -literal 22*/5 * * * * root /usr/libexec/atrun 23.Ed 24.Pp 25so 26.Nm 27is invoked every five minutes. 28.Pp 29At every invocation, 30.Nm 31starts 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.Pp 37Before starting a job, 38.Nm 39checks the status of its owner's account with 40.Xr pam 3 41and refuses to run the job if the account is unavailable, 42e.g., locked out or expired. 43.Sh OPTIONS 44.Bl -tag -width indent 45.It Fl l Ar load_avg 46Specify a limiting load factor, over which batch jobs should 47not be run, instead of the default of 1.5 * number of active CPUs. 48.It Fl d 49Debug; print error messages to standard error instead of using 50.Xr syslog 3 . 51.El 52.Sh WARNINGS 53For 54.Nm 55to work, a 56.Xr cron 8 57daemon must be running 58.Nm 59periodically. 60.Sh FILES 61.Bl -tag -width /etc/pam.d/atrun -compact 62.It Pa /etc/pam.d/atrun 63.Xr pam.conf 5 64configuration file for 65.Nm 66.It Pa /var/at/jobs 67Directory containing job files 68.It Pa /var/at/spool 69Directory containing output spool files 70.El 71.Sh SEE ALSO 72.Xr at 1 , 73.Xr crontab 1 , 74.Xr pam 3 , 75.Xr syslog 3 , 76.Xr crontab 5 , 77.Xr pam.conf 5 , 78.Xr cron 8 79.Sh BUGS 80The functionality of 81.Nm 82should be merged into 83.Xr cron 8 . 84