MirOS Manual: wdt(4)

WDT(4)                  BSD Programmer's Manual (i386)                  WDT(4)

NAME

     wdt - ICS PCI-WDT500/501 watchdog timer device driver

SYNOPSIS

     wdt0 at pci? dev ? function ?
     option WDT_DISABLE_BUZZER

DESCRIPTION

     The wdt driver provides support for the Industrial Computer Source PCI-
     WDT500 and PCI-WDT501 boards.

     For PCI-WDT500 boards, basic watchdog timer functionality is supported.
     For PCI-WDT501 boards, additional access to the onboard buzzer, isolated
     inputs, temperature, and power supply monitors is provided. To disable
     the onboard buzzer on PCI-WDT501 boards, add option WDT_DISABLE_BUZZER to
     your kernel configuration.

     By default the watchdog timer is set to 30 seconds and is refreshed by
     the kernel's timeout processing. If the kernel crashes, the watchdog ti-
     mer is not reset and the system will reboot (assuming a proper connection
     is made between the WDT50x and motherboard). Alternatively, the watchdog
     can be reinitialized via a userland process which ensures that process
     scheduling, not just kernel timeout processing, is still taking place.
     See the WIOCSCHED ioctl(2) below for more information.

INTERFACE

     The wdt driver is controlled via ioctl(2) calls to /dev/wdt0. The follow-
     ing commands are supported:

     WIOCGETSTATE  Returns the current temperature and board status into the
                   wdt_state structure pointer passed to ioctl(2). See
                   <dev/pci/wdt50x.h> for the definition of the wdt_state
                   structure and state bits.

     WIOCSCHED     Places the process into an infinite loop (interrupted only
                   via a signal) to guarantee process scheduling. The driver
                   utilizes the process' context to reinitialize the watchdog
                   timeout. Should process scheduling fail, the timeout will
                   not be reinitialized and the system will be rebooted. Note
                   that it is possible to force a reboot by sending a SIGSTOP
                   signal to a process in WIOCSCHED and waiting for the watch-
                   dog timer to expire. Since WIOCSCHED can have such dramatic
                   consequences, it may only be issued by superuser processes
                   regardless of the permissions on /dev/wdt0.

FILES

     /dev/wdt0                      watchdog control device
     /usr/include/dev/pci/wdt50x.h  structure and ioctl definitions

SEE ALSO

     ioctl(2), intro(4), pci(4)

HISTORY

     The wdt driver first appeared in OpenBSD 2.6.

BUGS

     The ioctl interface isn't generic.

     It's unwise to combine wdt with ddb(4) since the latter may prevent the
     former from resetting the watchdog timeout before it expires.

MirOS BSD #10-current           April 25, 1999                               1

Generated on 2014-07-04 21:17:45 by $MirOS: src/scripts/roff2htm,v 1.79 2014/02/10 00:36:11 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2014 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.