pSOSystem System Calls - Read

pSOS+ System Calls q_vbroadcast
Notes
Hex Mnemonic Description
0x30 ERR_KISIZE Message buffer length exceeds max.
KI packet buffer length.
0x31 ERR_MSGSIZ Message is too large.
0x3B ERR_NOTVARQ Queue is not variable length.
0x65 ERR_STALEID Object's node has failed.
1. If the caller is a task, it may be preempted as a result of this call.
2. q_vbroadcast() can be intermixed with q_vsend() and q_vurgent() calls
to the same queue.
3. The pSOS+ kernel must copy the message from the caller's buffer to a receiving
task's buffer. Longer messages take longer to copy. Users should account for the
copy time in their designs, especially when calling from an ISR.
4. q_vbroadcast() sends messages to a variable length message queue. Use
q_broadcast() to send messages to an ordinary queue.
Multiprocessor Considerations
1. If qid identifies a global queue residing on another processor node, the local
kernel will internally make an RSC to that remote node to post the input
message to that queue.
2. If tasks awakened by this call do not reside on the local node, the local kernel
internally passes the message to each task's node of residence, whose pSOS+
kernel will ready the task and give it the relayed message. Thus, a
q_vbroadcast() call, whether it is on the local or a remote queue, may cause
pSOS+m activities on one or more processor nodes.
pSOSystem System Calls 1-89
1