Linux内核API atomic_add_unless

函数atomic_add_unless()通过调用函数__atomic_add_unless()实现其功能。在原子类型的变量v的值不为u的时候将整型值a加到v上,如果起初v的值即与u相等,则v将不执行加a操作。

atomic_add_unless文件包含

#include <linux/atomic.h>

atomic_add_unless函数定义

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

函数定义格式:

static inline int atomic_add_unless(atomic_t *v, int a, int u)

atomic_add_unless输入参数说明

  • v:原子类型变量指针。关于原子类型atomic_t的定义参考atomic_set()函数的分析。
  • a:整型值,在v的值不为u时,原子类型变量的值将在其原有基础上增加该变量值。
  • u:整型值,被用来与v的值进行比较来决定是否对v进行增加a。

atomic_add_unless返回参数说明

  • 函数atomic_add_unless()返回一个整型值,如果起初原子类型v的值即与u相等,则返回0,否则返回非0值。

atomic_add_unless实例解析

编写测试文件:atomic_add_unless.c

头文件及全局变量声明如下:

#include <linux/types.h>
#include <linux/init.h>
#include <linux/module.h>
MODULE_LICENSE("GPL");
static int __init atomic_add_unless_init(void);
static void __exit atomic_add_unless_exit(void);

atomic_t my_atomic ;

模块初始化函数:

int __init atomic_add_unless_init(void)
{
    int ret, a;
    atomic_set( &my_atomic, 10 );
    a = 2;

    /*如果原子类型的变量my_atomic不为10,则将其原子地增加a */
    ret = atomic_add_unless( &my_atomic, a, 10 );
    printk("first atomic_add_unless, my_atomic.counter = %d\n", atomic_read( &my_atomic));
    printk("return ret = %d\n", ret);

    atomic_set( &my_atomic, 4 );
    a = 2;
    ret = atomic_add_unless( &my_atomic, a, 10 );
    printk("first atomic_add_unless, my_atomic.counter = %d\n", atomic_read( &my_atomic));
    printk("return ret = %d\n", ret);
    return 0;
}

模块退出函数:

void __exit atomic_add_unless_exit(void)
{
    printk("exit! \n");
}

模块初始化及退出函数调用:

module_init(atomic_add_unless_init);
module_exit(atomic_add_unless_exit);

实例运行结果及分析:

首先编译模块,执行命令insmod atomic_add_unless.ko插入模块,然后执行命令dmesg -c,会出现如图所示的结果。

Linux内核API atomic_add_unless

结果分析:

测试程序中调用了函数atomic_set()和函数atomic_read(),关于其功能参考极客笔记网关于它们的分析。

首先定义一个原子类型my_atomic,调用函数atomic_set()将其值设置为10。然后调用函数atomic_add_unless(),由于my_atomic的值10与该函数的第三个参数(u)相等,则返回ret = 0, my_atomic将不执行加a操作,其值仍为10。通过函数atomic_set()再将my_atomic设置为4,然后调用函数atomic_add_unless(), my_atomic的值4与该函数的第三个参数(u)不相等,则返回ret = 1,而my_atomic也将执行加a操作,最终其值为6。

赞(0)
未经允许不得转载:极客笔记 » Linux内核API atomic_add_unless
分享到: 更多 (0)

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址