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.

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

q_vident Obtains the queue ID of a variable-length message queue.<br />

#include <br />

unsigned long q_vident(<br />

char name[4], /* queue name */<br />

unsigned long node, /* node number */<br />

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

)<br />

Description<br />

Arguments<br />

Return Value<br />

Error Codes<br />

The intended purpose of this system call is to allow the calling task to obtain the<br />

queue ID of a variable length message queue. However, since a variable length<br />

message queue is just a special type of message queue, q_ident() and<br />

q_vident() are functionally identical. Both return the queue ID of the first<br />

variable length or fixed length queue encountered with the specified name.<br />

name Specifies the user-assigned name of the message queue.<br />

node For multiprocessor systems, is a search order specifier. See<br />

“Multiprocessor Considerations.” In a single node system,<br />

this argument must be 0.<br />

qid Points to the variable where q_vident() stores the queue<br />

ID of the named queue.<br />

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

Hex Mnemonic Description<br />

0x04 ERR_NODENO Node specifier out of range.<br />

0x09 ERR_OBJNF Named queue not found.<br />

1-96 <strong>pSO<strong>System</strong></strong> <strong>System</strong> <strong>Calls</strong>

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

Saved successfully!

Ooh no, something went wrong!