Skip to content

Deprecate crm_time_calculate_duration() through crm_time_get_seconds()#4130

Open
nrwahl2 wants to merge 40 commits into
ClusterLabs:mainfrom
nrwahl2:nrwahl2-time_first
Open

Deprecate crm_time_calculate_duration() through crm_time_get_seconds()#4130
nrwahl2 wants to merge 40 commits into
ClusterLabs:mainfrom
nrwahl2:nrwahl2-time_first

Conversation

@nrwahl2

@nrwahl2 nrwahl2 commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

This is the next batch from #4097.

nrwahl2 added 30 commits June 16, 2026 13:50
Pacemaker should not be used for general-purpose date/time manipulation.
There's no need to calculate a duration (as the difference between two
crm_time_t objects) for the purpose of administering Pacemaker. Where
Pacemaker uses durations, it parses them directly from strings.

A crm_time_t object can be displayed as a string if desired, and then a
user can compare two strings through whatever method they desire.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_parse_duration().

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Pacemaker parses durations from strings in a few places. However,
there is no need for external code to do this for the purpose of
administering Pacemaker. Pacemaker should not be used for
general-purpose date/time manipulation.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Add a couple of missing includes elsewhere, since they break otherwise.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Use crm_time_new() to create a new crm_time_t object from a string (or
NULL to use the current time).

There is no need for external callers to create an uninitialized object
and then set the fields (such as years) later. Pacemaker should not be
used for general-purpose date/time manipulation.

pcmk_evaluate_rule() can take an uninitialized (undefined) crm_time_t
object as the next_change argument and update it as appropriate.
However, that argument is for use by the scheduler, not for external
callers.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_is_defined().

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
External callers should always be using crm_time_new() to create a
crm_time_t object. Such objects will be initialized ("defined").

Pacemaker does not return crm_time_t objects via public API functions,
except as an output argument of pcmk_evaluate_rule(). However, that
argument is for use by the scheduler, not for external callers.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_as_string().

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Pacemaker should not be used for general-purpose date/time manipulation.
It also does not return crm_time_t objects (except in the case of
pcmk_evaluate_rule(), as discussed in previous commit messages). So
external callers have no need to convert a crm_time_t to a string
representation.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_log_date.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_log_timeofday.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_log_with_timezone.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_log_duration.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_ordinal.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_weeks.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_seconds.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_epoch.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_usecs.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_compare().

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
nrwahl2 added 10 commits June 16, 2026 13:52
It's always TRUE.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_get_timeofday().

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
External callers have no need to inspect a crm_time_t object. Pacemaker
should not be used for general-purpose date/time manipulation.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
It always returns TRUE.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_get_gregorian().

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
External callers have no need to inspect a crm_time_t object. Pacemaker
should not be used for general-purpose date/time manipulation.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
External callers have no need to inspect a crm_time_t object. Pacemaker
should not be used for general-purpose date/time manipulation.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
To replace crm_time_get_seconds().

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
External callers have no need to inspect a crm_time_t object. Pacemaker
should not be used for general-purpose date/time manipulation.

Signed-off-by: Reid Wahl <nrwahl@protonmail.com>
@nrwahl2 nrwahl2 requested a review from clumens June 16, 2026 20:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant