1=head1 NAME
2
3xenwatchdogd - Xen hypercall based watchdog daemon
4
5=head1 SYNOPSIS
6
7B<xenwatchdogd> [ I<OPTIONS> ] <I<TIMEOUT>> [ <I<SLEEP>> ]
8
9=head1 DESCRIPTION
10
11B<xenwatchdogd> arms the Xen watchdog timer to I<TIMEOUT> every I<SLEEP>
12seconds. If the xenwatchdogd process dies or is delayed for more than
13I<TIMEOUT> seconds, then Xen will take the B<on_watchdog> action
14specified in the domain configuration (see xl.cfg(5)). If B<xenwatchdogd>
15is running in dom0, the whole system will reboot.
16
17=head1 OPTIONS
18
19=over 4
20
21=item B<-h>, B<--help>
22
23Display a help message.
24
25=item B<-F>, B<--foreground>
26
27Run in the foreground. The default behaviour is to daemonize.
28
29=item B<-x>, B<--safe-exit>
30
31Disable watchdog on orderly exit. The default behaviour is to arm the
32watchdog to 300 seconds to allow time for the domain to shutdown.  See
33also the B<SIGNALS> section.
34
35=item B<timeout>
36
37The number of seconds to arm the Xen watchdog timer. This must be set to
38a minimum of two.
39
40=item B<sleep>
41
42The number of seconds to sleep in between calls to arm the Xen watchdog
43timer. This must be at least one second, and less than the I<timeout>
44value. If not specified, it defaults to half the I<timeout> value.
45
46=back
47
48=head1 SIGNALS
49
50B<SIGUSR1> Will cause the program to disarm the watchdog timer and exit,
51regardless of whether the B<--safe-exit> option was passed.
52
53=head1 AUTHOR
54
55Citrix Ltd and other contributors.
56