RTEMS 4.9.2 On-Line Library

Clock Manager CLOCK_GET_TOD_TIMEVAL - Get date and time in timeval format

RTEMS Ada User's Guide

7.4.4: CLOCK_GET_TOD_TIMEVAL - Get date and time in timeval format

CALLING SEQUENCE:

procedure Clock_Get_TOD_Timeval (
   Time   : in     RTEMS.Timeval;
   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 is NULL

DESCRIPTION:

This directive obtains the system date and time in POSIX struct timeval format. 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