linux内核--wait_event_interruptible_timeout()函数分析

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

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

函数原型：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;                              
})