Linux内核API timespec_sub

函数timespec_sub()将两个timespec类型的变量作减法，结果保存在一个新的timespec类型的变量中。

timespec_sub文件包含

#include<linux/time.h>

timespec_sub函数定义

在内核源码中的位置：linux-3.19.3/include/linux/time.h

函数定义格式：

static inline struct timespec timespec_sub(struct timespec lhs, struct timespec rhs)
{
    struct timespec ts_delta;
    set_normalized_timespec(&ts_delta, lhs.tv_sec - rhs.tv_sec, lhs.tv_nsec - rhs.tv_nsec);
    return ts_delta;
}

timespec_sub输入参数说明

• 此函数的参数都是struct timespec类型的结构体变量，定义见文件linux-3.19.3/include/uapi/linux/time.h，其定义如下：

struct timespec {
    __kernel_time_t         tv_sec;                  /* 秒数 */
    long                    tv_nsec;                 /* 纳秒数*/
};

• 该结构体是表示时间的一种方法，字段tv_sec表示的是秒数，字段tv_nsec表示不足一秒部分的时间，用纳秒表示，在此的有效取值范围是0～999999999。

timespec_sub返回参数说明

• 函数timespec_sub()的返回值与其输入的参数的类型相同，代表两个输入参数代表的时间差。

timespec_sub实例解析

编写测试文件：timespec_sub.c

头文件引用：

#include <linux/module.h>
#include<linux/time.h>
MODULE_LICENSE("GPL");

模块加载函数定义：

int __init timespec_sub_init(void)
{
    struct timespec ts_sub;        //用于保存函数timespec_sub()的返回结果
    /*定义两个timespec类型的变量，作为函数的参数*/
    struct timespec lhs=
    {
        .tv_sec=10,
        .tv_nsec=110
    };
    struct timespec rhs=
    {
        .tv_sec=9,
        .tv_nsec=100
    };
    printk("timespec_sub begin.\n");
    ts_sub=timespec_sub(lhs, rhs);        //两个时间相减，结果仍是timespec类型的变量
    printk("the value of struct timespec after the timespec_sub:\n");
                                          // 显示时间相减的结果
    printk("the tv_sec value is:%ld\n", ts_sub.tv_sec);
    printk("the tv_nsec value is:%ld\n", ts_sub.tv_nsec);
    printk("timespec_sub over.\n");
    return 0;
}

模块退出函数定义：

void __exit timespec_sub_exit(void)
{
    printk("Goodbye timespec_sub\n");
}

模块加载、退出函数调用：

module_init(timespec_sub_init);
module_exit(timespec_sub_exit);

实例运行结果及分析：

执行命令insmod timespec_sub.ko插入模块，然后输入命令dmesg -c查看系统输出信息，出现如图所示结果。

结果分析：

函数timespec_sub()返回的结果表示的时间的秒数是1，纳秒数是10，为了说明结果的正确性，将返回结果表示的时间与函数的第二个参数表示的时间相加，然后与函数的第一个输入参数表示的时间相比较，判断是否相同即可，在此可以说明此验证程序的输出结果是正确的。