WATCHDOGCTL(1) (smm)
WATCHDOGCTL(1) General Commands Manual (smm) WATCHDOGCTL(1)

NAME

watchdogctlStatus and control tool for watchdogd

SYNOPSIS

watchdogctl [-hvV] [-c CODE] [-p PID] [clear] [disable | enable] [debug] [loglevel LEVEL] [reload] [reset [MSEC] [MSG]] [fail [MSEC] [MSG]] [status] [test [TEST]]

DESCRIPTION

watchdogctl provides a safe way of querying status and controlling watchdogd(8).

OPTIONS

-c, --code CODE
Reset reason codes for fail command:
1
System OK
2
PID failed subscribing
3
PID failed kick
4
PID failed unsubscribing
5
PID failed to meet its deadline
6
Forced reset
7
Failed, unknown
8
File descriptor leak
9
Memory leak
10
CPU overload
Codes can also be listed at runtime with: -c help
-h, --help
Show help message.
-p, --pid PID
PID to use for fail and reset command.
-v, --verbose
Enable verbose mode, otherwise commands are silent.
-V, --version
Show version information.

COMMANDS

Short forms of the below commands are allowed, as long as it is unique.
clear
Clear reset reason.
counter
Show reset counter, number of reboots since power-on.
debug
Toggle daemon debug log level. See also the loglevel command.
disble | enable
Temporarily disable, or enable, daemon.
loglevel LEVEL
Adjust daemon log level: none, err, warn, notice, info, debug.
reload
Reload daemon configuration file, like sending SIGHUP, but the command does not return until watchdogd has completed.
reboot [MSEC] [MSG]
Alias to reset.
reset [MSEC] [MSG]
Perform system reset, with an optional millisecond delay and an optional message to be stored as the reset reason label (usually process name). A zero MSEC argument is the same as omitting the argument, leading to an immediate reset. On systems with finit(8), watchdogd will ask Finit to do an orderly shutdown (stop services, sync and unmount all file systems) before performing the WDT reset.
fail [MSEC] [MSG]
Like the reset command, records reset reason (see above -c -CODE) but does not reboot unless MSEC is given. I.e., omitting the MSEC argument does not have the same effect as in the reset command.
status
Query status of daemon and show last reset reason, default command.
test [TEST]
Run built-in tests of process supervisor functionality in daemon. These tests can be disabled at build time, so they may not be available in the installed watchdogctl. The default test, if none is selected, runs the complete cycle. You may want to run these tests with the --verbose option to enable output.
complete-cycle
Verify subscribe, kick, and unsubscribe (no reboot)
disable-enable
Verify WDT disable, and re-enable (no reboot)
false-ack
Verify kick with invalid ACK (reboot)
false-unsubscribe
Verify unsubscribe with invalid ACK (reboot)
failed-kick
Verify reboot on missing kick (reboot)
no-kick
Verify reboot on missing first kick (reboot)
premature-trigger
Verify no premature trigger before unsubscribe (reboot)
version
Show program version.

FILES

/etc/watchdogd.conf
Daemon configuration file. Read once when starting up and on SIGHUP or reload command.
/run/watchdogd.status
Read to present WDT status and reset reason
/run/watchdogd.sock
Used to connect to watchdogd

SEE ALSO

watchdogd(8) watchdogd.conf(5)

AUTHORS

watchdogd is an improved version of the original, created by Michele d'Amico and adapted to uClinux-dist by Mike Frysinger. It is maintained by Joachim Nilsson at GitHub.
January 10, 2020 Debian