T-Kernel Specification (1.B0.02)

4.7. TIME MANAGEMENT FUNCTIONS 165
tk set tim
Set Time
[C Language Interface]
ER ercd = tk_set_tim ( SYSTIM *pk_tim ) ;
[Parameters]
SYSTIM* pk tim Address of current time packet
pk tim detail:
SYSTIM systim Current system time
[Return Parameters]
ER ercd Error code
[Error Codes]
E OK
E PAR
Normal completion
Parameter error (pk tim is invalid, or time setting is invalid)
[Description]
Sets the system clock to the value designated in systim.
System time is expressed as cumulative milliseconds from 0:00:00 (GMT), January 1, 1985.
[Additional Notes]
The relative time designated in RELTIM or TMO does not change even if the system clock is changed by
calling tk set tim during system operation. For example, if a timeout is set to elapse in 60 seconds and
the system clock is advanced by 60 seconds by tk set tim while waiting for the timeout, the timeout
occurs not immediately but 60 seconds after it was set. Instead, tk set tim changes the system time
at which the timeout occurs.
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02