Using The Watchdog Timer; Setting The Timeout Period; Enabling Or Disabling The Watchdog - Sun Microsystems Netra T2000 Administration Manual

Using the Watchdog Timer

Setting the Timeout Period

The LOMIOCDOGTIME IOCTL sets the timeout period of the watchdog. This IOCTL
programs the watchdog hardware with the time specified in this IOCTL. You must
set the timeout period (LOMIOCDOGTIME) before attempting to enable the watchdog
timer (LOMIOCDOGCTL).
The argument is a pointer to an unsigned integer. This integer holds the new timeout
period for the watchdog in multiples of 1 second. You can specify any timeout
period in the range of 1 second to 180 minutes.
If the watchdog function is enabled, the time-out period is immediately reset so that
the new value can take effect. An error (EINVAL) is displayed if the timeout period
is less than 1 second or longer than 180 minutes.
Note – The LOMIOCDOGTIME is not intended for general-purpose use. Setting the
watchdog time-out to too low a value might cause the system to receive a hardware
reset if the watchdog and reset functions are enabled. If the timeout is set too low,
the user application must be run with a higher priority (for example, as a real-time
thread) and must be rearmed more often to avoid an unintentional expiration.

Enabling or Disabling the Watchdog

The LOMIOCDOGCTL IOCTL enables or disables the watchdog, and it enables or
disables the reset capability. See "Finding and Defining Data Structures" on page 90
for the correct values for the watchdog timer.
The argument is a pointer to the lom_dogctl_t structure. This structure is
described in greater detail in "Finding and Defining Data Structures" on page 90.
Use the reset_enable member to enable or disable the system reset function. Use
the dog_enable member to enable or disable the watchdog function. An error
(EINVAL) is displayed if the watchdog is disabled but reset is enabled.
Note – If LOMIOCDOGTIME has not been issued to set up the timeout period prior to
this IOCTL, the watchdog is not enabled in the hardware.
Appendix A Watchdog Timer Application Mode 89