Linux内核API atomic_add_return

函数atomic_add_return()的功能是将原子类型的变量v的值原子地增加i，并返回增加i后的v的值。

atomic_add_return文件包含

#include <asm/atomic.h>

atomic_add_return函数定义

在内核源码中的位置：linux-3.19.3/arch/x86/include/asm/atomic.h

函数定义格式：

static inline int atomic_add_return(int i, atomic_t *v)

atomic_add_return输入参数说明

• i：整型值，原子类型变量的值将在其原有基础上增加该变量值。
• v：原子类型变量指针。关于原子类型atomic_t的定义参考atomic_set()函数的分析。

atomic_add_return返回参数说明

函数atomic_add_return()返回一个整型值，它指原子类型的变量v加上i后的值。

atomic_add_return实例解析

编写测试文件：atomic_add_return.c

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

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

atomic_t my_atomic ;

模块初始化函数：

int __init atomic_add_return_init(void)
{
    int ret, i;
    atomic_set( &my_atomic, 5 );
    i = 2;
    ret = atomic_add_return( i, &my_atomic ); //将原子类型的变量my_atomic原子地增加i
    printk("after atomic_add_return, my_atomic.counter = %d\n", atomic_read( &my_atomic));
    printk("return ret = %d\n", ret);
    return 0;
}

模块退出函数：

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

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

module_init(atomic_add_return_init);
module_exit(atomic_add_return_exit);

实例运行结果及分析：

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

结果分析：

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

首先定义一个原子类型my_atomic，调用函数atomic_set()将其值设置为5。然后调用函数atomic_add_return()将my_atomic的值增加i(i = 2)，并返回增加i后的my_atomic的值。由输出信息可知my_atomic的值为7，并且返回值ret也为7。