hpux man page for quntimeout

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

NAME

       quntimeout - cancel previous qtimeout function call

SYNOPSIS

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

       clock_t quntimeout(queue_t *q, timeout_id_t id);

INTERFACE LEVEL

       Solaris DDI specific (Solaris DDI).

PARAMETERS

       q	Pointer to a STREAMS queue structure.

       id	Opaque timeout ID a previous qtimeout(9F) call.

DESCRIPTION

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

RETURN VALUES

       quntimeout() returns -1 if the id is not found. Otherwise, quntimeout() returns a 0 or positive value.

CONTEXT

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

SEE ALSO

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

       Writing Device Drivers

       STREAMS Programming Guide

SunOS 5.10							    17 Oct 2002 						    quntimeout(9F)