mod_timer函數及其它定時器函數

當一個定時器已經被插入到核心動態定時器鏈表中後，我們還可以修改該定時器的expires值。函數mod_timer()實現這一點

修改註冊入計時器列表的handler的起動時間

int mod_timer(struct timer_list *timer, unsigned long expires)
{
int ret;
unsigned long flags;

spin_lock_irqsave(&timerlist_lock, flags);
timer->expires = expires;
ret = detach_timer(timer);
internal_add_timer(timer);
spin_unlock_irqrestore(&timerlist_lock, flags);
return ret;
}

核心通過函數mod_timer來實現已經啟用的定時器逾時時間：

mod_timer(&my_timer, jiffies+new_delay);

mod_timer函數也可以操作那些已經初始化，但還沒有被啟用的定時器，如果定時器沒有啟用，mod_timer會啟用它。如果調用時定時器未被啟用，該函數返回0，否則返回1。一旦從mod_timer函數返回，定時器都將被啟用而且設定了新的定時值。

如果需要在定時器逾時前停止定時器，可以使用del_timer函數：

del_timer(&my_timer);

被啟用或未被啟用的定時器都可以使用該函數，如果定時器還未被啟用，該函數返回0；否則返回1。當刪除定時器，必須小心一個潛在的競爭條件。當del_timer返回後，可以保證的只是：定時器不會被再啟用，但是多處理器上定時器中斷可能已經在其他處理上運行了，所以需要等待可能在其他處理器上啟動並執行定時器處理常式都退出，這時需要使用del_timer_sync函數執行刪除工作：

del_timer_sync(&my_timer);

和del_timer函數不同，del_timer_sync數不能在中斷上下文中使用。

定時器 API 包括幾個比上面介紹的那些更多的功能. 下面的集合是完整的核提供的函數列表:

int mod_timer(struct timer_list *timer, unsigned long expires);

更新一個定時器的逾時時間, 使用一個逾時定時器的一個普通的任務(再一次, 關馬達軟碟機定時器是一個典型例子). mod_timer 也可被調用於非啟用定時器, 那裡你正常地使用 add_timer.

int del_timer_sync(struct timer_list *timer);

如同 del_timer 一樣工作, 但是還保證當它返回時, 定時器函數不在任何 CPU 上運行. del_timer_sync 用來避免競爭情況在 SMP 系統上, 並且在 UP 核心中和 del_timer 相同. 這個函數應當在大部分情況下比 del_timer 更首先使用. 這個函數可能睡眠如果它被從非原子上下文調用, 但是在其他情況下會忙等待. 要十分小心調用 del_timer_sync 當持有鎖時; 如果這個定時器函數試圖獲得同一個鎖, 系統會死結. 如果定時器函數重新註冊自己, 調用者必須首先確保這個重新註冊不會發生; 這常常同設定一個" 關閉 "標誌來實現, 這個標誌被定時器函數檢查.

int timer_pending(const struct timer_list * timer);

返回真或假來指示是否定時器當前被調度來運行, 通過調用結構的其中一個不透明的成員.

下面是關於timer的API函數：

　　增加定時器
 

void add_timer(struct timer_list * timer);

　　刪除定時器

int del_timer(struct timer_list * timer);

　　
　　修改定時器的expire

int mod_timer(struct timer_list *timer, unsigned long expires);

　　使用定時器的一般流程為：

　　（1）timer、編寫function；

　　（2）為timer的expires、data、function賦值；

　　（3）調用add_timer將timer加入列表；

　　（4）在定時器到期時，function被執行；

　　（5）在程式中涉及timer控制的地方適當地調用del_timer、mod_timer刪除timer或修改timer的expires。

　　我們可以參考drivers\char\keyboard.c中鍵盤的驅動中關於timer的部分：

… #include <linux/timer.h> … static struct timer_list key_autorepeat_timer = { 　function: key_callback }; static void kbd_processkeycode(unsigned char keycode, char up_flag, int autorepeat) { 　char raw_mode = (kbd->kbdmode == VC_RAW); 　if (up_flag) { 　　rep = 0; 　　if(!test_and_clear_bit(keycode, key_down)) 　　　up_flag = kbd_unexpected_up(keycode); 　} else { 　　rep = test_and_set_bit(keycode, key_down); 　　/* If the keyboard autorepeated for us, ignore it. 　　* We do our own autorepeat processing. 　　*/ 　　if (rep && !autorepeat) 　　　return; 　} 　if (kbd_repeatkeycode == keycode || !up_flag || raw_mode) { 　　kbd_repeatkeycode = -1; 　　del_timer(&key_autorepeat_timer); 　} 　… 　/* 　* Calculate the next time when we have to do some autorepeat 　* processing. Note that we do not do autorepeat processing 　* while in raw mode but we do do autorepeat processing in 　* medium raw mode. 　*/ 　if (!up_flag && !raw_mode) { 　　kbd_repeatkeycode = keycode; 　　if (vc_kbd_mode(kbd, VC_REPEAT)) { 　　　if (rep) 　　　　key_autorepeat_timer.expires = jiffies + kbd_repeatinterval; 　　　else 　　　　key_autorepeat_timer.expires = jiffies + kbd_repeattimeout; 　　　　add_timer(&key_autorepeat_timer); 　　} 　} 　… }