Bug 243380 - atrun(8) man page does not reflect cron.d change
Summary: atrun(8) man page does not reflect cron.d change
Status: In Progress
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: freebsd-bugs (Nobody)
Depends on:
Reported: 2020-01-15 21:30 UTC by Andrew Daugherity
Modified: 2024-05-12 08:39 UTC (History)
5 users (show)

See Also:


Note You need to log in before you can comment on or make changes to this bug.
Description Andrew Daugherity 2020-01-15 21:30:47 UTC
I was upgrading a system from 11.2 to 12.1, and freebsd-update presented me with a diff removing the /usr/libexec/atrun line from /etc/crontab.  I wasn't sure whether to accept this change, so I RTFM and see that atrun(8) still says:
     The system crontab(5) file /etc/crontab must contain the line

     */5     *       *       *       *       root    /usr/libexec/atrun

     so atrun is invoked every five minutes.

This makes removing the line seem like an incorrect change; however, I looked through the svn history of the crontab file and see that r318443 removed this line and put it in /etc/cron.d/at instead.

The man page should be updated to reflect this, but I don't know what the best wording is.  Perhaps something like "The system crontab(5) segment /etc/cron.d/at must contain the line"?

Additionally, crontab(5) does not mention cron.d at all.  Would merging the "Jobs in /etc/cron.d/" and "EXAMPLE OF A JOB IN /etc/cron.d/job" sections of cronie's man page [1] be appropriate?  It's clearly derived from the same Vixie cron man page and is ISC-licensed.

[1] https://github.com/cronie-crond/cronie/blob/master/man/crontab.5
Comment 1 Paweł Krawczyk 2024-02-06 20:38:49 UTC
Fix https://github.com/kravietz/freebsd-src/pull/1
Comment 2 Paweł Krawczyk 2024-02-06 20:43:40 UTC
(In reply to Paweł Krawczyk from comment #1)

Correct PR https://github.com/freebsd/freebsd-src/pull/1106
Comment 3 commit-hook freebsd_committer freebsd_triage 2024-05-10 04:36:21 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=783baf00128f6cf6fc08404eaad6a11b29d4025d

commit 783baf00128f6cf6fc08404eaad6a11b29d4025d
Author:     Paweł Krawczyk <p+freebsd@krvtz.net>
AuthorDate: 2024-05-10 04:21:18 +0000
Commit:     Warner Losh <imp@FreeBSD.org>
CommitDate: 2024-05-10 04:34:06 +0000

    at cron file is now in /etc/cron.d

    PR: 243380
    Reviewed by: imp
    Pull Request: https://github.com/freebsd/freebsd-src/pull/1106

 libexec/atrun/atrun.man | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
Comment 4 Gordon Bergling freebsd_committer freebsd_triage 2024-05-12 08:39:43 UTC
committed to HEAD, MFC is waiting.