Bug 1816908

Summary:	add more info about "OnCalendar=" in systemd man page
Product:	Red Hat Enterprise Linux 8	Reporter:	kfujii <kfujii>
Component:	systemd	Assignee:	David Tardon <dtardon>
Status:	CLOSED ERRATA	QA Contact:	Frantisek Sumsal <fsumsal>
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	8.1	CC:	dtardon, systemd-maint-list
Target Milestone:	rc	Keywords:	ManPageChange
Target Release:	8.0
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2020-11-04 02:02:10 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description kfujii 2020-03-25 04:17:37 UTC

Description of problem:

Currently, the man page has less info about OnCalendar= compared with https://www.freedesktop.org/software/systemd/man/systemd.timer.html

RHEL8's info (man systemd.timer)
=============================
OnCalendar=
           Defines realtime (i.e. wallclock) timers with calendar event
           expressions. See systemd.time(7) for more information on the syntax
           of calendar event expressions. Otherwise, the semantics are similar
           to OnActiveSec= and related settings.

           Note that timers do not necessarily expire at the precise time
           configured with this setting, as it is subject to the AccuracySec=
           setting below.

           May be specified more than once.
=============================



Upstream's info
=============================
OnCalendar=

    Defines realtime (i.e. wallclock) timers with calendar event 
    expressions. See systemd.time(7) for more information on the syntax 
    of calendar event expressions. Otherwise, the semantics are similar 
    to OnActiveSec= and related settings.

    Note that timers do not necessarily expire at the precise time 
    configured with this setting, as it is subject to the AccuracySec= 
    setting below.

    May be specified more than once, in which case the timer unit will 
    trigger whenever any of the specified expressions elapse. Moreover 
    calendar timers and monotonic timers (see above) may be combined 
    within the same timer unit.

    If the empty string is assigned to any of these options, the list 
    of timers is reset (both OnCalendar= timers and monotonic timers, 
    see above), and all prior assignments will have no effect.


============================

we should back port this to RHEL8 and RHEL7 as well


Version-Release number of selected component (if applicable):


How reproducible:
100%

Steps to Reproduce:
1.
2.
3.

Actual results:

the man page has less info about OnCalendar= compared with https://www.freedesktop.org/software/systemd/man/systemd.timer.html

Expected results:

the man page has same info about OnCalendar= compared with https://www.freedesktop.org/software/systemd/man/systemd.timer.html


Additional info:

please make a clone for RHEL7 if you can

Comment 2 Lukáš Nykrýn 2020-05-19 11:27:22 UTC

fix merged to github master branch -> https://github.com/systemd-rhel/rhel-8/pull/80

Comment 8 errata-xmlrpc 2020-11-04 02:02:10 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory (Low: systemd security, bug fix, and enhancement update), and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHSA-2020:4553