#2189 assigned defect

Insufficient documentation for rtems_clock_get_tod()

Reported by: Sebastian Huber Owned by: Needs Funding
Priority: highest Milestone: Indefinite
Component: doc Version: 4.11
Severity: normal Keywords: qualification
Cc: chrisj@… Blocked By:


It is not clear which date and time is returned by rtems_clock_get_tod(). For example which time zone is used. Is there a relation to UTC?

Change History (11)

comment:1 Changed on Sep 16, 2014 at 7:29:53 AM by Chris Johns

Cc: Chris Johns added

The timezone is the one you used when you set the time with the set call. If the time is not set this function returns RTEMS_NOT_DEFINED. It is assumed you set a suitable time in the first place and know the specific context of use.

comment:2 Changed on Dec 19, 2014 at 5:06:18 AM by Gedare Bloom

Priority: normalhighest

Bump priority to highest for tickets with a fix attached or seemingly simple fix proposed in the description or comments.

comment:3 Changed on Mar 2, 2015 at 8:42:45 PM by Gedare Bloom


bump milestone

comment:4 Changed on Oct 20, 2015 at 11:05:06 PM by Joel Sherrill

This ticket does not have a patch attached or an obvious (to me) fix. What is the fix proposed?

comment:5 Changed on Oct 21, 2015 at 5:42:48 AM by Sebastian Huber

We need a more precise documentation of the time services. How are leap seconds handled for example? UNIX time vs. UTC.

comment:6 Changed on Nov 24, 2015 at 9:34:59 AM by Sebastian Huber

The wall clock time services lack documentation in general. What is the relation between rtems_time_of_day and the UNIX time as specified by IEEE Std 1003.1, 2013 Edition, 4.15 Seconds Since the Epoch (http://pubs.opengroup.org/onlinepubs/9699919799/). For example _TOD_To_seconds() does not use the expression in this standard document. This affects rtems_timer_fire_when().

comment:7 Changed on Nov 24, 2015 at 4:22:54 PM by Joel Sherrill

Can you provide a specific link? That is to the top of the standard.

comment:9 Changed on Jan 26, 2017 at 7:16:00 AM by Sebastian Huber


comment:10 Changed on Feb 15, 2017 at 1:37:51 PM by Sebastian Huber

Milestone: 4.11.2Indefinite
Owner: changed from Joel Sherrill to Needs Funding
Status: newassigned

comment:11 Changed on Jun 18, 2021 at 9:24:45 AM by Sebastian Huber

Keywords: qualification added
Note: See TracTickets for help on using tickets.