1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>del_timer_sync</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="Linux Device Drivers"><link rel="up" href="ch01s03.html" title="Delaying, scheduling, and timer routines"><link rel="prev" href="API-try-to-del-timer-sync.html" title="try_to_del_timer_sync"><link rel="next" href="API-schedule-timeout.html" title="schedule_timeout"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">del_timer_sync</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-try-to-del-timer-sync.html">Prev</a>&#160;</td><th width="60%" align="center">Delaying, scheduling, and timer routines</th><td width="20%" align="right">&#160;<a accesskey="n" href="API-schedule-timeout.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-del-timer-sync"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>del_timer_sync &#8212; 
2     deactivate a timer and wait for the handler to finish.
3 </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">del_timer_sync </b>(</code></td><td>struct timer_list * <var class="pdparam">timer</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div><div class="refsect1"><a name="idp1107077668"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>timer</code></em></span></dt><dd><p>
4     the timer to be deactivated
5    </p></dd></dl></div></div><div class="refsect1"><a name="idp1107079244"></a><h2>Description</h2><p>
6   This function only differs from <code class="function">del_timer</code> on SMP: besides deactivating
7   the timer it also makes sure the handler has finished executing on other
8   CPUs.
9</p></div><div class="refsect1"><a name="idp1107080300"></a><h2>Synchronization rules</h2><p>
10   Callers must prevent restarting of the timer,
11   otherwise this function is meaningless. It must not be called from
12   interrupt contexts unless the timer is an irqsafe one. The caller must
13   not hold locks which would prevent completion of the timer's
14   handler. The timer's handler must not call <code class="function">add_timer_on</code>. Upon exit the
15   timer is not queued and the handler is not running on any CPU.
16</p></div><div class="refsect1"><a name="idp1107081588"></a><h2>Note</h2><p>
17   For !irqsafe timers, you must not hold locks that are held in
18   interrupt context while calling this function. Even if the lock has
19   nothing to do with the timer in question.  Here's why:
20   </p><p>
21
22   CPU0                             CPU1
23   ----                             ----
24   &lt;SOFTIRQ&gt;
25   <code class="function">call_timer_fn</code>;
26   base-&gt;running_timer = mytimer;
27   spin_lock_irq(somelock);
28   &lt;IRQ&gt;
29   spin_lock(somelock);
30   del_timer_sync(mytimer);
31   while (base-&gt;running_timer == mytimer);
32   </p><p>
33
34   Now <code class="function">del_timer_sync</code> will never return and never release somelock.
35   The interrupt on the other CPU is waiting to grab somelock but
36   it has interrupted the softirq that CPU0 is waiting to finish.
37   </p><p>
38
39   The function returns whether it has deactivated a pending timer or not.
40</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-try-to-del-timer-sync.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="ch01s03.html">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="API-schedule-timeout.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">try_to_del_timer_sync</span>&#160;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&#160;<span class="phrase">schedule_timeout</span></td></tr></table></div></body></html>
41