Puts a message at a specific place in a queue.
The insq utility places the message pointed to by the mp parameter in the message queue pointed to by the q parameter, immediately before the already-queued message pointed to by the emp parameter.
If an attempt is made to insert a message out of order in a queue by using the insq utility, the message will not be inserted and the routine is not successful.
This utility is part of STREAMS Kernel Extensions.
The queue class of the new message is ignored. However, the priority band of the new message must adhere to the following format:
emp->b_prev->b_band >= mp->b_band >= emp->b_band.
Item | Description |
---|---|
q | Specifies the queue on which to place the message. |
emp | Specifies the existing message before which the new message
is to be placed. If the emp parameter has a value of null, the message is placed at the end of the queue. If the emp parameter is nonnull, it must point to a message that exists on the queue specified by the q parameter, or undesirable results could occur. |
mp | Specifies the message that is to be inserted on the queue. |
On successful completion, the insq utility returns a value of 1. Otherwise, it returns a value of 0.