User Tools
Sidebar
Table of Contents
clear_watchdog
WMPRO, WMMINI FW >= 1.1112 WMMEGA FW >= 2.1113
Clear the software watchdog timer
Description
Clears the watchdog timer. This auto-increments in firmware once per second and when it reaches the preset threshold the Wattmon will reboot. This is implemented to prevent issues if long running scripts block the system.
Parameters
None
Return Values
None
Example
<? clear_watchdog(); // reset the counter to zero ?>
Additional Information
Function clear_watchdog is called from cronmin.cgi once per minute (WattmonOS 2.26 and above). The default threshold value is 300 seconds (5 minutes), therefore, if cronmin.cgi does not complete at least once during 5 minutes the system will reboot.
Function init_watchdog can be called to set the threshold in seconds for when the firmware reboots the system (if function clear_watchdog has not been called during this time). Alternatively the value set by init_watchdog can be loaded at startup by adding the watchdog_interval key in the debug section of config/uphp.ini, example for 10 minutes:
[debug] watchdog_interval=600 ...
This function must be used if you are writing a script that might run longer than 5 minutes, which could possibly keep cronmin.cgi from being able to run, depending on how many scripts can run at the same time. Or it might be needed if the default cronmin.cgi is not used.
Also See
init_watchdog() - Initialize the software watchdog timer
