网上有关于此函数的分析,但大都是同一篇文章转载来转载去,没有进一步的分析。做个小结:

了解函数功能,除了直接看代码逻辑,最有效的当是注释内容了。
如下:

函数原型:wait_event_interruptible_timeout(wq, condition, timeout)

* 函数作用:~睡眠~,直到condition为真,或timeout超时;
* @wq: 要等待的等待队列
* @condition: 等待事件发生的条件(一个C表达式 )
* @timeout: 超时时间

程序是用来睡眠的(TASK_INTERRUPTIBLE状态下),直到@condition为真,或者收到一个信号。
每次等待队列@wq被唤醒时,检查@condition;
若有可以改变等待条件的任何更改操作,调用wake_up();
如果@timeout超时,函数返回0;如果是被信号中断,函数返回-ERESTARTSYS;
在超时之前condition 为true,否则继续剩余的jiffies 。

理解所需:
1,TASK_INTERRUPTIBLE是可以被信号和wake_up()唤醒的,当信号到来时,进程会被设置为可运行;而TASK_UNINTERRUPTIBLE只能被wake_up()唤醒。
2,信号是在软件层次上对中断机制的一种模拟,为软中断。
3,signal_pending(current) :检查当前进程是否有信号处理,返回值不为0则表示有信号需要处理。
返回 -ERESTARTSYS 表示信号函数处理完毕后重新执行信号函数前的某个系统调用。(此函数只检查是否有信号,不处理信号)
条件不满足,则产生信号、开始等待。若返回非0,则表示没有信号需要处理,继续循环重新开始系统调用;若返回0,则表示有信号需要处理,直接处理数据,系统调用正常结束。
4,schedule_timeout()用来让出CPU,在指定的时间用完以后或者其它事件到达并唤醒进程时(比如接收了一个信号量),该进程才可以继续运行.
[函数返回0表示timeout用完后被唤醒;返回整数表示timeout未用完时就被唤醒,此时可能接收到了一个信号量]

wait_event系列函数(作用:等待事件,置于休眠。区别从字面意思即可看出):

wait_event(queue, conditon);
wait_event_interruptible(queue, condition);
wait_event_timeout(queue, condition, timeout);
wait_event_interruptible_timeout(queue, condition, timeout);

*queue:作为等待队列头的等待队列被唤醒
*conditon:必须满足,否则阻塞
*【timeout和conditon相比,有更高优先级】

参考内核源码理解(在wait.h文件中)

#define __wait_event_interruptible_timeout(wq, condition, ret)
do {                                    
    DEFINE_WAIT(__wait);                        

    for (;;) {                          
        prepare_to_wait(&wq, &__wait, TASK_INTERRUPTIBLE);  
        if (condition)                      
            break;                      
        if (!signal_pending(current)) {             
            ret = schedule_timeout(ret);            
            if (!ret)                   
                break;                  
            continue;                   
        }                           
        ret = -ERESTARTSYS;                 
        break;                          
    }                               
    finish_wait(&wq, &__wait);                  
} while (0)

/**
 * wait_event_interruptible_timeout - sleep until a condition gets true or a timeout elapses
 * @wq: the waitqueue to wait on
 * @condition: a C expression for the event to wait for
 * @timeout: timeout, in jiffies
 *
 * The process is put to sleep (TASK_INTERRUPTIBLE) until the
 * @condition evaluates to true or a signal is received.
 * The @condition is checked each time the waitqueue @wq is woken up.
 *
 * wake_up() has to be called after changing any variable that could
 * change the result of the wait condition.
 *
 * The function returns 0 if the @timeout elapsed, -ERESTARTSYS if it
 * was interrupted by a signal, and the remaining jiffies otherwise
 * if the condition evaluated to true before the timeout elapsed.
 */

#define wait_event_interruptible_timeout(wq, condition, timeout)    
({                                  
    long __ret = timeout;                       
    if (!(condition))                       
        __wait_event_interruptible_timeout(wq, condition, __ret); 
    __ret;                              
})
GitHub 加速计划 / li / linux-dash
10.39 K
1.2 K
下载
A beautiful web dashboard for Linux
最近提交(Master分支:2 个月前 )
186a802e added ecosystem file for PM2 4 年前
5def40a3 Add host customization support for the NodeJS version 4 年前
Logo

旨在为数千万中国开发者提供一个无缝且高效的云端环境,以支持学习、使用和贡献开源项目。

更多推荐