Table of Contents

clear_watchdog

WMPRO, WMMINI FW >= 1.1112 WMMEGA FW >= 2.1113

Clear the software watchdog timer

Description

clear_watchdog ( )

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