Linux内核 timespec_add_ns()

timespec_add_ns()函数实现timespec结构体变量与整数的相加，无符号整数表示的是纳秒数，结果保存在结构体变量中。

文件包含：

#include<linux/time.h>
 

函数定义：

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

函数定义格式：

  

   

    

     

    
    

     

      static __always_inline void timespec_add_ns(struct timespec *a, u64 ns)
     
    
   

    

     

    
    

     

      {
     
    
   

    

     

    
    

     

              a->tv_sec += __iter_div_u64_rem(a->tv_nsec + ns, NSEC_PER_SEC, &ns);
     
    
   

    

     

    
    

     

              a->tv_nsec = ns;
     
    
   

    

     

    
    

     

      }
     
    
  
 

输入参数说明：

• 该函数的第一个参数是一个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。

• 该函数的第二个参数是一个64位的无符号整数，表示的是纳秒，与第一个参数的字段tv_nsec相加，结果大于999999999则向结构体的字段tv_sec进位。

返回参数说明：

• 此函数没有返回值，相加的结果保存在结构体变量中，__always_inline代表该函数始终是内联的且不能调用其他的内核函数。

实例解析：

编写测试文件：timespec_add_ns.c

头文件引用：

  

   

    

     

    
    

     

      #include <linux/module.h>
     
    
   

    

     

    
    

     

      #include<linux/time.h>
     
    
   

    

     

    
    

     

      MODULE_LICENSE("GPL");
     
    
  
 

模块加载函数定义：

  

   

    

     

    
    

     

      int timespec_add_ns_init(void)
     
    
   

    

     

    
    

     

      {
     
    
   

    

     

    
    

     
    printk("timespec_add_ns begin.\n");
     
    
   

    

     

    
    

     
    // 声明变量，函数的第一个参数
     
    
   

    

     

    
    

     
    struct timespec ts={
     
    
   

    

     

    
    

     

              .tv_sec=1,
     
    
   

    

     

    
    

     

              .tv_nsec=1
     
    
   

    

     

    
    

     

          };
     
    
   

    

     

    
    

     

          u64 ns=1000000001;                     //64位无符号整数，函数的第二个参数
     
    
   

    

     

    
    

     
    printk("the value of the timespec before timespec_add_ns\n");
     
    
   

    

     

    
    

     
    printk("the tv_sec of the timespec is:%ld\n", ts.tv_sec); //显示参与加之前的数据
     
    
   

    

     

    
    

     
    printk("the tv_nsec of the timespec is:%ld\n", ts.tv_nsec);
     
    
   

    

     

    
    

     
    printk("the add ns is:%lld\n", ns);
     
    
   

    

     

    
    

     
    timespec_add_ns(&ts, ns);              //调用函数实现结构体变量与加整数的相加
     
    
   

    

     

    
    

     
    printk("the value of timespec after the timespec_add_ns :\n");
     
    
   

    

     

    
    

     
                                           //显示参与加之后的数据
     
    
   

    

     

    
    

     
    printk("the new tv_sec of the timespec is:%ld\n", ts.tv_sec);
     
    
   

    

     

    
    

     
    printk("the new tv_nsec of the timespec is:%ld\n", ts.tv_nsec);
     
    
   

    

     

    
    

     
    printk("timespec_add_ns over.\n");
     
    
   

    

     

    
    

     
    return 0;
     
    
   

    

     

    
    

     

      }
     
    
  
 

模块退出函数定义：

  

   

    

     

    
    

     

      void timespec_add_ns_exit(void)
     
    
   

    

     

    
    

     

      {
     
    
   

    

     

    
    

     
    printk("Goodbye timespec_add_ns\n");
     
    
   

    

     

    
    

     

      }
     
    
  
 

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

  

   

    

     

    
    

     

      module_init(timespec_add_ns_init);
     
    
   

    

     

    
    

     

      module_exit(timespec_add_ns_exit);
     
    
  
 

实例运行结果及分析：

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

结果分析：

• 由图可以看出函数timespec_add_ns()的作用如前面所述，能够实现timespec结构体变量与无符号整数的相加，结果保存在timespec结构体变量中。

文章来源: allen5g.blog.csdn.net，作者：CodeAllen嵌入式编程，版权归原作者所有，如需转载，请联系作者。

原文链接：allen5g.blog.csdn.net/article/details/127018074