Taskdependent synchronization functions, Error checking, Task-dependent synchronization functions – Comtrol eCos User Manual

Page 476

Advertising
background image

Chapter 32. µITRON API

ter_tsk()

: the task must not be dormant, else E_OBJ

chg_pri()

: the task must not be dormant, else E_OBJ

rel_wai()

: the task must be in

WAIT

or

WAIT-SUSPEND

state, else E_OBJ

Task-Dependent Synchronization Functions

These functions are fully supported in this release:

ER

sus_tsk

(

ID tskid )

ER

rsm_tsk

(

ID tskid )

ER

frsm_tsk

(

ID tskid )

ER

slp_tsk

( void )

ER

tslp_tsk

(

TMO tmout )

ER

wup_tsk

(

ID tskid )

ER

can_wup

(

INT *p_wupcnt,

ID tskid )

Error checking

The

following

conditions

are

only

checked

for,

and

only

return

errors

if

CYGSEM_UITRON_BAD_PARAMS_RETURN_ERRORS

is

enabled

(see

the

configuration

option

“Return Error Codes for Bad Params”):

invalid tskid; less than 1 or greater than

CYGNUM_UITRON_TASKS

returns E_ID

wup_tsk()

,

sus_tsk()

,

rsm_tsk()

,

frsm_tsk()

on the calling task returns E_OBJ

dispatching is enabled in

tslp_tsk()

and

slp_tsk()

, or E_CTX

tmout must be positive, otherwise E_PAR

return value pointer in

can_wup()

is a valid pointer, or E_PAR

The following conditions are checked for, and can return error codes, regardless of the setting of

CYGSEM_UITRON_BAD_PARAMS_RETURN_ERRORS

:

When create and delete functions

cre_tsk()

and

del_tsk()

are supported, all calls which use a valid task ID

number check that the task exists; if not, E_NOEXS is returned

sus_tsk()

: the task must not be dormant, else E_OBJ

372

Advertising