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

q_vsend Posts a message to a specified variable-length message queue.<br />

#include <br />

unsigned long q_vsend(<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 is used to send a message to a specified variable length message<br />

queue. Other than the queue type, q_vsend() operates just like q_send().<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 queue's<br />

maximum message length.<br />

This system call returns 0 on success, or an error code on failure.<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; failed<br />

validity check.<br />

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

buffer length.<br />

0x31 ERR_MSGSIZ Message is too large.<br />

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

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

1

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

Saved successfully!

Ooh no, something went wrong!