RTEMS 4.7.2 On-Line Library

Eventflags Manager del_flg - Delete Eventflag

RTEMS ITRON 3.0 API User's Guide

4.4.2: del_flg - Delete Eventflag

CALLING SEQUENCE:

ER del_flg(
  ID flgid
);

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

DESCRIPTION:

This system call deletes the eventflag specified by flgid.

Issuing this system call causes memory used for the control block of the associated eventflag to be released. After this system call is invoked, another eventflag having the same ID number can be created.

This system call will complete normally even if there are tasks waiting for the eventflag. In that case, an E_DLT error will be returned to each waiting task.

NOTES:

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

When an eventflag being waited for by more than one tasks is deleted, the order of tasks on the ready queue after the WAIT state is cleared is implementation dependent in the case of tasks having the same priority.

RTEMS ITRON 3.0 API User's Guide