rcutree.c 48 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712
  1. /*
  2. * Read-Copy Update mechanism for mutual exclusion
  3. *
  4. * This program is free software; you can redistribute it and/or modify
  5. * it under the terms of the GNU General Public License as published by
  6. * the Free Software Foundation; either version 2 of the License, or
  7. * (at your option) any later version.
  8. *
  9. * This program is distributed in the hope that it will be useful,
  10. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  12. * GNU General Public License for more details.
  13. *
  14. * You should have received a copy of the GNU General Public License
  15. * along with this program; if not, write to the Free Software
  16. * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  17. *
  18. * Copyright IBM Corporation, 2008
  19. *
  20. * Authors: Dipankar Sarma <dipankar@in.ibm.com>
  21. * Manfred Spraul <manfred@colorfullife.com>
  22. * Paul E. McKenney <paulmck@linux.vnet.ibm.com> Hierarchical version
  23. *
  24. * Based on the original work by Paul McKenney <paulmck@us.ibm.com>
  25. * and inputs from Rusty Russell, Andrea Arcangeli and Andi Kleen.
  26. *
  27. * For detailed explanation of Read-Copy Update mechanism see -
  28. * Documentation/RCU
  29. */
  30. #include <linux/types.h>
  31. #include <linux/kernel.h>
  32. #include <linux/init.h>
  33. #include <linux/spinlock.h>
  34. #include <linux/smp.h>
  35. #include <linux/rcupdate.h>
  36. #include <linux/interrupt.h>
  37. #include <linux/sched.h>
  38. #include <linux/nmi.h>
  39. #include <asm/atomic.h>
  40. #include <linux/bitops.h>
  41. #include <linux/module.h>
  42. #include <linux/completion.h>
  43. #include <linux/moduleparam.h>
  44. #include <linux/percpu.h>
  45. #include <linux/notifier.h>
  46. #include <linux/cpu.h>
  47. #include <linux/mutex.h>
  48. #include <linux/time.h>
  49. #include "rcutree.h"
  50. /* Data structures. */
  51. #define RCU_STATE_INITIALIZER(name) { \
  52. .level = { &name.node[0] }, \
  53. .levelcnt = { \
  54. NUM_RCU_LVL_0, /* root of hierarchy. */ \
  55. NUM_RCU_LVL_1, \
  56. NUM_RCU_LVL_2, \
  57. NUM_RCU_LVL_3, /* == MAX_RCU_LVLS */ \
  58. }, \
  59. .signaled = RCU_SIGNAL_INIT, \
  60. .gpnum = -300, \
  61. .completed = -300, \
  62. .onofflock = __SPIN_LOCK_UNLOCKED(&name.onofflock), \
  63. .orphan_cbs_list = NULL, \
  64. .orphan_cbs_tail = &name.orphan_cbs_list, \
  65. .orphan_qlen = 0, \
  66. .fqslock = __SPIN_LOCK_UNLOCKED(&name.fqslock), \
  67. .n_force_qs = 0, \
  68. .n_force_qs_ngp = 0, \
  69. }
  70. struct rcu_state rcu_sched_state = RCU_STATE_INITIALIZER(rcu_sched_state);
  71. DEFINE_PER_CPU(struct rcu_data, rcu_sched_data);
  72. struct rcu_state rcu_bh_state = RCU_STATE_INITIALIZER(rcu_bh_state);
  73. DEFINE_PER_CPU(struct rcu_data, rcu_bh_data);
  74. /*
  75. * Return true if an RCU grace period is in progress. The ACCESS_ONCE()s
  76. * permit this function to be invoked without holding the root rcu_node
  77. * structure's ->lock, but of course results can be subject to change.
  78. */
  79. static int rcu_gp_in_progress(struct rcu_state *rsp)
  80. {
  81. return ACCESS_ONCE(rsp->completed) != ACCESS_ONCE(rsp->gpnum);
  82. }
  83. /*
  84. * Note a quiescent state. Because we do not need to know
  85. * how many quiescent states passed, just if there was at least
  86. * one since the start of the grace period, this just sets a flag.
  87. */
  88. void rcu_sched_qs(int cpu)
  89. {
  90. struct rcu_data *rdp;
  91. rdp = &per_cpu(rcu_sched_data, cpu);
  92. rdp->passed_quiesc_completed = rdp->completed;
  93. barrier();
  94. rdp->passed_quiesc = 1;
  95. rcu_preempt_note_context_switch(cpu);
  96. }
  97. void rcu_bh_qs(int cpu)
  98. {
  99. struct rcu_data *rdp;
  100. rdp = &per_cpu(rcu_bh_data, cpu);
  101. rdp->passed_quiesc_completed = rdp->completed;
  102. barrier();
  103. rdp->passed_quiesc = 1;
  104. }
  105. #ifdef CONFIG_NO_HZ
  106. DEFINE_PER_CPU(struct rcu_dynticks, rcu_dynticks) = {
  107. .dynticks_nesting = 1,
  108. .dynticks = 1,
  109. };
  110. #endif /* #ifdef CONFIG_NO_HZ */
  111. static int blimit = 10; /* Maximum callbacks per softirq. */
  112. static int qhimark = 10000; /* If this many pending, ignore blimit. */
  113. static int qlowmark = 100; /* Once only this many pending, use blimit. */
  114. module_param(blimit, int, 0);
  115. module_param(qhimark, int, 0);
  116. module_param(qlowmark, int, 0);
  117. static void force_quiescent_state(struct rcu_state *rsp, int relaxed);
  118. static int rcu_pending(int cpu);
  119. /*
  120. * Return the number of RCU-sched batches processed thus far for debug & stats.
  121. */
  122. long rcu_batches_completed_sched(void)
  123. {
  124. return rcu_sched_state.completed;
  125. }
  126. EXPORT_SYMBOL_GPL(rcu_batches_completed_sched);
  127. /*
  128. * Return the number of RCU BH batches processed thus far for debug & stats.
  129. */
  130. long rcu_batches_completed_bh(void)
  131. {
  132. return rcu_bh_state.completed;
  133. }
  134. EXPORT_SYMBOL_GPL(rcu_batches_completed_bh);
  135. /*
  136. * Does the CPU have callbacks ready to be invoked?
  137. */
  138. static int
  139. cpu_has_callbacks_ready_to_invoke(struct rcu_data *rdp)
  140. {
  141. return &rdp->nxtlist != rdp->nxttail[RCU_DONE_TAIL];
  142. }
  143. /*
  144. * Does the current CPU require a yet-as-unscheduled grace period?
  145. */
  146. static int
  147. cpu_needs_another_gp(struct rcu_state *rsp, struct rcu_data *rdp)
  148. {
  149. return *rdp->nxttail[RCU_DONE_TAIL] && !rcu_gp_in_progress(rsp);
  150. }
  151. /*
  152. * Return the root node of the specified rcu_state structure.
  153. */
  154. static struct rcu_node *rcu_get_root(struct rcu_state *rsp)
  155. {
  156. return &rsp->node[0];
  157. }
  158. #ifdef CONFIG_SMP
  159. /*
  160. * If the specified CPU is offline, tell the caller that it is in
  161. * a quiescent state. Otherwise, whack it with a reschedule IPI.
  162. * Grace periods can end up waiting on an offline CPU when that
  163. * CPU is in the process of coming online -- it will be added to the
  164. * rcu_node bitmasks before it actually makes it online. The same thing
  165. * can happen while a CPU is in the process of coming online. Because this
  166. * race is quite rare, we check for it after detecting that the grace
  167. * period has been delayed rather than checking each and every CPU
  168. * each and every time we start a new grace period.
  169. */
  170. static int rcu_implicit_offline_qs(struct rcu_data *rdp)
  171. {
  172. /*
  173. * If the CPU is offline, it is in a quiescent state. We can
  174. * trust its state not to change because interrupts are disabled.
  175. */
  176. if (cpu_is_offline(rdp->cpu)) {
  177. rdp->offline_fqs++;
  178. return 1;
  179. }
  180. /* If preemptable RCU, no point in sending reschedule IPI. */
  181. if (rdp->preemptable)
  182. return 0;
  183. /* The CPU is online, so send it a reschedule IPI. */
  184. if (rdp->cpu != smp_processor_id())
  185. smp_send_reschedule(rdp->cpu);
  186. else
  187. set_need_resched();
  188. rdp->resched_ipi++;
  189. return 0;
  190. }
  191. #endif /* #ifdef CONFIG_SMP */
  192. #ifdef CONFIG_NO_HZ
  193. /**
  194. * rcu_enter_nohz - inform RCU that current CPU is entering nohz
  195. *
  196. * Enter nohz mode, in other words, -leave- the mode in which RCU
  197. * read-side critical sections can occur. (Though RCU read-side
  198. * critical sections can occur in irq handlers in nohz mode, a possibility
  199. * handled by rcu_irq_enter() and rcu_irq_exit()).
  200. */
  201. void rcu_enter_nohz(void)
  202. {
  203. unsigned long flags;
  204. struct rcu_dynticks *rdtp;
  205. smp_mb(); /* CPUs seeing ++ must see prior RCU read-side crit sects */
  206. local_irq_save(flags);
  207. rdtp = &__get_cpu_var(rcu_dynticks);
  208. rdtp->dynticks++;
  209. rdtp->dynticks_nesting--;
  210. WARN_ON_ONCE(rdtp->dynticks & 0x1);
  211. local_irq_restore(flags);
  212. }
  213. /*
  214. * rcu_exit_nohz - inform RCU that current CPU is leaving nohz
  215. *
  216. * Exit nohz mode, in other words, -enter- the mode in which RCU
  217. * read-side critical sections normally occur.
  218. */
  219. void rcu_exit_nohz(void)
  220. {
  221. unsigned long flags;
  222. struct rcu_dynticks *rdtp;
  223. local_irq_save(flags);
  224. rdtp = &__get_cpu_var(rcu_dynticks);
  225. rdtp->dynticks++;
  226. rdtp->dynticks_nesting++;
  227. WARN_ON_ONCE(!(rdtp->dynticks & 0x1));
  228. local_irq_restore(flags);
  229. smp_mb(); /* CPUs seeing ++ must see later RCU read-side crit sects */
  230. }
  231. /**
  232. * rcu_nmi_enter - inform RCU of entry to NMI context
  233. *
  234. * If the CPU was idle with dynamic ticks active, and there is no
  235. * irq handler running, this updates rdtp->dynticks_nmi to let the
  236. * RCU grace-period handling know that the CPU is active.
  237. */
  238. void rcu_nmi_enter(void)
  239. {
  240. struct rcu_dynticks *rdtp = &__get_cpu_var(rcu_dynticks);
  241. if (rdtp->dynticks & 0x1)
  242. return;
  243. rdtp->dynticks_nmi++;
  244. WARN_ON_ONCE(!(rdtp->dynticks_nmi & 0x1));
  245. smp_mb(); /* CPUs seeing ++ must see later RCU read-side crit sects */
  246. }
  247. /**
  248. * rcu_nmi_exit - inform RCU of exit from NMI context
  249. *
  250. * If the CPU was idle with dynamic ticks active, and there is no
  251. * irq handler running, this updates rdtp->dynticks_nmi to let the
  252. * RCU grace-period handling know that the CPU is no longer active.
  253. */
  254. void rcu_nmi_exit(void)
  255. {
  256. struct rcu_dynticks *rdtp = &__get_cpu_var(rcu_dynticks);
  257. if (rdtp->dynticks & 0x1)
  258. return;
  259. smp_mb(); /* CPUs seeing ++ must see prior RCU read-side crit sects */
  260. rdtp->dynticks_nmi++;
  261. WARN_ON_ONCE(rdtp->dynticks_nmi & 0x1);
  262. }
  263. /**
  264. * rcu_irq_enter - inform RCU of entry to hard irq context
  265. *
  266. * If the CPU was idle with dynamic ticks active, this updates the
  267. * rdtp->dynticks to let the RCU handling know that the CPU is active.
  268. */
  269. void rcu_irq_enter(void)
  270. {
  271. struct rcu_dynticks *rdtp = &__get_cpu_var(rcu_dynticks);
  272. if (rdtp->dynticks_nesting++)
  273. return;
  274. rdtp->dynticks++;
  275. WARN_ON_ONCE(!(rdtp->dynticks & 0x1));
  276. smp_mb(); /* CPUs seeing ++ must see later RCU read-side crit sects */
  277. }
  278. /**
  279. * rcu_irq_exit - inform RCU of exit from hard irq context
  280. *
  281. * If the CPU was idle with dynamic ticks active, update the rdp->dynticks
  282. * to put let the RCU handling be aware that the CPU is going back to idle
  283. * with no ticks.
  284. */
  285. void rcu_irq_exit(void)
  286. {
  287. struct rcu_dynticks *rdtp = &__get_cpu_var(rcu_dynticks);
  288. if (--rdtp->dynticks_nesting)
  289. return;
  290. smp_mb(); /* CPUs seeing ++ must see prior RCU read-side crit sects */
  291. rdtp->dynticks++;
  292. WARN_ON_ONCE(rdtp->dynticks & 0x1);
  293. /* If the interrupt queued a callback, get out of dyntick mode. */
  294. if (__get_cpu_var(rcu_sched_data).nxtlist ||
  295. __get_cpu_var(rcu_bh_data).nxtlist)
  296. set_need_resched();
  297. }
  298. /*
  299. * Record the specified "completed" value, which is later used to validate
  300. * dynticks counter manipulations. Specify "rsp->completed - 1" to
  301. * unconditionally invalidate any future dynticks manipulations (which is
  302. * useful at the beginning of a grace period).
  303. */
  304. static void dyntick_record_completed(struct rcu_state *rsp, long comp)
  305. {
  306. rsp->dynticks_completed = comp;
  307. }
  308. #ifdef CONFIG_SMP
  309. /*
  310. * Recall the previously recorded value of the completion for dynticks.
  311. */
  312. static long dyntick_recall_completed(struct rcu_state *rsp)
  313. {
  314. return rsp->dynticks_completed;
  315. }
  316. /*
  317. * Snapshot the specified CPU's dynticks counter so that we can later
  318. * credit them with an implicit quiescent state. Return 1 if this CPU
  319. * is in dynticks idle mode, which is an extended quiescent state.
  320. */
  321. static int dyntick_save_progress_counter(struct rcu_data *rdp)
  322. {
  323. int ret;
  324. int snap;
  325. int snap_nmi;
  326. snap = rdp->dynticks->dynticks;
  327. snap_nmi = rdp->dynticks->dynticks_nmi;
  328. smp_mb(); /* Order sampling of snap with end of grace period. */
  329. rdp->dynticks_snap = snap;
  330. rdp->dynticks_nmi_snap = snap_nmi;
  331. ret = ((snap & 0x1) == 0) && ((snap_nmi & 0x1) == 0);
  332. if (ret)
  333. rdp->dynticks_fqs++;
  334. return ret;
  335. }
  336. /*
  337. * Return true if the specified CPU has passed through a quiescent
  338. * state by virtue of being in or having passed through an dynticks
  339. * idle state since the last call to dyntick_save_progress_counter()
  340. * for this same CPU.
  341. */
  342. static int rcu_implicit_dynticks_qs(struct rcu_data *rdp)
  343. {
  344. long curr;
  345. long curr_nmi;
  346. long snap;
  347. long snap_nmi;
  348. curr = rdp->dynticks->dynticks;
  349. snap = rdp->dynticks_snap;
  350. curr_nmi = rdp->dynticks->dynticks_nmi;
  351. snap_nmi = rdp->dynticks_nmi_snap;
  352. smp_mb(); /* force ordering with cpu entering/leaving dynticks. */
  353. /*
  354. * If the CPU passed through or entered a dynticks idle phase with
  355. * no active irq/NMI handlers, then we can safely pretend that the CPU
  356. * already acknowledged the request to pass through a quiescent
  357. * state. Either way, that CPU cannot possibly be in an RCU
  358. * read-side critical section that started before the beginning
  359. * of the current RCU grace period.
  360. */
  361. if ((curr != snap || (curr & 0x1) == 0) &&
  362. (curr_nmi != snap_nmi || (curr_nmi & 0x1) == 0)) {
  363. rdp->dynticks_fqs++;
  364. return 1;
  365. }
  366. /* Go check for the CPU being offline. */
  367. return rcu_implicit_offline_qs(rdp);
  368. }
  369. #endif /* #ifdef CONFIG_SMP */
  370. #else /* #ifdef CONFIG_NO_HZ */
  371. static void dyntick_record_completed(struct rcu_state *rsp, long comp)
  372. {
  373. }
  374. #ifdef CONFIG_SMP
  375. /*
  376. * If there are no dynticks, then the only way that a CPU can passively
  377. * be in a quiescent state is to be offline. Unlike dynticks idle, which
  378. * is a point in time during the prior (already finished) grace period,
  379. * an offline CPU is always in a quiescent state, and thus can be
  380. * unconditionally applied. So just return the current value of completed.
  381. */
  382. static long dyntick_recall_completed(struct rcu_state *rsp)
  383. {
  384. return rsp->completed;
  385. }
  386. static int dyntick_save_progress_counter(struct rcu_data *rdp)
  387. {
  388. return 0;
  389. }
  390. static int rcu_implicit_dynticks_qs(struct rcu_data *rdp)
  391. {
  392. return rcu_implicit_offline_qs(rdp);
  393. }
  394. #endif /* #ifdef CONFIG_SMP */
  395. #endif /* #else #ifdef CONFIG_NO_HZ */
  396. #ifdef CONFIG_RCU_CPU_STALL_DETECTOR
  397. static void record_gp_stall_check_time(struct rcu_state *rsp)
  398. {
  399. rsp->gp_start = jiffies;
  400. rsp->jiffies_stall = jiffies + RCU_SECONDS_TILL_STALL_CHECK;
  401. }
  402. static void print_other_cpu_stall(struct rcu_state *rsp)
  403. {
  404. int cpu;
  405. long delta;
  406. unsigned long flags;
  407. struct rcu_node *rnp = rcu_get_root(rsp);
  408. /* Only let one CPU complain about others per time interval. */
  409. spin_lock_irqsave(&rnp->lock, flags);
  410. delta = jiffies - rsp->jiffies_stall;
  411. if (delta < RCU_STALL_RAT_DELAY || !rcu_gp_in_progress(rsp)) {
  412. spin_unlock_irqrestore(&rnp->lock, flags);
  413. return;
  414. }
  415. rsp->jiffies_stall = jiffies + RCU_SECONDS_TILL_STALL_RECHECK;
  416. /*
  417. * Now rat on any tasks that got kicked up to the root rcu_node
  418. * due to CPU offlining.
  419. */
  420. rcu_print_task_stall(rnp);
  421. spin_unlock_irqrestore(&rnp->lock, flags);
  422. /* OK, time to rat on our buddy... */
  423. printk(KERN_ERR "INFO: RCU detected CPU stalls:");
  424. rcu_for_each_leaf_node(rsp, rnp) {
  425. rcu_print_task_stall(rnp);
  426. if (rnp->qsmask == 0)
  427. continue;
  428. for (cpu = 0; cpu <= rnp->grphi - rnp->grplo; cpu++)
  429. if (rnp->qsmask & (1UL << cpu))
  430. printk(" %d", rnp->grplo + cpu);
  431. }
  432. printk(" (detected by %d, t=%ld jiffies)\n",
  433. smp_processor_id(), (long)(jiffies - rsp->gp_start));
  434. trigger_all_cpu_backtrace();
  435. force_quiescent_state(rsp, 0); /* Kick them all. */
  436. }
  437. static void print_cpu_stall(struct rcu_state *rsp)
  438. {
  439. unsigned long flags;
  440. struct rcu_node *rnp = rcu_get_root(rsp);
  441. printk(KERN_ERR "INFO: RCU detected CPU %d stall (t=%lu jiffies)\n",
  442. smp_processor_id(), jiffies - rsp->gp_start);
  443. trigger_all_cpu_backtrace();
  444. spin_lock_irqsave(&rnp->lock, flags);
  445. if ((long)(jiffies - rsp->jiffies_stall) >= 0)
  446. rsp->jiffies_stall =
  447. jiffies + RCU_SECONDS_TILL_STALL_RECHECK;
  448. spin_unlock_irqrestore(&rnp->lock, flags);
  449. set_need_resched(); /* kick ourselves to get things going. */
  450. }
  451. static void check_cpu_stall(struct rcu_state *rsp, struct rcu_data *rdp)
  452. {
  453. long delta;
  454. struct rcu_node *rnp;
  455. delta = jiffies - rsp->jiffies_stall;
  456. rnp = rdp->mynode;
  457. if ((rnp->qsmask & rdp->grpmask) && delta >= 0) {
  458. /* We haven't checked in, so go dump stack. */
  459. print_cpu_stall(rsp);
  460. } else if (rcu_gp_in_progress(rsp) && delta >= RCU_STALL_RAT_DELAY) {
  461. /* They had two time units to dump stack, so complain. */
  462. print_other_cpu_stall(rsp);
  463. }
  464. }
  465. #else /* #ifdef CONFIG_RCU_CPU_STALL_DETECTOR */
  466. static void record_gp_stall_check_time(struct rcu_state *rsp)
  467. {
  468. }
  469. static void check_cpu_stall(struct rcu_state *rsp, struct rcu_data *rdp)
  470. {
  471. }
  472. #endif /* #else #ifdef CONFIG_RCU_CPU_STALL_DETECTOR */
  473. /*
  474. * Update CPU-local rcu_data state to record the newly noticed grace period.
  475. * This is used both when we started the grace period and when we notice
  476. * that someone else started the grace period.
  477. */
  478. static void note_new_gpnum(struct rcu_state *rsp, struct rcu_data *rdp)
  479. {
  480. rdp->qs_pending = 1;
  481. rdp->passed_quiesc = 0;
  482. rdp->gpnum = rsp->gpnum;
  483. }
  484. /*
  485. * Did someone else start a new RCU grace period start since we last
  486. * checked? Update local state appropriately if so. Must be called
  487. * on the CPU corresponding to rdp.
  488. */
  489. static int
  490. check_for_new_grace_period(struct rcu_state *rsp, struct rcu_data *rdp)
  491. {
  492. unsigned long flags;
  493. int ret = 0;
  494. local_irq_save(flags);
  495. if (rdp->gpnum != rsp->gpnum) {
  496. note_new_gpnum(rsp, rdp);
  497. ret = 1;
  498. }
  499. local_irq_restore(flags);
  500. return ret;
  501. }
  502. /*
  503. * Start a new RCU grace period if warranted, re-initializing the hierarchy
  504. * in preparation for detecting the next grace period. The caller must hold
  505. * the root node's ->lock, which is released before return. Hard irqs must
  506. * be disabled.
  507. */
  508. static void
  509. rcu_start_gp(struct rcu_state *rsp, unsigned long flags)
  510. __releases(rcu_get_root(rsp)->lock)
  511. {
  512. struct rcu_data *rdp = rsp->rda[smp_processor_id()];
  513. struct rcu_node *rnp = rcu_get_root(rsp);
  514. if (!cpu_needs_another_gp(rsp, rdp)) {
  515. spin_unlock_irqrestore(&rnp->lock, flags);
  516. return;
  517. }
  518. /* Advance to a new grace period and initialize state. */
  519. rsp->gpnum++;
  520. WARN_ON_ONCE(rsp->signaled == RCU_GP_INIT);
  521. rsp->signaled = RCU_GP_INIT; /* Hold off force_quiescent_state. */
  522. rsp->jiffies_force_qs = jiffies + RCU_JIFFIES_TILL_FORCE_QS;
  523. record_gp_stall_check_time(rsp);
  524. dyntick_record_completed(rsp, rsp->completed - 1);
  525. note_new_gpnum(rsp, rdp);
  526. /*
  527. * Because this CPU just now started the new grace period, we know
  528. * that all of its callbacks will be covered by this upcoming grace
  529. * period, even the ones that were registered arbitrarily recently.
  530. * Therefore, advance all outstanding callbacks to RCU_WAIT_TAIL.
  531. *
  532. * Other CPUs cannot be sure exactly when the grace period started.
  533. * Therefore, their recently registered callbacks must pass through
  534. * an additional RCU_NEXT_READY stage, so that they will be handled
  535. * by the next RCU grace period.
  536. */
  537. rdp->nxttail[RCU_NEXT_READY_TAIL] = rdp->nxttail[RCU_NEXT_TAIL];
  538. rdp->nxttail[RCU_WAIT_TAIL] = rdp->nxttail[RCU_NEXT_TAIL];
  539. /* Special-case the common single-level case. */
  540. if (NUM_RCU_NODES == 1) {
  541. rcu_preempt_check_blocked_tasks(rnp);
  542. rnp->qsmask = rnp->qsmaskinit;
  543. rnp->gpnum = rsp->gpnum;
  544. rsp->signaled = RCU_SIGNAL_INIT; /* force_quiescent_state OK. */
  545. spin_unlock_irqrestore(&rnp->lock, flags);
  546. return;
  547. }
  548. spin_unlock(&rnp->lock); /* leave irqs disabled. */
  549. /* Exclude any concurrent CPU-hotplug operations. */
  550. spin_lock(&rsp->onofflock); /* irqs already disabled. */
  551. /*
  552. * Set the quiescent-state-needed bits in all the rcu_node
  553. * structures for all currently online CPUs in breadth-first
  554. * order, starting from the root rcu_node structure. This
  555. * operation relies on the layout of the hierarchy within the
  556. * rsp->node[] array. Note that other CPUs will access only
  557. * the leaves of the hierarchy, which still indicate that no
  558. * grace period is in progress, at least until the corresponding
  559. * leaf node has been initialized. In addition, we have excluded
  560. * CPU-hotplug operations.
  561. *
  562. * Note that the grace period cannot complete until we finish
  563. * the initialization process, as there will be at least one
  564. * qsmask bit set in the root node until that time, namely the
  565. * one corresponding to this CPU, due to the fact that we have
  566. * irqs disabled.
  567. */
  568. rcu_for_each_node_breadth_first(rsp, rnp) {
  569. spin_lock(&rnp->lock); /* irqs already disabled. */
  570. rcu_preempt_check_blocked_tasks(rnp);
  571. rnp->qsmask = rnp->qsmaskinit;
  572. rnp->gpnum = rsp->gpnum;
  573. spin_unlock(&rnp->lock); /* irqs already disabled. */
  574. }
  575. rsp->signaled = RCU_SIGNAL_INIT; /* force_quiescent_state now OK. */
  576. spin_unlock_irqrestore(&rsp->onofflock, flags);
  577. }
  578. /*
  579. * Advance this CPU's callbacks, but only if the current grace period
  580. * has ended. This may be called only from the CPU to whom the rdp
  581. * belongs.
  582. */
  583. static void
  584. rcu_process_gp_end(struct rcu_state *rsp, struct rcu_data *rdp)
  585. {
  586. long completed_snap;
  587. unsigned long flags;
  588. local_irq_save(flags);
  589. completed_snap = ACCESS_ONCE(rsp->completed); /* outside of lock. */
  590. /* Did another grace period end? */
  591. if (rdp->completed != completed_snap) {
  592. /* Advance callbacks. No harm if list empty. */
  593. rdp->nxttail[RCU_DONE_TAIL] = rdp->nxttail[RCU_WAIT_TAIL];
  594. rdp->nxttail[RCU_WAIT_TAIL] = rdp->nxttail[RCU_NEXT_READY_TAIL];
  595. rdp->nxttail[RCU_NEXT_READY_TAIL] = rdp->nxttail[RCU_NEXT_TAIL];
  596. /* Remember that we saw this grace-period completion. */
  597. rdp->completed = completed_snap;
  598. }
  599. local_irq_restore(flags);
  600. }
  601. /*
  602. * Clean up after the prior grace period and let rcu_start_gp() start up
  603. * the next grace period if one is needed. Note that the caller must
  604. * hold rnp->lock, as required by rcu_start_gp(), which will release it.
  605. */
  606. static void cpu_quiet_msk_finish(struct rcu_state *rsp, unsigned long flags)
  607. __releases(rcu_get_root(rsp)->lock)
  608. {
  609. WARN_ON_ONCE(!rcu_gp_in_progress(rsp));
  610. rsp->completed = rsp->gpnum;
  611. rcu_process_gp_end(rsp, rsp->rda[smp_processor_id()]);
  612. rcu_start_gp(rsp, flags); /* releases root node's rnp->lock. */
  613. }
  614. /*
  615. * Similar to cpu_quiet(), for which it is a helper function. Allows
  616. * a group of CPUs to be quieted at one go, though all the CPUs in the
  617. * group must be represented by the same leaf rcu_node structure.
  618. * That structure's lock must be held upon entry, and it is released
  619. * before return.
  620. */
  621. static void
  622. cpu_quiet_msk(unsigned long mask, struct rcu_state *rsp, struct rcu_node *rnp,
  623. unsigned long flags)
  624. __releases(rnp->lock)
  625. {
  626. struct rcu_node *rnp_c;
  627. /* Walk up the rcu_node hierarchy. */
  628. for (;;) {
  629. if (!(rnp->qsmask & mask)) {
  630. /* Our bit has already been cleared, so done. */
  631. spin_unlock_irqrestore(&rnp->lock, flags);
  632. return;
  633. }
  634. rnp->qsmask &= ~mask;
  635. if (rnp->qsmask != 0 || rcu_preempted_readers(rnp)) {
  636. /* Other bits still set at this level, so done. */
  637. spin_unlock_irqrestore(&rnp->lock, flags);
  638. return;
  639. }
  640. mask = rnp->grpmask;
  641. if (rnp->parent == NULL) {
  642. /* No more levels. Exit loop holding root lock. */
  643. break;
  644. }
  645. spin_unlock_irqrestore(&rnp->lock, flags);
  646. rnp_c = rnp;
  647. rnp = rnp->parent;
  648. spin_lock_irqsave(&rnp->lock, flags);
  649. WARN_ON_ONCE(rnp_c->qsmask);
  650. }
  651. /*
  652. * Get here if we are the last CPU to pass through a quiescent
  653. * state for this grace period. Invoke cpu_quiet_msk_finish()
  654. * to clean up and start the next grace period if one is needed.
  655. */
  656. cpu_quiet_msk_finish(rsp, flags); /* releases rnp->lock. */
  657. }
  658. /*
  659. * Record a quiescent state for the specified CPU, which must either be
  660. * the current CPU. The lastcomp argument is used to make sure we are
  661. * still in the grace period of interest. We don't want to end the current
  662. * grace period based on quiescent states detected in an earlier grace
  663. * period!
  664. */
  665. static void
  666. cpu_quiet(int cpu, struct rcu_state *rsp, struct rcu_data *rdp, long lastcomp)
  667. {
  668. unsigned long flags;
  669. unsigned long mask;
  670. struct rcu_node *rnp;
  671. rnp = rdp->mynode;
  672. spin_lock_irqsave(&rnp->lock, flags);
  673. if (lastcomp != ACCESS_ONCE(rsp->completed)) {
  674. /*
  675. * Someone beat us to it for this grace period, so leave.
  676. * The race with GP start is resolved by the fact that we
  677. * hold the leaf rcu_node lock, so that the per-CPU bits
  678. * cannot yet be initialized -- so we would simply find our
  679. * CPU's bit already cleared in cpu_quiet_msk() if this race
  680. * occurred.
  681. */
  682. rdp->passed_quiesc = 0; /* try again later! */
  683. spin_unlock_irqrestore(&rnp->lock, flags);
  684. return;
  685. }
  686. mask = rdp->grpmask;
  687. if ((rnp->qsmask & mask) == 0) {
  688. spin_unlock_irqrestore(&rnp->lock, flags);
  689. } else {
  690. rdp->qs_pending = 0;
  691. /*
  692. * This GP can't end until cpu checks in, so all of our
  693. * callbacks can be processed during the next GP.
  694. */
  695. rdp->nxttail[RCU_NEXT_READY_TAIL] = rdp->nxttail[RCU_NEXT_TAIL];
  696. cpu_quiet_msk(mask, rsp, rnp, flags); /* releases rnp->lock */
  697. }
  698. }
  699. /*
  700. * Check to see if there is a new grace period of which this CPU
  701. * is not yet aware, and if so, set up local rcu_data state for it.
  702. * Otherwise, see if this CPU has just passed through its first
  703. * quiescent state for this grace period, and record that fact if so.
  704. */
  705. static void
  706. rcu_check_quiescent_state(struct rcu_state *rsp, struct rcu_data *rdp)
  707. {
  708. /* If there is now a new grace period, record and return. */
  709. if (check_for_new_grace_period(rsp, rdp))
  710. return;
  711. /*
  712. * Does this CPU still need to do its part for current grace period?
  713. * If no, return and let the other CPUs do their part as well.
  714. */
  715. if (!rdp->qs_pending)
  716. return;
  717. /*
  718. * Was there a quiescent state since the beginning of the grace
  719. * period? If no, then exit and wait for the next call.
  720. */
  721. if (!rdp->passed_quiesc)
  722. return;
  723. /* Tell RCU we are done (but cpu_quiet() will be the judge of that). */
  724. cpu_quiet(rdp->cpu, rsp, rdp, rdp->passed_quiesc_completed);
  725. }
  726. #ifdef CONFIG_HOTPLUG_CPU
  727. /*
  728. * Move a dying CPU's RCU callbacks to the ->orphan_cbs_list for the
  729. * specified flavor of RCU. The callbacks will be adopted by the next
  730. * _rcu_barrier() invocation or by the CPU_DEAD notifier, whichever
  731. * comes first. Because this is invoked from the CPU_DYING notifier,
  732. * irqs are already disabled.
  733. */
  734. static void rcu_send_cbs_to_orphanage(struct rcu_state *rsp)
  735. {
  736. int i;
  737. struct rcu_data *rdp = rsp->rda[smp_processor_id()];
  738. if (rdp->nxtlist == NULL)
  739. return; /* irqs disabled, so comparison is stable. */
  740. spin_lock(&rsp->onofflock); /* irqs already disabled. */
  741. *rsp->orphan_cbs_tail = rdp->nxtlist;
  742. rsp->orphan_cbs_tail = rdp->nxttail[RCU_NEXT_TAIL];
  743. rdp->nxtlist = NULL;
  744. for (i = 0; i < RCU_NEXT_SIZE; i++)
  745. rdp->nxttail[i] = &rdp->nxtlist;
  746. rsp->orphan_qlen += rdp->qlen;
  747. rdp->qlen = 0;
  748. spin_unlock(&rsp->onofflock); /* irqs remain disabled. */
  749. }
  750. /*
  751. * Adopt previously orphaned RCU callbacks.
  752. */
  753. static void rcu_adopt_orphan_cbs(struct rcu_state *rsp)
  754. {
  755. unsigned long flags;
  756. struct rcu_data *rdp;
  757. spin_lock_irqsave(&rsp->onofflock, flags);
  758. rdp = rsp->rda[smp_processor_id()];
  759. if (rsp->orphan_cbs_list == NULL) {
  760. spin_unlock_irqrestore(&rsp->onofflock, flags);
  761. return;
  762. }
  763. *rdp->nxttail[RCU_NEXT_TAIL] = rsp->orphan_cbs_list;
  764. rdp->nxttail[RCU_NEXT_TAIL] = rsp->orphan_cbs_tail;
  765. rdp->qlen += rsp->orphan_qlen;
  766. rsp->orphan_cbs_list = NULL;
  767. rsp->orphan_cbs_tail = &rsp->orphan_cbs_list;
  768. rsp->orphan_qlen = 0;
  769. spin_unlock_irqrestore(&rsp->onofflock, flags);
  770. }
  771. /*
  772. * Remove the outgoing CPU from the bitmasks in the rcu_node hierarchy
  773. * and move all callbacks from the outgoing CPU to the current one.
  774. */
  775. static void __rcu_offline_cpu(int cpu, struct rcu_state *rsp)
  776. {
  777. unsigned long flags;
  778. long lastcomp;
  779. unsigned long mask;
  780. struct rcu_data *rdp = rsp->rda[cpu];
  781. struct rcu_node *rnp;
  782. /* Exclude any attempts to start a new grace period. */
  783. spin_lock_irqsave(&rsp->onofflock, flags);
  784. /* Remove the outgoing CPU from the masks in the rcu_node hierarchy. */
  785. rnp = rdp->mynode; /* this is the outgoing CPU's rnp. */
  786. mask = rdp->grpmask; /* rnp->grplo is constant. */
  787. do {
  788. spin_lock(&rnp->lock); /* irqs already disabled. */
  789. rnp->qsmaskinit &= ~mask;
  790. if (rnp->qsmaskinit != 0) {
  791. spin_unlock(&rnp->lock); /* irqs remain disabled. */
  792. break;
  793. }
  794. rcu_preempt_offline_tasks(rsp, rnp, rdp);
  795. mask = rnp->grpmask;
  796. spin_unlock(&rnp->lock); /* irqs remain disabled. */
  797. rnp = rnp->parent;
  798. } while (rnp != NULL);
  799. lastcomp = rsp->completed;
  800. spin_unlock_irqrestore(&rsp->onofflock, flags);
  801. rcu_adopt_orphan_cbs(rsp);
  802. }
  803. /*
  804. * Remove the specified CPU from the RCU hierarchy and move any pending
  805. * callbacks that it might have to the current CPU. This code assumes
  806. * that at least one CPU in the system will remain running at all times.
  807. * Any attempt to offline -all- CPUs is likely to strand RCU callbacks.
  808. */
  809. static void rcu_offline_cpu(int cpu)
  810. {
  811. __rcu_offline_cpu(cpu, &rcu_sched_state);
  812. __rcu_offline_cpu(cpu, &rcu_bh_state);
  813. rcu_preempt_offline_cpu(cpu);
  814. }
  815. #else /* #ifdef CONFIG_HOTPLUG_CPU */
  816. static void rcu_send_cbs_to_orphanage(struct rcu_state *rsp)
  817. {
  818. }
  819. static void rcu_adopt_orphan_cbs(struct rcu_state *rsp)
  820. {
  821. }
  822. static void rcu_offline_cpu(int cpu)
  823. {
  824. }
  825. #endif /* #else #ifdef CONFIG_HOTPLUG_CPU */
  826. /*
  827. * Invoke any RCU callbacks that have made it to the end of their grace
  828. * period. Thottle as specified by rdp->blimit.
  829. */
  830. static void rcu_do_batch(struct rcu_data *rdp)
  831. {
  832. unsigned long flags;
  833. struct rcu_head *next, *list, **tail;
  834. int count;
  835. /* If no callbacks are ready, just return.*/
  836. if (!cpu_has_callbacks_ready_to_invoke(rdp))
  837. return;
  838. /*
  839. * Extract the list of ready callbacks, disabling to prevent
  840. * races with call_rcu() from interrupt handlers.
  841. */
  842. local_irq_save(flags);
  843. list = rdp->nxtlist;
  844. rdp->nxtlist = *rdp->nxttail[RCU_DONE_TAIL];
  845. *rdp->nxttail[RCU_DONE_TAIL] = NULL;
  846. tail = rdp->nxttail[RCU_DONE_TAIL];
  847. for (count = RCU_NEXT_SIZE - 1; count >= 0; count--)
  848. if (rdp->nxttail[count] == rdp->nxttail[RCU_DONE_TAIL])
  849. rdp->nxttail[count] = &rdp->nxtlist;
  850. local_irq_restore(flags);
  851. /* Invoke callbacks. */
  852. count = 0;
  853. while (list) {
  854. next = list->next;
  855. prefetch(next);
  856. list->func(list);
  857. list = next;
  858. if (++count >= rdp->blimit)
  859. break;
  860. }
  861. local_irq_save(flags);
  862. /* Update count, and requeue any remaining callbacks. */
  863. rdp->qlen -= count;
  864. if (list != NULL) {
  865. *tail = rdp->nxtlist;
  866. rdp->nxtlist = list;
  867. for (count = 0; count < RCU_NEXT_SIZE; count++)
  868. if (&rdp->nxtlist == rdp->nxttail[count])
  869. rdp->nxttail[count] = tail;
  870. else
  871. break;
  872. }
  873. /* Reinstate batch limit if we have worked down the excess. */
  874. if (rdp->blimit == LONG_MAX && rdp->qlen <= qlowmark)
  875. rdp->blimit = blimit;
  876. local_irq_restore(flags);
  877. /* Re-raise the RCU softirq if there are callbacks remaining. */
  878. if (cpu_has_callbacks_ready_to_invoke(rdp))
  879. raise_softirq(RCU_SOFTIRQ);
  880. }
  881. /*
  882. * Check to see if this CPU is in a non-context-switch quiescent state
  883. * (user mode or idle loop for rcu, non-softirq execution for rcu_bh).
  884. * Also schedule the RCU softirq handler.
  885. *
  886. * This function must be called with hardirqs disabled. It is normally
  887. * invoked from the scheduling-clock interrupt. If rcu_pending returns
  888. * false, there is no point in invoking rcu_check_callbacks().
  889. */
  890. void rcu_check_callbacks(int cpu, int user)
  891. {
  892. if (!rcu_pending(cpu))
  893. return; /* if nothing for RCU to do. */
  894. if (user ||
  895. (idle_cpu(cpu) && rcu_scheduler_active &&
  896. !in_softirq() && hardirq_count() <= (1 << HARDIRQ_SHIFT))) {
  897. /*
  898. * Get here if this CPU took its interrupt from user
  899. * mode or from the idle loop, and if this is not a
  900. * nested interrupt. In this case, the CPU is in
  901. * a quiescent state, so note it.
  902. *
  903. * No memory barrier is required here because both
  904. * rcu_sched_qs() and rcu_bh_qs() reference only CPU-local
  905. * variables that other CPUs neither access nor modify,
  906. * at least not while the corresponding CPU is online.
  907. */
  908. rcu_sched_qs(cpu);
  909. rcu_bh_qs(cpu);
  910. } else if (!in_softirq()) {
  911. /*
  912. * Get here if this CPU did not take its interrupt from
  913. * softirq, in other words, if it is not interrupting
  914. * a rcu_bh read-side critical section. This is an _bh
  915. * critical section, so note it.
  916. */
  917. rcu_bh_qs(cpu);
  918. }
  919. rcu_preempt_check_callbacks(cpu);
  920. raise_softirq(RCU_SOFTIRQ);
  921. }
  922. #ifdef CONFIG_SMP
  923. /*
  924. * Scan the leaf rcu_node structures, processing dyntick state for any that
  925. * have not yet encountered a quiescent state, using the function specified.
  926. * Returns 1 if the current grace period ends while scanning (possibly
  927. * because we made it end).
  928. */
  929. static int rcu_process_dyntick(struct rcu_state *rsp, long lastcomp,
  930. int (*f)(struct rcu_data *))
  931. {
  932. unsigned long bit;
  933. int cpu;
  934. unsigned long flags;
  935. unsigned long mask;
  936. struct rcu_node *rnp;
  937. rcu_for_each_leaf_node(rsp, rnp) {
  938. mask = 0;
  939. spin_lock_irqsave(&rnp->lock, flags);
  940. if (rsp->completed != lastcomp) {
  941. spin_unlock_irqrestore(&rnp->lock, flags);
  942. return 1;
  943. }
  944. if (rnp->qsmask == 0) {
  945. spin_unlock_irqrestore(&rnp->lock, flags);
  946. continue;
  947. }
  948. cpu = rnp->grplo;
  949. bit = 1;
  950. for (; cpu <= rnp->grphi; cpu++, bit <<= 1) {
  951. if ((rnp->qsmask & bit) != 0 && f(rsp->rda[cpu]))
  952. mask |= bit;
  953. }
  954. if (mask != 0 && rsp->completed == lastcomp) {
  955. /* cpu_quiet_msk() releases rnp->lock. */
  956. cpu_quiet_msk(mask, rsp, rnp, flags);
  957. continue;
  958. }
  959. spin_unlock_irqrestore(&rnp->lock, flags);
  960. }
  961. return 0;
  962. }
  963. /*
  964. * Force quiescent states on reluctant CPUs, and also detect which
  965. * CPUs are in dyntick-idle mode.
  966. */
  967. static void force_quiescent_state(struct rcu_state *rsp, int relaxed)
  968. {
  969. unsigned long flags;
  970. long lastcomp;
  971. struct rcu_node *rnp = rcu_get_root(rsp);
  972. u8 signaled;
  973. if (!rcu_gp_in_progress(rsp))
  974. return; /* No grace period in progress, nothing to force. */
  975. if (!spin_trylock_irqsave(&rsp->fqslock, flags)) {
  976. rsp->n_force_qs_lh++; /* Inexact, can lose counts. Tough! */
  977. return; /* Someone else is already on the job. */
  978. }
  979. if (relaxed &&
  980. (long)(rsp->jiffies_force_qs - jiffies) >= 0)
  981. goto unlock_ret; /* no emergency and done recently. */
  982. rsp->n_force_qs++;
  983. spin_lock(&rnp->lock);
  984. lastcomp = rsp->completed;
  985. signaled = rsp->signaled;
  986. rsp->jiffies_force_qs = jiffies + RCU_JIFFIES_TILL_FORCE_QS;
  987. if (lastcomp == rsp->gpnum) {
  988. rsp->n_force_qs_ngp++;
  989. spin_unlock(&rnp->lock);
  990. goto unlock_ret; /* no GP in progress, time updated. */
  991. }
  992. spin_unlock(&rnp->lock);
  993. switch (signaled) {
  994. case RCU_GP_INIT:
  995. break; /* grace period still initializing, ignore. */
  996. case RCU_SAVE_DYNTICK:
  997. if (RCU_SIGNAL_INIT != RCU_SAVE_DYNTICK)
  998. break; /* So gcc recognizes the dead code. */
  999. /* Record dyntick-idle state. */
  1000. if (rcu_process_dyntick(rsp, lastcomp,
  1001. dyntick_save_progress_counter))
  1002. goto unlock_ret;
  1003. /* Update state, record completion counter. */
  1004. spin_lock(&rnp->lock);
  1005. if (lastcomp == rsp->completed) {
  1006. rsp->signaled = RCU_FORCE_QS;
  1007. dyntick_record_completed(rsp, lastcomp);
  1008. }
  1009. spin_unlock(&rnp->lock);
  1010. break;
  1011. case RCU_FORCE_QS:
  1012. /* Check dyntick-idle state, send IPI to laggarts. */
  1013. if (rcu_process_dyntick(rsp, dyntick_recall_completed(rsp),
  1014. rcu_implicit_dynticks_qs))
  1015. goto unlock_ret;
  1016. /* Leave state in case more forcing is required. */
  1017. break;
  1018. }
  1019. unlock_ret:
  1020. spin_unlock_irqrestore(&rsp->fqslock, flags);
  1021. }
  1022. #else /* #ifdef CONFIG_SMP */
  1023. static void force_quiescent_state(struct rcu_state *rsp, int relaxed)
  1024. {
  1025. set_need_resched();
  1026. }
  1027. #endif /* #else #ifdef CONFIG_SMP */
  1028. /*
  1029. * This does the RCU processing work from softirq context for the
  1030. * specified rcu_state and rcu_data structures. This may be called
  1031. * only from the CPU to whom the rdp belongs.
  1032. */
  1033. static void
  1034. __rcu_process_callbacks(struct rcu_state *rsp, struct rcu_data *rdp)
  1035. {
  1036. unsigned long flags;
  1037. WARN_ON_ONCE(rdp->beenonline == 0);
  1038. /*
  1039. * If an RCU GP has gone long enough, go check for dyntick
  1040. * idle CPUs and, if needed, send resched IPIs.
  1041. */
  1042. if ((long)(ACCESS_ONCE(rsp->jiffies_force_qs) - jiffies) < 0)
  1043. force_quiescent_state(rsp, 1);
  1044. /*
  1045. * Advance callbacks in response to end of earlier grace
  1046. * period that some other CPU ended.
  1047. */
  1048. rcu_process_gp_end(rsp, rdp);
  1049. /* Update RCU state based on any recent quiescent states. */
  1050. rcu_check_quiescent_state(rsp, rdp);
  1051. /* Does this CPU require a not-yet-started grace period? */
  1052. if (cpu_needs_another_gp(rsp, rdp)) {
  1053. spin_lock_irqsave(&rcu_get_root(rsp)->lock, flags);
  1054. rcu_start_gp(rsp, flags); /* releases above lock */
  1055. }
  1056. /* If there are callbacks ready, invoke them. */
  1057. rcu_do_batch(rdp);
  1058. }
  1059. /*
  1060. * Do softirq processing for the current CPU.
  1061. */
  1062. static void rcu_process_callbacks(struct softirq_action *unused)
  1063. {
  1064. /*
  1065. * Memory references from any prior RCU read-side critical sections
  1066. * executed by the interrupted code must be seen before any RCU
  1067. * grace-period manipulations below.
  1068. */
  1069. smp_mb(); /* See above block comment. */
  1070. __rcu_process_callbacks(&rcu_sched_state,
  1071. &__get_cpu_var(rcu_sched_data));
  1072. __rcu_process_callbacks(&rcu_bh_state, &__get_cpu_var(rcu_bh_data));
  1073. rcu_preempt_process_callbacks();
  1074. /*
  1075. * Memory references from any later RCU read-side critical sections
  1076. * executed by the interrupted code must be seen after any RCU
  1077. * grace-period manipulations above.
  1078. */
  1079. smp_mb(); /* See above block comment. */
  1080. }
  1081. static void
  1082. __call_rcu(struct rcu_head *head, void (*func)(struct rcu_head *rcu),
  1083. struct rcu_state *rsp)
  1084. {
  1085. unsigned long flags;
  1086. struct rcu_data *rdp;
  1087. head->func = func;
  1088. head->next = NULL;
  1089. smp_mb(); /* Ensure RCU update seen before callback registry. */
  1090. /*
  1091. * Opportunistically note grace-period endings and beginnings.
  1092. * Note that we might see a beginning right after we see an
  1093. * end, but never vice versa, since this CPU has to pass through
  1094. * a quiescent state betweentimes.
  1095. */
  1096. local_irq_save(flags);
  1097. rdp = rsp->rda[smp_processor_id()];
  1098. rcu_process_gp_end(rsp, rdp);
  1099. check_for_new_grace_period(rsp, rdp);
  1100. /* Add the callback to our list. */
  1101. *rdp->nxttail[RCU_NEXT_TAIL] = head;
  1102. rdp->nxttail[RCU_NEXT_TAIL] = &head->next;
  1103. /* Start a new grace period if one not already started. */
  1104. if (!rcu_gp_in_progress(rsp)) {
  1105. unsigned long nestflag;
  1106. struct rcu_node *rnp_root = rcu_get_root(rsp);
  1107. spin_lock_irqsave(&rnp_root->lock, nestflag);
  1108. rcu_start_gp(rsp, nestflag); /* releases rnp_root->lock. */
  1109. }
  1110. /* Force the grace period if too many callbacks or too long waiting. */
  1111. if (unlikely(++rdp->qlen > qhimark)) {
  1112. rdp->blimit = LONG_MAX;
  1113. force_quiescent_state(rsp, 0);
  1114. } else if ((long)(ACCESS_ONCE(rsp->jiffies_force_qs) - jiffies) < 0)
  1115. force_quiescent_state(rsp, 1);
  1116. local_irq_restore(flags);
  1117. }
  1118. /*
  1119. * Queue an RCU-sched callback for invocation after a grace period.
  1120. */
  1121. void call_rcu_sched(struct rcu_head *head, void (*func)(struct rcu_head *rcu))
  1122. {
  1123. __call_rcu(head, func, &rcu_sched_state);
  1124. }
  1125. EXPORT_SYMBOL_GPL(call_rcu_sched);
  1126. /*
  1127. * Queue an RCU for invocation after a quicker grace period.
  1128. */
  1129. void call_rcu_bh(struct rcu_head *head, void (*func)(struct rcu_head *rcu))
  1130. {
  1131. __call_rcu(head, func, &rcu_bh_state);
  1132. }
  1133. EXPORT_SYMBOL_GPL(call_rcu_bh);
  1134. /*
  1135. * Check to see if there is any immediate RCU-related work to be done
  1136. * by the current CPU, for the specified type of RCU, returning 1 if so.
  1137. * The checks are in order of increasing expense: checks that can be
  1138. * carried out against CPU-local state are performed first. However,
  1139. * we must check for CPU stalls first, else we might not get a chance.
  1140. */
  1141. static int __rcu_pending(struct rcu_state *rsp, struct rcu_data *rdp)
  1142. {
  1143. rdp->n_rcu_pending++;
  1144. /* Check for CPU stalls, if enabled. */
  1145. check_cpu_stall(rsp, rdp);
  1146. /* Is the RCU core waiting for a quiescent state from this CPU? */
  1147. if (rdp->qs_pending) {
  1148. rdp->n_rp_qs_pending++;
  1149. return 1;
  1150. }
  1151. /* Does this CPU have callbacks ready to invoke? */
  1152. if (cpu_has_callbacks_ready_to_invoke(rdp)) {
  1153. rdp->n_rp_cb_ready++;
  1154. return 1;
  1155. }
  1156. /* Has RCU gone idle with this CPU needing another grace period? */
  1157. if (cpu_needs_another_gp(rsp, rdp)) {
  1158. rdp->n_rp_cpu_needs_gp++;
  1159. return 1;
  1160. }
  1161. /* Has another RCU grace period completed? */
  1162. if (ACCESS_ONCE(rsp->completed) != rdp->completed) { /* outside lock */
  1163. rdp->n_rp_gp_completed++;
  1164. return 1;
  1165. }
  1166. /* Has a new RCU grace period started? */
  1167. if (ACCESS_ONCE(rsp->gpnum) != rdp->gpnum) { /* outside lock */
  1168. rdp->n_rp_gp_started++;
  1169. return 1;
  1170. }
  1171. /* Has an RCU GP gone long enough to send resched IPIs &c? */
  1172. if (rcu_gp_in_progress(rsp) &&
  1173. ((long)(ACCESS_ONCE(rsp->jiffies_force_qs) - jiffies) < 0)) {
  1174. rdp->n_rp_need_fqs++;
  1175. return 1;
  1176. }
  1177. /* nothing to do */
  1178. rdp->n_rp_need_nothing++;
  1179. return 0;
  1180. }
  1181. /*
  1182. * Check to see if there is any immediate RCU-related work to be done
  1183. * by the current CPU, returning 1 if so. This function is part of the
  1184. * RCU implementation; it is -not- an exported member of the RCU API.
  1185. */
  1186. static int rcu_pending(int cpu)
  1187. {
  1188. return __rcu_pending(&rcu_sched_state, &per_cpu(rcu_sched_data, cpu)) ||
  1189. __rcu_pending(&rcu_bh_state, &per_cpu(rcu_bh_data, cpu)) ||
  1190. rcu_preempt_pending(cpu);
  1191. }
  1192. /*
  1193. * Check to see if any future RCU-related work will need to be done
  1194. * by the current CPU, even if none need be done immediately, returning
  1195. * 1 if so. This function is part of the RCU implementation; it is -not-
  1196. * an exported member of the RCU API.
  1197. */
  1198. int rcu_needs_cpu(int cpu)
  1199. {
  1200. /* RCU callbacks either ready or pending? */
  1201. return per_cpu(rcu_sched_data, cpu).nxtlist ||
  1202. per_cpu(rcu_bh_data, cpu).nxtlist ||
  1203. rcu_preempt_needs_cpu(cpu);
  1204. }
  1205. static DEFINE_PER_CPU(struct rcu_head, rcu_barrier_head) = {NULL};
  1206. static atomic_t rcu_barrier_cpu_count;
  1207. static DEFINE_MUTEX(rcu_barrier_mutex);
  1208. static struct completion rcu_barrier_completion;
  1209. static void rcu_barrier_callback(struct rcu_head *notused)
  1210. {
  1211. if (atomic_dec_and_test(&rcu_barrier_cpu_count))
  1212. complete(&rcu_barrier_completion);
  1213. }
  1214. /*
  1215. * Called with preemption disabled, and from cross-cpu IRQ context.
  1216. */
  1217. static void rcu_barrier_func(void *type)
  1218. {
  1219. int cpu = smp_processor_id();
  1220. struct rcu_head *head = &per_cpu(rcu_barrier_head, cpu);
  1221. void (*call_rcu_func)(struct rcu_head *head,
  1222. void (*func)(struct rcu_head *head));
  1223. atomic_inc(&rcu_barrier_cpu_count);
  1224. call_rcu_func = type;
  1225. call_rcu_func(head, rcu_barrier_callback);
  1226. }
  1227. /*
  1228. * Orchestrate the specified type of RCU barrier, waiting for all
  1229. * RCU callbacks of the specified type to complete.
  1230. */
  1231. static void _rcu_barrier(struct rcu_state *rsp,
  1232. void (*call_rcu_func)(struct rcu_head *head,
  1233. void (*func)(struct rcu_head *head)))
  1234. {
  1235. BUG_ON(in_interrupt());
  1236. /* Take mutex to serialize concurrent rcu_barrier() requests. */
  1237. mutex_lock(&rcu_barrier_mutex);
  1238. init_completion(&rcu_barrier_completion);
  1239. /*
  1240. * Initialize rcu_barrier_cpu_count to 1, then invoke
  1241. * rcu_barrier_func() on each CPU, so that each CPU also has
  1242. * incremented rcu_barrier_cpu_count. Only then is it safe to
  1243. * decrement rcu_barrier_cpu_count -- otherwise the first CPU
  1244. * might complete its grace period before all of the other CPUs
  1245. * did their increment, causing this function to return too
  1246. * early.
  1247. */
  1248. atomic_set(&rcu_barrier_cpu_count, 1);
  1249. preempt_disable(); /* stop CPU_DYING from filling orphan_cbs_list */
  1250. rcu_adopt_orphan_cbs(rsp);
  1251. on_each_cpu(rcu_barrier_func, (void *)call_rcu_func, 1);
  1252. preempt_enable(); /* CPU_DYING can again fill orphan_cbs_list */
  1253. if (atomic_dec_and_test(&rcu_barrier_cpu_count))
  1254. complete(&rcu_barrier_completion);
  1255. wait_for_completion(&rcu_barrier_completion);
  1256. mutex_unlock(&rcu_barrier_mutex);
  1257. }
  1258. /**
  1259. * rcu_barrier_bh - Wait until all in-flight call_rcu_bh() callbacks complete.
  1260. */
  1261. void rcu_barrier_bh(void)
  1262. {
  1263. _rcu_barrier(&rcu_bh_state, call_rcu_bh);
  1264. }
  1265. EXPORT_SYMBOL_GPL(rcu_barrier_bh);
  1266. /**
  1267. * rcu_barrier_sched - Wait for in-flight call_rcu_sched() callbacks.
  1268. */
  1269. void rcu_barrier_sched(void)
  1270. {
  1271. _rcu_barrier(&rcu_sched_state, call_rcu_sched);
  1272. }
  1273. EXPORT_SYMBOL_GPL(rcu_barrier_sched);
  1274. /*
  1275. * Do boot-time initialization of a CPU's per-CPU RCU data.
  1276. */
  1277. static void __init
  1278. rcu_boot_init_percpu_data(int cpu, struct rcu_state *rsp)
  1279. {
  1280. unsigned long flags;
  1281. int i;
  1282. struct rcu_data *rdp = rsp->rda[cpu];
  1283. struct rcu_node *rnp = rcu_get_root(rsp);
  1284. /* Set up local state, ensuring consistent view of global state. */
  1285. spin_lock_irqsave(&rnp->lock, flags);
  1286. rdp->grpmask = 1UL << (cpu - rdp->mynode->grplo);
  1287. rdp->nxtlist = NULL;
  1288. for (i = 0; i < RCU_NEXT_SIZE; i++)
  1289. rdp->nxttail[i] = &rdp->nxtlist;
  1290. rdp->qlen = 0;
  1291. #ifdef CONFIG_NO_HZ
  1292. rdp->dynticks = &per_cpu(rcu_dynticks, cpu);
  1293. #endif /* #ifdef CONFIG_NO_HZ */
  1294. rdp->cpu = cpu;
  1295. spin_unlock_irqrestore(&rnp->lock, flags);
  1296. }
  1297. /*
  1298. * Initialize a CPU's per-CPU RCU data. Note that only one online or
  1299. * offline event can be happening at a given time. Note also that we
  1300. * can accept some slop in the rsp->completed access due to the fact
  1301. * that this CPU cannot possibly have any RCU callbacks in flight yet.
  1302. */
  1303. static void __cpuinit
  1304. rcu_init_percpu_data(int cpu, struct rcu_state *rsp, int preemptable)
  1305. {
  1306. unsigned long flags;
  1307. long lastcomp;
  1308. unsigned long mask;
  1309. struct rcu_data *rdp = rsp->rda[cpu];
  1310. struct rcu_node *rnp = rcu_get_root(rsp);
  1311. /* Set up local state, ensuring consistent view of global state. */
  1312. spin_lock_irqsave(&rnp->lock, flags);
  1313. lastcomp = rsp->completed;
  1314. rdp->completed = lastcomp;
  1315. rdp->gpnum = lastcomp;
  1316. rdp->passed_quiesc = 0; /* We could be racing with new GP, */
  1317. rdp->qs_pending = 1; /* so set up to respond to current GP. */
  1318. rdp->beenonline = 1; /* We have now been online. */
  1319. rdp->preemptable = preemptable;
  1320. rdp->passed_quiesc_completed = lastcomp - 1;
  1321. rdp->blimit = blimit;
  1322. spin_unlock(&rnp->lock); /* irqs remain disabled. */
  1323. /*
  1324. * A new grace period might start here. If so, we won't be part
  1325. * of it, but that is OK, as we are currently in a quiescent state.
  1326. */
  1327. /* Exclude any attempts to start a new GP on large systems. */
  1328. spin_lock(&rsp->onofflock); /* irqs already disabled. */
  1329. /* Add CPU to rcu_node bitmasks. */
  1330. rnp = rdp->mynode;
  1331. mask = rdp->grpmask;
  1332. do {
  1333. /* Exclude any attempts to start a new GP on small systems. */
  1334. spin_lock(&rnp->lock); /* irqs already disabled. */
  1335. rnp->qsmaskinit |= mask;
  1336. mask = rnp->grpmask;
  1337. spin_unlock(&rnp->lock); /* irqs already disabled. */
  1338. rnp = rnp->parent;
  1339. } while (rnp != NULL && !(rnp->qsmaskinit & mask));
  1340. spin_unlock_irqrestore(&rsp->onofflock, flags);
  1341. }
  1342. static void __cpuinit rcu_online_cpu(int cpu)
  1343. {
  1344. rcu_init_percpu_data(cpu, &rcu_sched_state, 0);
  1345. rcu_init_percpu_data(cpu, &rcu_bh_state, 0);
  1346. rcu_preempt_init_percpu_data(cpu);
  1347. }
  1348. /*
  1349. * Handle CPU online/offline notification events.
  1350. */
  1351. int __cpuinit rcu_cpu_notify(struct notifier_block *self,
  1352. unsigned long action, void *hcpu)
  1353. {
  1354. long cpu = (long)hcpu;
  1355. switch (action) {
  1356. case CPU_UP_PREPARE:
  1357. case CPU_UP_PREPARE_FROZEN:
  1358. rcu_online_cpu(cpu);
  1359. break;
  1360. case CPU_DYING:
  1361. case CPU_DYING_FROZEN:
  1362. /*
  1363. * preempt_disable() in _rcu_barrier() prevents stop_machine(),
  1364. * so when "on_each_cpu(rcu_barrier_func, (void *)type, 1);"
  1365. * returns, all online cpus have queued rcu_barrier_func().
  1366. * The dying CPU clears its cpu_online_mask bit and
  1367. * moves all of its RCU callbacks to ->orphan_cbs_list
  1368. * in the context of stop_machine(), so subsequent calls
  1369. * to _rcu_barrier() will adopt these callbacks and only
  1370. * then queue rcu_barrier_func() on all remaining CPUs.
  1371. */
  1372. rcu_send_cbs_to_orphanage(&rcu_bh_state);
  1373. rcu_send_cbs_to_orphanage(&rcu_sched_state);
  1374. rcu_preempt_send_cbs_to_orphanage();
  1375. break;
  1376. case CPU_DEAD:
  1377. case CPU_DEAD_FROZEN:
  1378. case CPU_UP_CANCELED:
  1379. case CPU_UP_CANCELED_FROZEN:
  1380. rcu_offline_cpu(cpu);
  1381. break;
  1382. default:
  1383. break;
  1384. }
  1385. return NOTIFY_OK;
  1386. }
  1387. /*
  1388. * Compute the per-level fanout, either using the exact fanout specified
  1389. * or balancing the tree, depending on CONFIG_RCU_FANOUT_EXACT.
  1390. */
  1391. #ifdef CONFIG_RCU_FANOUT_EXACT
  1392. static void __init rcu_init_levelspread(struct rcu_state *rsp)
  1393. {
  1394. int i;
  1395. for (i = NUM_RCU_LVLS - 1; i >= 0; i--)
  1396. rsp->levelspread[i] = CONFIG_RCU_FANOUT;
  1397. }
  1398. #else /* #ifdef CONFIG_RCU_FANOUT_EXACT */
  1399. static void __init rcu_init_levelspread(struct rcu_state *rsp)
  1400. {
  1401. int ccur;
  1402. int cprv;
  1403. int i;
  1404. cprv = NR_CPUS;
  1405. for (i = NUM_RCU_LVLS - 1; i >= 0; i--) {
  1406. ccur = rsp->levelcnt[i];
  1407. rsp->levelspread[i] = (cprv + ccur - 1) / ccur;
  1408. cprv = ccur;
  1409. }
  1410. }
  1411. #endif /* #else #ifdef CONFIG_RCU_FANOUT_EXACT */
  1412. /*
  1413. * Helper function for rcu_init() that initializes one rcu_state structure.
  1414. */
  1415. static void __init rcu_init_one(struct rcu_state *rsp)
  1416. {
  1417. int cpustride = 1;
  1418. int i;
  1419. int j;
  1420. struct rcu_node *rnp;
  1421. /* Initialize the level-tracking arrays. */
  1422. for (i = 1; i < NUM_RCU_LVLS; i++)
  1423. rsp->level[i] = rsp->level[i - 1] + rsp->levelcnt[i - 1];
  1424. rcu_init_levelspread(rsp);
  1425. /* Initialize the elements themselves, starting from the leaves. */
  1426. for (i = NUM_RCU_LVLS - 1; i >= 0; i--) {
  1427. cpustride *= rsp->levelspread[i];
  1428. rnp = rsp->level[i];
  1429. for (j = 0; j < rsp->levelcnt[i]; j++, rnp++) {
  1430. if (rnp != rcu_get_root(rsp))
  1431. spin_lock_init(&rnp->lock);
  1432. rnp->gpnum = 0;
  1433. rnp->qsmask = 0;
  1434. rnp->qsmaskinit = 0;
  1435. rnp->grplo = j * cpustride;
  1436. rnp->grphi = (j + 1) * cpustride - 1;
  1437. if (rnp->grphi >= NR_CPUS)
  1438. rnp->grphi = NR_CPUS - 1;
  1439. if (i == 0) {
  1440. rnp->grpnum = 0;
  1441. rnp->grpmask = 0;
  1442. rnp->parent = NULL;
  1443. } else {
  1444. rnp->grpnum = j % rsp->levelspread[i - 1];
  1445. rnp->grpmask = 1UL << rnp->grpnum;
  1446. rnp->parent = rsp->level[i - 1] +
  1447. j / rsp->levelspread[i - 1];
  1448. }
  1449. rnp->level = i;
  1450. INIT_LIST_HEAD(&rnp->blocked_tasks[0]);
  1451. INIT_LIST_HEAD(&rnp->blocked_tasks[1]);
  1452. }
  1453. }
  1454. spin_lock_init(&rcu_get_root(rsp)->lock);
  1455. }
  1456. /*
  1457. * Helper macro for __rcu_init() and __rcu_init_preempt(). To be used
  1458. * nowhere else! Assigns leaf node pointers into each CPU's rcu_data
  1459. * structure.
  1460. */
  1461. #define RCU_INIT_FLAVOR(rsp, rcu_data) \
  1462. do { \
  1463. int i; \
  1464. int j; \
  1465. struct rcu_node *rnp; \
  1466. \
  1467. rcu_init_one(rsp); \
  1468. rnp = (rsp)->level[NUM_RCU_LVLS - 1]; \
  1469. j = 0; \
  1470. for_each_possible_cpu(i) { \
  1471. if (i > rnp[j].grphi) \
  1472. j++; \
  1473. per_cpu(rcu_data, i).mynode = &rnp[j]; \
  1474. (rsp)->rda[i] = &per_cpu(rcu_data, i); \
  1475. rcu_boot_init_percpu_data(i, rsp); \
  1476. } \
  1477. } while (0)
  1478. void __init __rcu_init(void)
  1479. {
  1480. rcu_bootup_announce();
  1481. #ifdef CONFIG_RCU_CPU_STALL_DETECTOR
  1482. printk(KERN_INFO "RCU-based detection of stalled CPUs is enabled.\n");
  1483. #endif /* #ifdef CONFIG_RCU_CPU_STALL_DETECTOR */
  1484. RCU_INIT_FLAVOR(&rcu_sched_state, rcu_sched_data);
  1485. RCU_INIT_FLAVOR(&rcu_bh_state, rcu_bh_data);
  1486. __rcu_init_preempt();
  1487. open_softirq(RCU_SOFTIRQ, rcu_process_callbacks);
  1488. }
  1489. #include "rcutree_plugin.h"