.IX \f4untimeout\fP(D3DK)

NAME

untimeout − cancel previous timeout request

SYNOPSIS

#include <sys/types.h>
void untimeout(toid_t id);

ARGUMENTS

idIdentifier returned from a previous call to dtimeout(D3DK) or itimeout(D3DK). 

DESCRIPTION

untimeout cancels a pending timeout request.  If the untimeout is called while the function is running, then untimeout will not return until the function has completed.  The function that runs as a result of a call to dtimeout or itimeout cannot use untimeout to cancel itself. 

RETURN VALUE

None. 

LEVEL

Base or Interrupt, with the following exception: The untimeout can only be performed from interrupt levels less than, or equal to, the level specified when the function was scheduled. 

NOTES

Does not sleep. 

Driver-defined basic locks, read/write locks, and sleep locks may not be held across calls to this function if these locks are contended by the function being canceled. 

SEE ALSO

delay(D3DK), dtimeout(D3DK), itimeout(D3DK), unbufcall(D3DK)

EXAMPLE

See unbufcall(D3DK) for an example of untimeout. 

DDI/DKI