RTEMS 4.7.0 On-Line Library

Eventflags Manager clr_flg - Clear Eventflag

RTEMS ITRON 3.0 API User's Guide

4.4.4: clr_flg - Clear Eventflag

CALLING SEQUENCE:

ER clr_flg(
  ID flgid,
  UINT clrptn
);

STATUS CODES:

E_OK - Normal Completion

E_ID - Invalid ID number (flgid was invalid or could not be used)

E_NOEXS - Object does not exist (the eventflag specified by flgid does not exist)

E_OACV - Object access violation (A flgid less than -4 was specified from a user task. This is implementation dependent.)

EN_OBJNO - An object number which could not be accessed on the target node is specified.

EN_CTXID - Specified an object on another node when the system call was issued from a task in dispatch disabled state or from a task-independent portion

EN_PAR - A value outside the range supported by the target node and/or transmission packet format was specified as a parameter (a value outside supported range was specified for setptn or clrptn)

DESCRIPTION:

The clr_flg system call clears the bits of the one word eventflag based on the corresponding zero bits of clrptn. In other words, a logical product is taken for the values of the eventflag specified by flgid with the value of clrptn.

Issuing clr_flg never results in wait conditions being released on a task waiting for the specified eventflag. In other words, dispatching never occurs with clr_flg.

Nothing will happen to the target eventflag if all bits of clrptn are specified as 1 with clr_flg. No error will result.

NOTES:

Multiprocessing is not supported. Thus none of the "EN_" status codes will be returned.

RTEMS ITRON 3.0 API User's Guide