rmvq(D3)

rmvq - remove a message from a queue

Showing IRIX 6.5.30 (default release). Unchanged since IRIX 6.5.

NAME
     rmvq - remove a message from a queue

SYNOPSIS
     #include <sys/stream.h>
     #include <sys/ddi.h>
     void rmvq(queue_t *q, mblk_t *mp);

   Arguments
     q         Pointer to the queue containing the message to be removed.

     mp        Pointer to the message to remove.

DESCRIPTION
     rmvq removes the message specified by mp from the queue specified by q.

   Return Values
     None

USAGE
     A message can be removed from anywhere in a queue.  To prevent modules
     and drivers from having to deal with the internals of message linkage on
     a queue, either rmvq or getq(D3) should be used to remove a message from
     a queue.

   Level
     Base or Interrupt.

   Synchronization Constraints
     Does not sleep.

     Driver-defined basic locks, read/write locks, and sleep locks may be held
     across calls to this function.

   Warnings
     mp must point to an existing message in the queue pointed to by q, or a
     system panic will occur.

   Examples
     See insq(D3) for an example of rmvq.

REFERENCES
     getq(D3), insq(D3),