QUNBUFCALL(9F) Kernel Functions for Drivers QUNBUFCALL(9F)

NAME

qunbufcall - cancel a pending qbufcall request

SYNOPSIS

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


void qunbufcall(queue_t *q, bufcall_id_t id);

INTERFACE LEVEL

illumos DDI specific (illumos DDI).

PARAMETERS

q
Pointer to STREAMS queue_t structure.


id
Identifier returned from qbufcall(9F).

DESCRIPTION

The qunbufcall() function cancels a pending qbufcall() request. The
argument id is a non-zero identifier of the request to be cancelled. id
is returned from the qbufcall() function used to issue the cancel
request.


The qunbufcall() function is tailored to be used with the enhanced
STREAMS framework interface which is based on the concept of perimeters.
(See mt-streams(9F).) qunbufcall() returns when the bufcall has been
cancelled or finished executing. The bufcall will be cancelled even if it
is blocked at the perimeters associated with the queue. All outstanding
timeouts and bufcalls must be cancelled before a driver close routine can
block and before the close routine calls qprocsoff(9F).

CONTEXT

The qunbufcall() function can be called from user, interrupt, or kernel
context.

SEE ALSO

mt-streams(9F), qbufcall(9F), qtimeout(9F), quntimeout(9F)


Writing Device Drivers


STREAMS Programming Guide

January 16, 2006 QUNBUFCALL(9F)