06.08.2013 Views

pSOSystem System Calls - Read

pSOSystem System Calls - Read

pSOSystem System Calls - Read

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

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

q_asend (pSOS+m kernel only) Asynchronously posts a message to an ordinary<br />

message queue.<br />

#include <br />

unsigned long q_asend(<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 q_send() except that it executes<br />

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

detailed description of asynchronous services, refer to the <strong>pSO<strong>System</strong></strong> <strong>System</strong>s<br />

Concepts manual.<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. The<br />

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 may 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 />

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

1

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

Saved successfully!

Ooh no, something went wrong!