Call /etc/crontab the "system crontab", not "root's crontab". While

here, fix some other wording issues

PR:		201048
Submitted by:	teksimian@gmail.com
MFC after:	1 week
This commit is contained in:
Warren Block 2015-06-22 20:24:59 +00:00
parent cc2520d2f3
commit d33daab934
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=284709

View File

@ -1,5 +1,5 @@
.\" $FreeBSD$ .\" $FreeBSD$
.Dd October 30, 2012 .Dd June 22, 2015
.Dt ATRUN 8 .Dt ATRUN 8
.Os .Os
.Sh NAME .Sh NAME
@ -14,32 +14,32 @@
runs jobs queued by runs jobs queued by
.Xr at 1 . .Xr at 1 .
.Pp .Pp
Root's The system
.Xr crontab 5 .Xr crontab 5
file file
.Pa /etc/crontab .Pa /etc/crontab
has to contain the line must contain the line
.Bd -literal .Bd -literal
*/5 * * * * root /usr/libexec/atrun */5 * * * * root /usr/libexec/atrun
.Ed .Ed
.Pp .Pp
so that so
.Nm .Nm
gets invoked every five minutes. is invoked every five minutes.
.Pp .Pp
At every invocation, At every invocation,
.Nm .Nm
will start all the jobs in the lowercase queues whose start starts all the jobs in the lowercase queues whose start
time has elapsed. time has elapsed.
In addition, if the load average over the last minute was less than 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 the specified limit, then a maximum of one batch job (denoted by the
uppercase queues) is started. uppercase queues) is started.
.Pp .Pp
Before starting a job, Before starting a job,
.Nm .Nm
will check the status of its owner's account with checks the status of its owner's account with
.Xr pam 3 .Xr pam 3
and refuse to run the job if the account is unavailable, and refuses to run the job if the account is unavailable,
e.g., locked out or expired. e.g., locked out or expired.
.Sh OPTIONS .Sh OPTIONS
.Bl -tag -width indent .Bl -tag -width indent
@ -53,9 +53,11 @@ Debug; print error messages to standard error instead of using
.Sh WARNINGS .Sh WARNINGS
For For
.Nm .Nm
to work, you have to start up a to work, a
.Xr cron 8 .Xr cron 8
daemon. daemon must be running
.Nm
periodically.
.Sh FILES .Sh FILES
.Bl -tag -width /etc/pam.d/atrun -compact .Bl -tag -width /etc/pam.d/atrun -compact
.It Pa /etc/pam.d/atrun .It Pa /etc/pam.d/atrun