quntimeout(9f)

1quntimeout(9F)           Kernel Functions for Drivers           quntimeout(9F)
2
3
4

NAME

6       quntimeout - cancel previous qtimeout function call
7

SYNOPSIS

9       #include <sys/stream.h>
10       #include <sys/ddi.h>
11
12
13
14       clock_t quntimeout(queue_t *q, timeout_id_t id);
15
16

INTERFACE LEVEL

18       Solaris DDI specific (Solaris DDI).
19

PARAMETERS

21       q     Pointer to a STREAMS queue structure.
22
23
24       id    Opaque timeout ID a previous qtimeout(9F) call.
25
26

DESCRIPTION

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

RETURN VALUES

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

CONTEXT

44       The quntimeout() function can be called from user, interrupt, or kernel
45       context.
46