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

     Solaris DDI specific (Solaris DDI).

PARAMETERS

     q     Pointer to STREAMS queue_t structure.

     id    Identifier returned from qbufcall(9F)

DESCRIPTION

     qunbufcall() cancels a pending qbufcall() request. The argu-
     ment  id  is a non-zero identifier of the request to be can-
     celled. 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 exe-
     cuting. 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

     qunbufcall() can be called from user or interrupt context.

SEE ALSO

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

     Writing Device Drivers

     STREAMS Programming Guide