RTEMS 4.10.1 On-Line Library

Clock Manager CLOCK_GET_TOD - Get date and time in TOD format

RTEMS Ada User's Guide

7.4.3: CLOCK_GET_TOD - Get date and time in TOD format

CALLING SEQUENCE:

procedure Clock_Get_TOD (
   Time_Buffer : in     RTEMS.Time_Of_Day;
   Result      :    out RTEMS.Status_Codes
);

DIRECTIVE STATUS CODES:

RTEMS.SUCCESSFUL - current time obtained successfully
RTEMS.NOT_DEFINED - system date and time is not set
RTEMS.INVALID_ADDRESS - time_buffer is NULL

DESCRIPTION:

This directive obtains the system date and time. If the date and time has not been set with a previous call to rtems.clock_set, then the RTEMS.NOT_DEFINED status code is returned.

NOTES:

This directive is callable from an ISR.

This directive will not cause the running task to be preempted. Re-initializing RTEMS causes the system date and time to be reset to an uninitialized state. Another call to rtems.clock_set is required to re-initialize the system date and time to application specific specifications.

RTEMS Ada User's Guide