06.08.2013 Views

pSOSystem System Calls - Read

pSOSystem System Calls - Read

pSOSystem System Calls - Read

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

pSOS+ <strong>System</strong> <strong>Calls</strong> q_vreceive<br />

Return Value<br />

Error Codes<br />

Notes<br />

This system call returns 0 on success, or an error code on failure.<br />

Hex Mnemonic Description<br />

0x01 ERR_TIMEOUT Timed out: this error code is returned<br />

only if a timeout was requested.<br />

0x05 ERR_OBJDEL Queue has been deleted.<br />

0x06 ERR_OBJID qid incorrect; failed validity checks.<br />

0x07 ERR_OBJTYPE Object type doesn’t match object ID;<br />

failed validity check.<br />

0x30 ERR_KISIZE Message buffer length exceeds max.<br />

KI packet buffer length.<br />

0x32 ERR_BUFSIZ Buffer is too small.<br />

0x36 ERR_QKILLD Queue deleted while task waiting.<br />

0x37 ERR_NOMSG Queue empty; this error code is<br />

returned only if Q_NOWAIT was<br />

selected.<br />

0x3B ERR_NOTVARQ Queue is not variable length.<br />

0x54 ERR_NOAGNT Cannot wait; the remote node is out of<br />

agents.<br />

0x65 ERR_STALEID Object's node has failed.<br />

0x66 ERR_NDKLD Object's node failed while remote<br />

service call (RSC) waiting.<br />

1. If it is necessary to block the calling task, q_vreceive() will enter the calling<br />

task in the queue's task-wait queue. If the queue was created with the Q_FIFO<br />

attribute, then the caller is simply entered at the tail of the wait queue. If the<br />

<strong>pSO<strong>System</strong></strong> <strong>System</strong> <strong>Calls</strong> 1-99<br />

1

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!