pSOSystem System Calls - Read

pSOS+ System Calls q_broadcast
q_broadcast Broadcasts identical messages to an ordinary message queue.
#include
unsigned long q_broadcast(
unsigned long qid, /* queue identifier */
unsigned long msg_buf[4], /* msg. of 4 long words */
unsigned long *count /* # tasks receiving msg. */
)
Description
Arguments
Return Value
Error Codes
This system call enables the caller to wake up all tasks that might be waiting at an
ordinary message queue. If the task queue is empty, this call does nothing. If one or
more tasks are waiting at the queue, q_broadcast() gives a copy of the input
message to each such task and makes it ready to run. After a q_broadcast() call,
no tasks will be waiting to receive a message from the specified queue.
qid Specifies the queue ID of the target queue.
msg_buf Specifies the message to send.
count Points to the variable where q_broadcast() stores the
number of tasks readied by the broadcast.
This system call returns 0 on success, or an error code on failure.
Hex Mnemonic Description
0x05 ERR_OBJDEL Queue has been deleted.
0x06 ERR_OBJID qid is incorrect, failed validity check.
0x07 ERR_OBJTYPE Object type doesn’t match object ID;
failed validity check.
0x3A ERR_VARQ Queue is variable length.
pSOSystem System Calls 1-71
1