pSOSystem System Calls - Read

pSOS+ System Calls q_ident
q_ident Obtains the queue ID of an ordinary message queue.
#include
unsigned long q_ident(
char name[4], /* queue name */
unsigned long node, /* node number */
unsigned long *qid /* queue identifier */
)
Description
Arguments
Return Value
The intended purpose of this system call is to enable the calling task to obtain the
queue ID of an ordinary message queue. However, since a variable length message
queue is just a special type of message queue, q_ident() and q_vident() are
functionally identical. Both return the queue ID of the first queue encountered with
the specified name, whether it be ordinary or variable length.
Most system calls, except q_create()/q_vcreate() and q_ident()/
q_vident(), reference a queue by its queue ID. For other tasks, one way to obtain
the queue ID is to use q_ident()/q_vident(). Once obtained, the queue ID can
then be used in all other operations relating to this queue.
name Specifies the name of the message queue.
node For multiprocessing systems, is a search order specifier. See
“Multiprocessor Considerations.” In a single node system,
this argument must be 0.
qid Points to the variable where q_ident() stores the ID of the
named message queue.
The system call returns 0 on success, or an error code on failure.
pSOSystem System Calls 1-79
1