Linux内核API down_read_trylock|极客笔记

函数down_read_trylock()是读者用来尝试得到读写信号量sem时调用的，它与down_read()的功能类似，只是它不会导致调用者睡眠，即调用该函数的进程在不能获取信号量的情况下会立即返回，不会睡眠。

down_read_trylock文件包含

#include <linux/ rwsem.h>

down_read_trylock函数定义

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

函数定义格式：

int down_read_trylock(struct rw_semaphore *sem)

down_read_trylock输入参数说明

sem：该参数为一指针，指向待获取的读写信号量。关于读写信号量结构体rw_semaphore的定义及读写信号量的概念参考极客笔记中init_rwsem()宏的分析。

down_read_trylock返回参数说明

该函数返回一个整型值，如果能成功获取读写信号量则返回1，否则返回0。

down_read_trylock实例解析

编写测试文件：down_read_trylock.c

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

#include <linux/rwsem.h>
#include <linux/init.h>
#include <linux/module.h>
MODULE_LICENSE("GPL");
static int __init down_read_trylock_init(void);
static void __exit down_read_trylock_exit(void);

#define EXEC_DOWN_WRITE 0
struct rw_semaphore rwsem ;

模块初始化函数：

int __init down_read_trylock_init(void)
{
    int ret;
    init_rwsem( &rwsem );                  //读写信号量初始化
    printk("after init_rwsem, count: %ld\n", rwsem.count);
    if( EXEC_DOWN_WRITE )
        down_write( &rwsem );              //写者获取读写信号量

    ret = down_read_trylock( &rwsem );     //读者尝试获取读写信号量
    if(ret)
    {
        printk("first down_read_trylock, count: %ld\n", rwsem.count);
        ret = down_read_trylock( &rwsem );
        printk("second down_read_trylock, count: %ld\n", rwsem.count);
        while( rwsem.count ! = 0 )
        {
            up_read( &rwsem );             //读者释放读写信号量
        }
    }
    else
        printk("down_read_trylock failed! \n");
    return 0;
}

模块退出函数：

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

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

module_init(down_read_trylock_init);
module_exit(down_read_trylock_exit);

实例运行结果及分析：

首先定义宏EXEC_DOWN_WRITE为0，则if块中的语句将不执行。编译模块，执行命令insmod down_read_trylock.ko插入模块，然后执行命令dmesg -c，会出现如图A所示的结果。

Linux内核API down_read_trylock

然后定义宏EXEC_DOWN_WRITE为1，则if块中的语句将执行。重新编译模块，执行命令insmod down_read_trylock.ko插入模块，然后执行命令dmesg -c，会出现如图B所示的结果。

Linux内核API down_read_trylock

结果分析：

测试程序中调用了宏init_rwsem()和函数down_write()，关于其功能参考极客笔记关于它们的分析。

该测试程序分为两步进行测试：

第一步定义宏EXEC_DOWN_WRITE为0，则读写信号量rwsem不会被写者获取，通过down_read_trylock()操作读者可以成功获得信号量，返回ret = 1。每个读者获取信号量时，count值都会递增1表示持有信号量的读者个数（起初count由init_rwsem()初始化为0）。最后程序调用up_read()释放读写信号量，它对count执行递减1操作，参考极客笔记中关于up_read()的分析。
第二步定义宏EXEC_DOWN_WRITE为1，则写者将获取读写信号量rwsem。执行down_read_trylock()操作读者将不能成功获得信号量，但读者将不会睡眠，而是立即返回，且返回值ret = 0，从而执行if(ret)…else块中else中的语句，输出信息如图B所示。