Sat Feb 26 17:02:47 2022 UTC ()
explain CRON_WITHIN better.


(christos)
diff -r1.10 -r1.11 src/external/bsd/cron/dist/crontab.5
cvs diff -r1.10 -r1.11 src/external/bsd/cron/dist/crontab.5 (expand / switch to unified diff)

--- src/external/bsd/cron/dist/crontab.5 2020/04/18 19:32:19 1.10
+++ src/external/bsd/cron/dist/crontab.5 2022/02/26 17:02:47 1.11
@@ -1,37 +1,37 @@ @@ -1,37 +1,37 @@
1.\" $NetBSD: crontab.5,v 1.10 2020/04/18 19:32:19 christos Exp $ 1.\" $NetBSD: crontab.5,v 1.11 2022/02/26 17:02:47 christos Exp $
2.\" 2.\"
3.\"/* Copyright 1988,1990,1993,1994 by Paul Vixie 3.\"/* Copyright 1988,1990,1993,1994 by Paul Vixie
4.\" * All rights reserved 4.\" * All rights reserved
5.\" */ 5.\" */
6.\" 6.\"
7.\" Copyright (c) 2004 by Internet Systems Consortium, Inc. ("ISC") 7.\" Copyright (c) 2004 by Internet Systems Consortium, Inc. ("ISC")
8.\" Copyright (c) 1997,2000 by Internet Software Consortium, Inc. 8.\" Copyright (c) 1997,2000 by Internet Software Consortium, Inc.
9.\" 9.\"
10.\" Permission to use, copy, modify, and distribute this software for any 10.\" Permission to use, copy, modify, and distribute this software for any
11.\" purpose with or without fee is hereby granted, provided that the above 11.\" purpose with or without fee is hereby granted, provided that the above
12.\" copyright notice and this permission notice appear in all copies. 12.\" copyright notice and this permission notice appear in all copies.
13.\" 13.\"
14.\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES 14.\" THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES
15.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 15.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
16.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR 16.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR
17.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 17.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
18.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 18.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
19.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT 19.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
20.\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 20.\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
21.\" 21.\"
22.\" $OpenBSD: crontab.5,v 1.36 2018/06/13 13:27:37 jmc Exp $ 22.\" $OpenBSD: crontab.5,v 1.36 2018/06/13 13:27:37 jmc Exp $
23.\" 23.\"
24.Dd April 17, 2020 24.Dd February 26, 2022
25.Dt CRONTAB 5 25.Dt CRONTAB 5
26.Os 26.Os
27.Sh NAME 27.Sh NAME
28.Nm crontab 28.Nm crontab
29.Nd tables for driving cron 29.Nd tables for driving cron
30.Sh DESCRIPTION 30.Sh DESCRIPTION
31A 31A
32.Nm 32.Nm
33file contains instructions to the 33file contains instructions to the
34.Xr cron 8 34.Xr cron 8
35daemon of the general form: 35daemon of the general form:
36.Dq at these times on these dates run this command . 36.Dq at these times on these dates run this command .
37There may be a system 37There may be a system
@@ -288,37 +288,45 @@ variable can be set to an alternate time @@ -288,37 +288,45 @@ variable can be set to an alternate time
288is run. 288is run.
289Note that this only affects the scheduling of the job, not the time zone 289Note that this only affects the scheduling of the job, not the time zone
290that the job perceives when it is run. 290that the job perceives when it is run.
291If 291If
292.Ev CRON_TZ 292.Ev CRON_TZ
293is defined but empty 293is defined but empty
294.Pq Ev CRON_TZ Ns = Ns \&"" , 294.Pq Ev CRON_TZ Ns = Ns \&"" ,
295jobs are scheduled with respect to the local time zone. 295jobs are scheduled with respect to the local time zone.
296.It Ev CRON_WITHIN 296.It Ev CRON_WITHIN
297The 297The
298.Ev CRON_WITHIN 298.Ev CRON_WITHIN
299variable should indicate the number of seconds within a job's 299variable should indicate the number of seconds within a job's
300scheduled time that it should still be run. 300scheduled time that it should still be run.
 301For example if a job is scheduled for 12:30pm and
 302.Ev CRON_WITHIN
 303is
 304.Dv 120
 305(2 minutes), then the job will not be run if the system attempts
 306to start it past 12:32pm.
301On a heavily loaded system, or on a system that has just been 307On a heavily loaded system, or on a system that has just been
302.Dq woken up , 308.Dq woken up ,
303jobs will sometimes start later than originally intended, and by 309jobs will sometimes start later than originally intended, and by
304skipping non-critical jobs because of delays, system load can be 310skipping non-critical jobs because of delays, system load can be
305lightened. 311lightened.
306If 312If
307.Ev CRON_WITHIN 313.Ev CRON_WITHIN
308is defined but empty 314is defined but empty
309.Pq Ev CRON_WITHIN Ns = Ns \&"" , 315.Pq Ev CRON_WITHIN Ns = Ns \&"" ,
310or set to some non-positive value (0, a negative number, or a 316or set to some non-positive value (0, a negative number, or a
311non-numeric string), it is treated as if it was unset. 317non-numeric string), it is treated as if it was unset, that is
 318the job will always run, even if it is going to start at a time
 319long past its scheduled time.
312.It Ev HOME 320.It Ev HOME
313Set from the user's 321Set from the user's
314.Pa /etc/passwd 322.Pa /etc/passwd
315entry. 323entry.
316May be overridden by settings in the 324May be overridden by settings in the
317.Nm . 325.Nm .
318.It Ev LOGNAME 326.It Ev LOGNAME
319Set from the user's 327Set from the user's
320.Pa /etc/passwd 328.Pa /etc/passwd
321entry. 329entry.
322May not be overridden by settings in the 330May not be overridden by settings in the
323.Nm . 331.Nm .
324.It Ev MAILTO 332.It Ev MAILTO