06.08.2013 Views

pSOSystem System Calls - Read

pSOSystem System Calls - Read

pSOSystem System Calls - Read

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

tm_set pSOS+ <strong>System</strong> <strong>Calls</strong><br />

Return Value<br />

Error Codes<br />

Notes<br />

This system call returns 0 on success, or an error code on failure.<br />

Hex Mnemonic Description<br />

0x48 ERR_ILLDATE Date input out of range.<br />

0x49 ERR_ILLTIME Time input out of range.<br />

0x4A ERR_ILLTICKS Ticks input out of range.<br />

1. This implementation accurately reflects leap years and the current century. For<br />

example, the value 0088 means 88 A.D., not 1988 A.D.<br />

2. The pSOS+ kernel maintains a flag that indicates if the system time has been<br />

initialized since the last system reboot. Startup clears the flag, and tm_set()<br />

sets the flag.<br />

3. If the input values are accurate when this call is made, the actual<br />

synchronization of the system clock depends on such variables as the execution<br />

time of tm_set() and the moment it arrives between two ticks. The accuracy is<br />

within one or two ticks.<br />

4. tm_set() has no effect on tasks that are either timing out or waiting after<br />

tm_wkafter() or tm_evafter() calls because these pause intervals are in<br />

clock ticks, not clock time.<br />

Multiprocessor Considerations<br />

None. This call can only be directed at the local processor node.<br />

1-176 <strong>pSO<strong>System</strong></strong> <strong>System</strong> <strong>Calls</strong>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!