Print newlines between times/pings.
[watchdog-test-framework.git] / README
1 This is a simple framework for testing the qemu watchdog virtual
2 device.  It's easier to use this framework than running the whole
3 watchdog daemon.
4
5 Written by Richard W.M. Jones <rjones@redhat.com>.
6
7 License: GPLv2+
8
9 Instructions for use:
10
11 (1) Compile this program.  It creates a statically linked Linux binary
12 called 'watchdog-test'.
13
14 (2) You will need an existing Linux guest.
15
16 (3) Change the configuration of the Linux guest to add a watchdog
17 device.
18
19 If using libvirt, add a clause in the <devices> section:
20
21     <watchdog model='i6300esb' action='poweroff' />
22
23 If using qemu directly, use the following command line options:
24
25   qemu-kvm ... -watchdog i6300esb -watchdog-action poweroff
26
27 model can be either 'i6300esb' or 'ib700'.
28
29 action can be: 'reset', 'shutdown', 'poweroff', 'pause',
30 'none' or 'dump'
31
32 (4) Install the statically linked watchdog-test binary in the Linux
33 guest.
34
35 (5) Boot up the guest.  Log into the guest.
36
37 (6) [ib700 only] You have to load the ib700wdt kernel module manually
38 since it's an ISA device:
39
40   sudo modprobe ib700wdt
41
42 (7) Run the watchdog-test binary (as root), and follow instructions.