[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Communications, Volume 2


I_FLUSHBAND streamio Operation

Purpose

Flushes all messages from a particular band.

Description

The I_FLUSHBAND operation flushes all messages of a given priority band from all input or output queues. The arg parameter points to a bandinfo structure that contains the following elements:

unsigned char   bi_pri;
int             bi_flag;

The elements are defined as follows:

bi_pri Specifies the band to be flushed.
bi_flag Specifies the queues to be pushed. Legal values for the bi_flag field are:

FLUSHR
Flush read queues.

FLUSHW
Flush write queues.

FLUSHRW
Flush read and write queues.

Error Codes

If unsuccessful, the errno global variable is set to one of the following values:

ENOSR Unable to allocate buffers for flush message due to insufficient STREAMS memory resources.
EINVAL Invalid value for the arg parameter.
ENXIO Hangup received on the fildes parameter.

Implementation Specifics

This operation is part of STREAMS Kernel Extensions.

Related Information

The streamio operations.

The I_FLUSH streamio operation.

The flushband utility, flushq utility.


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]