watchdogd(8)

watchdogd8

Watchdog timer retrigger daemon

Usage

watchdogd [-dnq] [-i interval] [-p period]

Overview

watchdogd is a daemon to activate and periodically retrigger the watchdog(4) timer device from userland. watchdogd is designed to work in high load environments, where other methods (such as a shell script invoking sysctl(8)) would involve too much overhead.

The basic premise is that after every interval seconds, watchdogd resets the hardware timer to period. See also watchdog(4) for more information on how watchdog timers work.

The options are as follows:

-d

Do not daemonize. If this option is specified, watchdogd will run in the foreground.

-i interval

Specify how often, in seconds, watchdogd should retrigger the hardware timer. If no interval is specified, the value of period (see below) divided by three is used.

-n

Do not restore the watchdog to its original values once it has been activated. With this set, the system will be rebooted by the watchdog even after a halt(8).

-p period

Set the hardware timer to expire in period seconds. The default is 30 seconds.

-q

Be quiet. With this option specified, watchdogd will not output a warning message if the underlying hardware adjusted the timeout period.

Releases

44 releases since OpenBSD 3.8; the text changed 5 times.

  1. 3.8
  2. 3.9
  3. 4.0
  4. 4.1
  5. 4.2–5.3
  6. 5.4–8.0

-n since OpenBSD 4.1; -q since OpenBSD 4.0.

History

The watchdogd program first appeared in OpenBSD 3.8.

Authors

watchdogd was written by Marc Balmer ⟨[email protected]⟩.

From man 8.0-current-20261101 in OpenBSD 8.0-current (2026-11-01). Parsed by carta from the page's mdoc source.