Assign a value representing a duration that is longer than the time it takes to reboot
and perform a crash dump. If the specified value is not large enough, the system
controller resets the host if reset is enabled. Note that this reset by the system
controller occurs only once.
Understanding the User API
The ntwdt driver provides an application programming interface by using IOCTLs.
You must open the /dev/ntwdt device node before issuing the watchdog IOCTLs.
Note – Only a single instance of open() is allowed on /dev/ntwdt. More than one
instance of open() will generate the following error message: EAGAIN – The
driver is busy, try again.
You can use the following IOCTLs with the watchdog timer:
LOMIOCDOGTIME
■
■
LOMIOCDOGCTL
■
LOMIOCDOGPAT
LOMIOCDOGSTATE
■
LOMIOCALSTATE
■
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.
78
Sun Netra T5440 Server Administration Guide • April 2010