一个软件实现的Linux看门狗—soft_wdt

 soft_wdt（以下简称本软件）是一个软件实现的Linux看门狗。

soft-wdt_v2.zip

    本软件是一款开源、免费软件。

    下载地址：

    本软件和/drivers/watchdog/softdog.c实现的软件看门狗几乎一样。
    主要的不同点是，前者支持一个看门狗，本软件则支持大量的看门狗。


    soft_wdt代码编译后，生成一个内核模块soft_wdt.ko。


    模块加载后，将创建一个设备文件/dev/soft_wdt


    用户态程序，通过系统调用open每打开一次/dev/soft_wdt，就得到一个新的看门狗，
    此看门狗的使用方法就和普通的看门狗一样。


    例如:
    1) 向fd写入任何数据，就等于是喂狗。
    2) 用户可以通过ioctl对看门狗进行各种操作。
    3) 如果模拟加载时，模块参数nowayout的值为0，
       那么当用户向fd写入一次含有字符V(注意，是大写)的数据时，
       就将此看门狗设置成了可关闭的。


    本软件提供的模块参数有：
    nowayout           - 一旦启动看门狗，不可以停止 (0，no；1，yes。default=1)
    timeout            - 看门狗超时时间，单位：秒。 (0 ~ 65536, default=5)
    no_reboot          - 看门狗超时，不重启系统 。(0，no; 1，yes  default=0)
    core_dump_ill_task - 看门狗超时时，core dump异常进程，(0，no; 1，yes  default=0)

下面介绍一下此软件的编译及使用方法

(一)模块编译


方法一、单独编译


    在soft_wdt源码目录下，执行如下命令即可
    make -C /path/to/kernel/source/dir M=`pwd` modules


方法二、在Linux内核编译体系中编译


    1. 拷贝soft_wdt.c到drivers/watchdog/目录下。
    
    2. 将下面这行代码，追加到内核源码的drivers/watchdog/Makefile中(在Architecture Independant部分)
    obj-$(CONFIG_SOFT_WDT) += soft_wdt.o
    
    3. 将下面的内容追加到内核源码的drivers/watchdog/Kconfig中(在Architecture Independant部分)


config SOFT_WDT
tristate "software watchdog timer (multiple dogs)"
default m
help
 A software watchdog driver, supporting multiple dogs.
 Each time, user opens the device file(/dev/soft_wdt),
 a new dog was created, associated with the fd returned
 by the open system call. The usage of each dog is just
 the same as ordinary watchdog, including MAGIC CLOSE.
 Currently the driver supports a maximum of 128 dogs.


 To compile this driver as a module, choose M here: the
 module will be called soft_wdt.


    4. 执行make menuconfig进入watchdog驱动程序的选择界面，然后直接退出，并保存配置。
    
    5. 执行make modules，然后在drivers/watchdog/目录下，就会生成模块文件soft_wdt.ko


(二)模块加载


    本软件提供的模块参数如下。用户可根据需要进行指定。


    nowayout           - 一旦启动看门狗，不可以停止 (0，no；1，yes。default=1)
    timeout            - 看门狗超时时间，单位：秒。 (0 ~ 65536, default=5)
    no_reboot          - 看门狗超时，不重启系统 。(0，no; 1，yes  default=0)
    core_dump_ill_task - 看门狗超时时，core dump异常进程，(0，no; 1，yes  default=0)


    下面是加载命令。


    1. 使用默认参数加载(默认值如上面所列)
    insmod soft_wdt.ko


    2. 指定参数加载(12秒超时，且看门狗可关闭)
    insmod soft_wdt.ko timeout=12 nowayout=0


(三)用户态程序使用看门狗示例代码

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <string.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <sys/ioctl.h>
#include <linux/watchdog.h>

#define    SOFT_WDT_DEV "/dev/soft_wdt"

int main(int argc, char *argv[])
{
    int i;
    struct watchdog_info    ident;
    int timeout;

    int fd=open("/dev/soft_wdt", O_WRONLY);

    if (fd < 0)
    {
        printf("open %s failed\n", SOFT_WDT_DEV);
        exit(1);
    }

    printf("open %s succeed\n", SOFT_WDT_DEV);

    timeout = 7;
    printf("set timeout to %d\n", timeout);
    ioctl(fd, WDIOC_SETTIMEOUT, &timeout);

    timeout = 0;
    ioctl(fd, WDIOC_GETTIMEOUT, &timeout);
    printf("get timeout returns %d\n", timeout);

    ioctl(fd, WDIOC_GETSUPPORT, &ident);
    printf("dog name is %s\n", ident.identity);

    printf("make the dog closable\n");
    write(fd, "V", 1);

    /* feed dog */
    for (i=0; i<100; i++)
    {
        write(fd, "1234", 4);
        usleep(1000000);
    }

    close(fd);
    return 0;
}