File	Date	Author	Commit
Build.txt	2016-04-20	sunmingbao	[8f5ae8] v2.0.2
COPYING.txt	2015-03-22	sunmingbao	[ecb912] 修正几处代码排版问题，更新相关说明文件，同时将说明文件转换为UTF-8编码。
README.txt	2016-04-20	sunmingbao	[8f5ae8] v2.0.2
release_notes.txt	2016-04-20	sunmingbao	[8f5ae8] v2.0.2
soft_wdt.c	2016-04-20	sunmingbao	[8f5ae8] v2.0.2

Read Me

		soft_wdt软件看门狗简介
		
======================

    soft_wdt(以下简称本软件)是一个软件实现的Linux看门狗，
    他和/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(注意，是大写)的数据时，
       就将此看门狗设置成了可关闭的。

下面具体说说使用方法：

(一)编译看门狗
    见Build.txt

(二)加载看门狗

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

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

注意，core dump是通过向异常线程发送SIGABRT信号实现的。
因此，如果使用看门狗的程序，想自己记录异常信息，可以通过捕获SIGABRT信号来实现。

    下面是加载命令的示例。

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

    2. 指定参数加载(12秒超时，看门狗可关闭，超时不重启机器)
    insmod soft_wdt.ko timeout=12 nowayout=0 no_reboot=1

(三)用户态程序使用看门狗

//以下是示例代码

#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 feed_dog_cnt;
int feed_dog_gap;

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

    if (argc<3)
    {
        printf("usage:\n %s  <feed_gap(in seconds)>  <feed_cnt>\n", argv[0]);
        return 0;
    }
    
    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_gap = atoi(argv[1]);
    feed_dog_cnt = atoi(argv[2]);
    for (i=0; i<feed_dog_cnt; i++)
    {
        printf("feed dog\n");
        write(fd, "1234", 4);
        usleep(feed_dog_gap*1000000);
    }

    printf("stop feeding dog\n");
    while (1)
    {
        usleep(1000000);
    }
    
    return 0;
}



======================

    本软件是一款开源、免费软件。
    具体版权说明见COPYING.txt。

======================

主要的版本历史：

2014年11月，1.0发布
2015年03月，2.0发布
====================== 
作者: 孙明保(来自 ZTE中兴)
邮箱: sunmingbao@126.com
QQ  : 7743896