RTOS/rtems
1
0
Fork 0
forked from Imagelibrary/rtems
Code Pull Requests Activity

rtems: Document time of day constraints

Browse Source 
Update #4338.
This commit is contained in:
Sebastian Huber
2021-09-03 16:55:18 +02:00
parent f958d58a6a
commit c0435b5eb2
1 changed files with 13 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
cpukit/include/rtems/rtems/clock.h
View File

@@ -101,10 +101,13 @@ extern "C" {
* range-checked, and an error is returned if any one is out of its valid * range-checked, and an error is returned if any one is out of its valid
* range. * range.
* *
* RTEMS can represent time points of this clock in nanoseconds ranging from * RTEMS can represent time points of the CLOCK_REALTIME clock in nanoseconds
* 1988-01-01T00:00:00.000000000Z to 2514-05-31T01:53:03.999999999Z. The * ranging from 1988-01-01T00:00:00.000000000Z to
* future uptime of the system shall be in this range, otherwise the system * 2514-05-31T01:53:03.999999999Z. The future uptime of the system shall be in
* behaviour is undefined. * this range, otherwise the system behaviour is undefined. Due to
* implementation constraints, the time of day set by the directive shall be
* before 2100-01-01:00:00.000000000Z. The latest valid time of day accepted
* by the POSIX clock_settime() is 2400-01-01T00:00:00.999999999Z.
* *
* The specified time is based on the configured clock tick rate, see the * The specified time is based on the configured clock tick rate, see the
* #CONFIGURE_MICROSECONDS_PER_TICK application configuration option. * #CONFIGURE_MICROSECONDS_PER_TICK application configuration option.
@@ -133,6 +136,12 @@ extern "C" {
* *
* * The directive may unblock a task. This may cause the calling task to be * * The directive may unblock a task. This may cause the calling task to be
* preempted. * preempted.
*
* * The time of day set by the directive shall be
* 1988-01-01T00:00:00.000000000Z or later.
*
* * The time of day set by the directive shall be before
* 2100-01-01T00:00:00.000000000Z.
* @endparblock * @endparblock
*/ */
rtems_status_code rtems_clock_set( const rtems_time_of_day *time_of_day ); rtems_status_code rtems_clock_set( const rtems_time_of_day *time_of_day );