Should we document a time zone for the RTEMS epoch?
Sebastian Huber
sebastian.huber at embedded-brains.de
Wed Feb 10 16:53:37 UTC 2021
On 10/02/2021 17:47, Joel Sherrill wrote:
>
>
> On Wed, Feb 10, 2021, 10:30 AM Sebastian Huber
> <sebastian.huber at embedded-brains.de
> <mailto:sebastian.huber at embedded-brains.de>> wrote:
>
> On 10/02/2021 07:53, Sebastian Huber wrote:
>
> > Hello,
> >
> > I try to update the clock manager documentation and noticed that
> there
> > is no time zone specified for the RTEMS epoch. In the timecounter
> > initialization we use:
> >
> > static struct timehands th0 = {
> > [...]
> > #ifdef __rtems__
> > .th_bintime = { .sec = TOD_SECONDS_1970_THROUGH_1988 },
> > .th_microtime = { TOD_SECONDS_1970_THROUGH_1988, 0 },
> > .th_nanotime = { TOD_SECONDS_1970_THROUGH_1988, 0 },
> > .th_boottime = { .sec = TOD_SECONDS_1970_THROUGH_1988 - 1 },
> > #endif /* __rtems__ */
> >
> > [...]
> >
> > };
> >
> > Since Unix epoch is 1970-01-01T00:00:00Z, this basically defines
> that
> > the RTEMS epoch is 1988-01-01T00:00:00Z. Should this be documented?
> > The current implementation also implies that the time reported by
> > RTEMS is in UTC (modulo leap seconds).
>
> I tried to document the clocks provided by RTEMS, see tail of
> (glossary.rst):
>
> https://lists.rtems.org/pipermail/devel/2021-February/064451.html
> <https://lists.rtems.org/pipermail/devel/2021-February/064451.html>
>
>
> Is it sufficient to reference the epoch entry in various clock get
> time method pages?
The relevant epoch and clock is now referenced in the directives.
>
> And should there be discussion somewhere about TZ environment variable
> and the methods in newlib which account for that.
I think a time zone is simply not accounted for in the RTEMS Classic
API. With the setting above I guess the time zone is fixed to UTC.
--
embedded brains GmbH
Herr Sebastian HUBER
Dornierstr. 4
82178 Puchheim
Germany
email: sebastian.huber at embedded-brains.de
phone: +49-89-18 94 741 - 16
fax: +49-89-18 94 741 - 08
Registergericht: Amtsgericht München
Registernummer: HRB 157899
Vertretungsberechtigte Geschäftsführer: Peter Rasmussen, Thomas Dörfler
Unsere Datenschutzerklärung finden Sie hier:
https://embedded-brains.de/datenschutzerklaerung/
More information about the devel
mailing list