SVR5 and SCO OpenServer 5
flushband(D3str)
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);
Description
The flushband function
flushes the specified type of messages
that are associated with the specified priority band.
Arguments
q-
Pointer to the queue.
pri-
Priority band of messages to be flushed.
If pri is 0,
only normal priority (band 0) messages are flushed.
Otherwise, messages are flushed from the band pri.
flag-
Determines messages to flush.
Valid values are:
FLUSHDATA-
Flush only data messages.
FLUSHALL-
Flush all messages.
Return values
None
Usage
The data message types that are flushed
if FLUSHDATA is specified are
M_DATA(D7str),
M_DELAY(D7str),
and
M_PROTO(D7str)
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.
Context
Base or Interrupt.
Synchronization constraints
Does not block.
Driver-defined basic locks, read/write locks, and sleep locks
may be held across calls to this function.
For DDI drivers,
the caller cannot have the stream frozen
(see
freezestr(D3str))
when calling this function.
Examples
See
put(D2str)
for an example of flushband.
Hardware applicability
All
Version applicability
ddi:
1, 2, 3, 4, 5, 5mp, 6, 6mp, 7, 7mp, 7.1, 7.1mp, 8, 8mp
oddi:
1, 2, 2mp, 3, 3mp, 4, 4mp, 5, 5mp, 6, 6mp
References
flushq(D3str),
put(D2str),
queue(D4str)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005