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

q_avsend (pSOS+m kernel only) Asynchronously posts a message to a variablelength<br />

message queue.<br />

#include <br />

unsigned long q_avsend(<br />

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

void *msg_buf, /* message buffer */<br />

unsigned long msg_len, /* length of message */<br />

)<br />

Description<br />

Arguments<br />

Return Value<br />

Error Codes<br />

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

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

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

msg_buf Points to the message to send.<br />

msg_len Specifies the length of the message. It must not exceed the<br />

queue's maximum message length.<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 />

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

1

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

Saved successfully!

Ooh no, something went wrong!