[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 1

w_stop Kernel Service


Stops a watchdog timer.


#include <sys/types.h>
#include <sys/errno.h>
#include <sys/watchdog.h>
void w_stop (w)
struct watchdog *w;


w Specifies the watchdog timer structure.


The watchdog timer services, including the w_stop kernel service, are typically used to verify that an I/O operation completes in a reasonable time. The w_start and w_stop kernel services are designed to allow the timer to be started and stopped efficiently. The kernel decrements the w->count watchdog count every second. The kernel calls the w->func watchdog timer function when the w->count watchdog count reaches 0. A watchdog timer is ignored when w->count is less than or equal to 0.

Attention: The watchdog structure must be pinned when the w_stop kernel service is called. It must remain pinned until after the call to the w_clear kernel service. During this time, the watchdog structure must not be altered except by the watchdog services.

Execution Environment

The w_stop kernel service can be called from the process and interrupt environments.

Return Values

The w_stop kernel service has no return values.

Implementation Specifics

The w_stop kernel service is part of Base Operating System (BOS) Runtime.

Related Information

The w_clear kernel service, w_init kernel service, w_start kernel service.

Timer and Time-of-Day Kernel Services in AIX Kernel Extensions and Device Support Programming Concepts.

[ Previous | Next | Contents | Home | Search ]