flushband(D3) 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.
Copyright 1994 Novell, Inc. Page 1
flushband(D3) flushband(D3)
The caller cannot have the stream frozen [see freezestr(D3)]
when calling this function.
Examples
See put(D2) for an example of flushband.
REFERENCES
flushq(D3), put(D2), queue(D4)
NOTICES
Portability
All processors
Applicability
ddi: 1, 2, 3, 4, 5, 5mp, 6, 6mp, 7, 7mp
Copyright 1994 Novell, Inc. Page 2