Linux内核API up

up()函数的功能是释放信号量sem，释放信号量后，sem的计数器的值将加1。当一个线程调用down函数的某个版本获得信号量后，则它将获得信号量所保护的临界区，对该临界区访问结束后，必须释放信号量，up()即是用来完成这个功能。

up文件包含

#include <linux/semaphore.h>

up函数定义

在内核源码中的位置：linux-3.19.3/kernel/locking/semaphore.c

函数定义格式：

void up(struct semaphore *sem)

up输入参数说明

• sem：信号量结构体指针，指向将要获取的信号量。其中，关于信号量结构体semaphore的说明参考极客笔记中sema_init()函数的分析说明。

up返回参数说明

• 该函数无返回值。

up实例解析

编写测试文件：up.c

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

#include <linux/semaphore.h>
#include <linux/init.h>
#include <linux/module.h>
MODULE_LICENSE("GPL");
static int __init up_init(void);
static void __exit up_exit(void);
struct semaphore sema;

模块初始化函数：

int __init up_init(void)
{
    sema_init( &sema, 2 );      //信号量初始化

    /* 输出初始化后信号量的信息 */
    printk("after sema_init, sema.count: %d\n", sema.count);

    down( &sema);               //获取信号量

    /* 输出down操作后信号量的信息 */
    printk("after down, sema.count: %d\n", sema.count);

    up( &sema);                 //释放信号量
    /* 输出up操作后信号量的信息 */
    printk("after up, sema.count: %d\n", sema.count);
    return 0;
}

模块退出函数：

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

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

module_init(up_init);
module_exit(up_exit);

实例运行结果及分析：

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

结果分析：

首先定义一个信号量结构体sema，并调用函数sema_init()初始化该信号量，将其计数器设置为2。然后调用down()获取信号量，其计数器count将减1而变为1。再调用函数up()来释放信号量，则sema的计数器值将加1, count恢复为2，可供其他线程继续获得信号量。

测试程序中调用的down()函数可参见参考极客笔记关于down()的分析说明。