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_aurgent<br />

q_aurgent (pSOS+m kernel only) Asynchronously posts a message at the head of a<br />

variable-length message queue.<br />

#include <br />

unsigned long q_aurgent(<br />

unsigned long qid, /* queue identifier */<br />

unsigned long msg_buf[4] /* message buffer */<br />

)<br />

Description<br />

Arguments<br />

Return Value<br />

Error Codes<br />

This system call functions the same as the q_urgent() call except that it executes<br />

asynchronously. Refer to the description of q_urgent() for further information.<br />

qid Specifies the queue ID of the target queue.<br />

msg_buf Specifies the message to send.<br />

When called in a system running the pSOS+m kernel, this call always returns 0.<br />

The pSOS+ kernel (the single processor version) returns ERR_SSFN.<br />

Should the call fail, if present, the node's MC_ASYNCERR routine is invoked and the<br />

following error codes can be reported:<br />

Hex Mnemonic Description<br />

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

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

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

failed validity check.<br />

0x34 ERR_NOMGB Out of system message buffers.<br />

0x35 ERR_QFULL Message queue at length limit.<br />

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

1

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

Saved successfully!

Ooh no, something went wrong!