untimeout Kernel Service

Attention: This service must not be used because it is not multi-processor safe. The base kernel timer and watchdog services must be used instead. See talloc and w_init for more information.

Purpose

Cancels a pending timer request.

Syntax

#include <sys/types.h>
#include <sys/errno.h>

void untimeout ( func, arg) void (*func)(); caddr_t *arg;

Parameters

Item	Description
func	Specifies the function that is associated with the timer to be canceled.
arg	Specifies the function argument that is associated with the timer to be canceled.

Description

The untimeout kernel service is not part of the kernel. However, it is a compatibility service that is provided in the libsys.a library. To use the untimeout service, a kernel extension must be bound with the libsys.a library. The untimeout service, like the associated kernel libsys services timeoutcf and timeout, can be bound and used only in the pinned part of a kernel extension or the bottom half of a device driver because these services use interrupt disable for serialization.

The untimeout kernel service cancels a specific request that is made with the timeout service. The func and arg parameters must match the parameters that are used in the timeout kernel service request that is to be canceled.

Upon return, the specified timer request is canceled, if found. If no timer request matches the func and arg parameters, no operation is performed.

Execution Environment

The untimeout kernel service can be called from either the process or interrupt environment.

Return Values

The untimeout kernel service has no return values.