STREAMS-UX Programmer's Guide (February 2007)

STREAMS Utilities Supported by HP-UX

Appendix B

173

NAME

flushband () – Flushes the messages specified in the priority band.

SYNOPSIS

#include <sys/stream.h> #include <sys/stropts.h>

void flushband (queue_t *q, unsigned char pri, int flag);

PARAMETERS

Queue pointer

pri

Priority band to be flushed

flag

Determines the type of the messages to be flushed. Valid flag values are:

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

FLUSHALL Flush all messages.

DESCRIPTION

flushband() allows modules and drivers to flush messages from a specified priority band. A

pri

value of 0

will flush ordinary messages. Note that as a result of flushing messages, if the messages in the band fall

below the band’s low watermark, and if a previous module was attempting to write to this queue, then the

previous service procedure will be enabled.

RETURN VALUES

None

CONSTRAINTS

flushband() can be called from thread or interrupt context. Only spinlocks of STREAMS/UX user lock order

can be held across this call.