RTEMS 4.6.1 On-Line Library

Semaphore Manager ref_sem - Reference Semaphore Status

RTEMS ITRON 3.0 API User's Guide

3.4.7: ref_sem - Reference Semaphore Status

CALLING SEQUENCE:

ER ref_sem(
  T_RSEM *pk_rsem,
  ID semid
);

STATUS CODES:

E_OK - Normal Completion

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

E_NOEXS - Object does not exist (the semaphore specified by semid does not exist)

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

E_PAR - Parameter error (the packet address for the return parameters could not be used)

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_RPAR - A value outside the range supported by the requesting node and/or transmission packet format was returned as a parameter (a value outside supported range was specified for exinf, wtsk or semcnt)

DESCRIPTION:

This routine returns status information on the semaphore specified by semid. The pk_rsem structure is filled in by this service call.

NOTES:

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

This routine will not cause the running task to be preempted.

RTEMS ITRON 3.0 API User's Guide