flushband(D3)

NAME
     flushband - flush messages in a specified priority band

SYNOPSIS
     #include <sys/types.h>
     #include <sys/stream.h>
     #include <sys/ddi.h>
     void flushband(queue_t *q, uchar_t pri, int flag);

   Arguments
     q    Pointer to the queue.

     pri  Priority band of messages to be flushed.

     flag Determines messages to flush.

DESCRIPTION
     The flushband function flushes messages associated with the priority band
     specified by pri.  If pri is 0, only normal and high priority messages
     are flushed.  Otherwise, messages are flushed from the band pri according
     to the value of flag.

     If the band's count falls below the low water mark and someone wants to
     write to the band, the nearest upstream or downstream service procedure
     is enabled.

   Return Values
     None

USAGE
     Valid values for flag are:

          FLUSHDATA      Flush only data messages (types M_DATA, M_DELAY,
                         M_PROTO, and M_PCPROTO).

          FLUSHALL       Flush all messages.

   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.

   Examples
     See put(D2) for an example of flushband.
REFERENCES
     flushq(D3), put(D2), queue(D4)