T-Kernel Specification (1.B0.02)

6.1. KERNEL INTERNAL STATE ACQUISITION FUNCTIONS 265
td ref sem, td ref flg, td ref mbx, td ref mtx
td ref mbf, td ref por, td ref mpf, td ref mpl
td ref cyc, td ref alm, td ref ssy
Reference Queue
[C Language Interface]
ER ercd = td_ref_sem ( ID semid, TD_RSEM *rsem ); /* semaphore */
ER ercd = td_ref_flg ( ID flgid, TD_RFLG *rflg ); /* event flag */
ER ercd = td_ref_mbx ( ID mbxid, TD_RMBX *rmbx ); /* mailbox */
ER ercd = td_ref_mtx ( ID mtxid, TD_RMTX *rmtx ); /* mutex */
ER ercd = td_ref_mbf ( ID mbfid, TD_RMBF *rmbf ); /* message buffer */
ER ercd = td_ref_por ( ID porid, TD_RPOR *rpor ); /* rendezvous port */
ER ercd = td_ref_mpf ( ID mpfid, TD_RMPF *rmpf ); /* fixed-size memory pool */
ER ercd = td_ref_mpl ( ID mplid, TD_RMPL *rmpl ); /* variable-size memory pool */
ER ercd = td_ref_cyc ( ID cycid, TD_RCYC *rcyc ); /* cyclic handler */
ER ercd = td_ref_alm ( ID almid, TD_RALM *ralm ); /* alarm handler */
ER ercd = td_ref_ssy ( ID ssid, TD_RSSY *rssy ); /* subsystem */
[Parameters]
ID —id Object ID
TD R— r— Address of status information packet
[Return Parameters]
ER ercd Error code
[Error Codes]
E OK
E ID
E NOEXS
Normal completion
Bad identifier
Object does not exist
[Description]
Gets the status of an object. This is similar to tk ref —. The return packets are defined as follows.
/*
*Semaphore status information td_ref_sem
*/
typedef struct td_rsem {
VP exinf; /* extended information */
ID wtsk; /* waiting task ID */
INT semcnt; /* current semaphore count */
} TD_RSEM;
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02