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)