tick-sched.c 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667
  1. /*
  2. * linux/kernel/time/tick-sched.c
  3. *
  4. * Copyright(C) 2005-2006, Thomas Gleixner <tglx@linutronix.de>
  5. * Copyright(C) 2005-2007, Red Hat, Inc., Ingo Molnar
  6. * Copyright(C) 2006-2007 Timesys Corp., Thomas Gleixner
  7. *
  8. * No idle tick implementation for low and high resolution timers
  9. *
  10. * Started by: Thomas Gleixner and Ingo Molnar
  11. *
  12. * For licencing details see kernel-base/COPYING
  13. */
  14. #include <linux/cpu.h>
  15. #include <linux/err.h>
  16. #include <linux/hrtimer.h>
  17. #include <linux/interrupt.h>
  18. #include <linux/kernel_stat.h>
  19. #include <linux/percpu.h>
  20. #include <linux/profile.h>
  21. #include <linux/sched.h>
  22. #include <linux/tick.h>
  23. #include <asm/irq_regs.h>
  24. #include "tick-internal.h"
  25. /*
  26. * Per cpu nohz control structure
  27. */
  28. static DEFINE_PER_CPU(struct tick_sched, tick_cpu_sched);
  29. /*
  30. * The time, when the last jiffy update happened. Protected by xtime_lock.
  31. */
  32. static ktime_t last_jiffies_update;
  33. struct tick_sched *tick_get_tick_sched(int cpu)
  34. {
  35. return &per_cpu(tick_cpu_sched, cpu);
  36. }
  37. /*
  38. * Must be called with interrupts disabled !
  39. */
  40. static void tick_do_update_jiffies64(ktime_t now)
  41. {
  42. unsigned long ticks = 0;
  43. ktime_t delta;
  44. /* Reevalute with xtime_lock held */
  45. write_seqlock(&xtime_lock);
  46. delta = ktime_sub(now, last_jiffies_update);
  47. if (delta.tv64 >= tick_period.tv64) {
  48. delta = ktime_sub(delta, tick_period);
  49. last_jiffies_update = ktime_add(last_jiffies_update,
  50. tick_period);
  51. /* Slow path for long timeouts */
  52. if (unlikely(delta.tv64 >= tick_period.tv64)) {
  53. s64 incr = ktime_to_ns(tick_period);
  54. ticks = ktime_divns(delta, incr);
  55. last_jiffies_update = ktime_add_ns(last_jiffies_update,
  56. incr * ticks);
  57. }
  58. do_timer(++ticks);
  59. }
  60. write_sequnlock(&xtime_lock);
  61. }
  62. /*
  63. * Initialize and return retrieve the jiffies update.
  64. */
  65. static ktime_t tick_init_jiffy_update(void)
  66. {
  67. ktime_t period;
  68. write_seqlock(&xtime_lock);
  69. /* Did we start the jiffies update yet ? */
  70. if (last_jiffies_update.tv64 == 0)
  71. last_jiffies_update = tick_next_period;
  72. period = last_jiffies_update;
  73. write_sequnlock(&xtime_lock);
  74. return period;
  75. }
  76. /*
  77. * NOHZ - aka dynamic tick functionality
  78. */
  79. #ifdef CONFIG_NO_HZ
  80. /*
  81. * NO HZ enabled ?
  82. */
  83. static int tick_nohz_enabled __read_mostly = 1;
  84. /*
  85. * Enable / Disable tickless mode
  86. */
  87. static int __init setup_tick_nohz(char *str)
  88. {
  89. if (!strcmp(str, "off"))
  90. tick_nohz_enabled = 0;
  91. else if (!strcmp(str, "on"))
  92. tick_nohz_enabled = 1;
  93. else
  94. return 0;
  95. return 1;
  96. }
  97. __setup("nohz=", setup_tick_nohz);
  98. /**
  99. * tick_nohz_update_jiffies - update jiffies when idle was interrupted
  100. *
  101. * Called from interrupt entry when the CPU was idle
  102. *
  103. * In case the sched_tick was stopped on this CPU, we have to check if jiffies
  104. * must be updated. Otherwise an interrupt handler could use a stale jiffy
  105. * value. We do this unconditionally on any cpu, as we don't know whether the
  106. * cpu, which has the update task assigned is in a long sleep.
  107. */
  108. void tick_nohz_update_jiffies(void)
  109. {
  110. int cpu = smp_processor_id();
  111. struct tick_sched *ts = &per_cpu(tick_cpu_sched, cpu);
  112. unsigned long flags;
  113. ktime_t now;
  114. if (!ts->tick_stopped)
  115. return;
  116. cpu_clear(cpu, nohz_cpu_mask);
  117. now = ktime_get();
  118. local_irq_save(flags);
  119. tick_do_update_jiffies64(now);
  120. local_irq_restore(flags);
  121. }
  122. /**
  123. * tick_nohz_stop_sched_tick - stop the idle tick from the idle task
  124. *
  125. * When the next event is more than a tick into the future, stop the idle tick
  126. * Called either from the idle loop or from irq_exit() when an idle period was
  127. * just interrupted by an interrupt which did not cause a reschedule.
  128. */
  129. void tick_nohz_stop_sched_tick(void)
  130. {
  131. unsigned long seq, last_jiffies, next_jiffies, delta_jiffies, flags;
  132. struct tick_sched *ts;
  133. ktime_t last_update, expires, now, delta;
  134. struct clock_event_device *dev = __get_cpu_var(tick_cpu_device).evtdev;
  135. int cpu;
  136. local_irq_save(flags);
  137. cpu = smp_processor_id();
  138. ts = &per_cpu(tick_cpu_sched, cpu);
  139. /*
  140. * If this cpu is offline and it is the one which updates
  141. * jiffies, then give up the assignment and let it be taken by
  142. * the cpu which runs the tick timer next. If we don't drop
  143. * this here the jiffies might be stale and do_timer() never
  144. * invoked.
  145. */
  146. if (unlikely(!cpu_online(cpu))) {
  147. if (cpu == tick_do_timer_cpu)
  148. tick_do_timer_cpu = -1;
  149. }
  150. if (unlikely(ts->nohz_mode == NOHZ_MODE_INACTIVE))
  151. goto end;
  152. if (need_resched())
  153. goto end;
  154. cpu = smp_processor_id();
  155. if (unlikely(local_softirq_pending())) {
  156. static int ratelimit;
  157. if (ratelimit < 10) {
  158. printk(KERN_ERR "NOHZ: local_softirq_pending %02x\n",
  159. local_softirq_pending());
  160. ratelimit++;
  161. }
  162. }
  163. now = ktime_get();
  164. /*
  165. * When called from irq_exit we need to account the idle sleep time
  166. * correctly.
  167. */
  168. if (ts->tick_stopped) {
  169. delta = ktime_sub(now, ts->idle_entrytime);
  170. ts->idle_sleeptime = ktime_add(ts->idle_sleeptime, delta);
  171. }
  172. ts->idle_entrytime = now;
  173. ts->idle_calls++;
  174. /* Read jiffies and the time when jiffies were updated last */
  175. do {
  176. seq = read_seqbegin(&xtime_lock);
  177. last_update = last_jiffies_update;
  178. last_jiffies = jiffies;
  179. } while (read_seqretry(&xtime_lock, seq));
  180. /* Get the next timer wheel timer */
  181. next_jiffies = get_next_timer_interrupt(last_jiffies);
  182. delta_jiffies = next_jiffies - last_jiffies;
  183. if (rcu_needs_cpu(cpu))
  184. delta_jiffies = 1;
  185. /*
  186. * Do not stop the tick, if we are only one off
  187. * or if the cpu is required for rcu
  188. */
  189. if (!ts->tick_stopped && delta_jiffies == 1)
  190. goto out;
  191. /* Schedule the tick, if we are at least one jiffie off */
  192. if ((long)delta_jiffies >= 1) {
  193. if (delta_jiffies > 1)
  194. cpu_set(cpu, nohz_cpu_mask);
  195. /*
  196. * nohz_stop_sched_tick can be called several times before
  197. * the nohz_restart_sched_tick is called. This happens when
  198. * interrupts arrive which do not cause a reschedule. In the
  199. * first call we save the current tick time, so we can restart
  200. * the scheduler tick in nohz_restart_sched_tick.
  201. */
  202. if (!ts->tick_stopped) {
  203. if (select_nohz_load_balancer(1)) {
  204. /*
  205. * sched tick not stopped!
  206. */
  207. cpu_clear(cpu, nohz_cpu_mask);
  208. goto out;
  209. }
  210. ts->idle_tick = ts->sched_timer.expires;
  211. ts->tick_stopped = 1;
  212. ts->idle_jiffies = last_jiffies;
  213. }
  214. /*
  215. * If this cpu is the one which updates jiffies, then
  216. * give up the assignment and let it be taken by the
  217. * cpu which runs the tick timer next, which might be
  218. * this cpu as well. If we don't drop this here the
  219. * jiffies might be stale and do_timer() never
  220. * invoked.
  221. */
  222. if (cpu == tick_do_timer_cpu)
  223. tick_do_timer_cpu = -1;
  224. ts->idle_sleeps++;
  225. /*
  226. * delta_jiffies >= NEXT_TIMER_MAX_DELTA signals that
  227. * there is no timer pending or at least extremly far
  228. * into the future (12 days for HZ=1000). In this case
  229. * we simply stop the tick timer:
  230. */
  231. if (unlikely(delta_jiffies >= NEXT_TIMER_MAX_DELTA)) {
  232. ts->idle_expires.tv64 = KTIME_MAX;
  233. if (ts->nohz_mode == NOHZ_MODE_HIGHRES)
  234. hrtimer_cancel(&ts->sched_timer);
  235. goto out;
  236. }
  237. /*
  238. * calculate the expiry time for the next timer wheel
  239. * timer
  240. */
  241. expires = ktime_add_ns(last_update, tick_period.tv64 *
  242. delta_jiffies);
  243. ts->idle_expires = expires;
  244. if (ts->nohz_mode == NOHZ_MODE_HIGHRES) {
  245. hrtimer_start(&ts->sched_timer, expires,
  246. HRTIMER_MODE_ABS);
  247. /* Check, if the timer was already in the past */
  248. if (hrtimer_active(&ts->sched_timer))
  249. goto out;
  250. } else if(!tick_program_event(expires, 0))
  251. goto out;
  252. /*
  253. * We are past the event already. So we crossed a
  254. * jiffie boundary. Update jiffies and raise the
  255. * softirq.
  256. */
  257. tick_do_update_jiffies64(ktime_get());
  258. cpu_clear(cpu, nohz_cpu_mask);
  259. }
  260. raise_softirq_irqoff(TIMER_SOFTIRQ);
  261. out:
  262. ts->next_jiffies = next_jiffies;
  263. ts->last_jiffies = last_jiffies;
  264. ts->sleep_length = ktime_sub(dev->next_event, now);
  265. end:
  266. local_irq_restore(flags);
  267. }
  268. /**
  269. * tick_nohz_get_sleep_length - return the length of the current sleep
  270. *
  271. * Called from power state control code with interrupts disabled
  272. */
  273. ktime_t tick_nohz_get_sleep_length(void)
  274. {
  275. struct tick_sched *ts = &__get_cpu_var(tick_cpu_sched);
  276. return ts->sleep_length;
  277. }
  278. EXPORT_SYMBOL_GPL(tick_nohz_get_sleep_length);
  279. /**
  280. * nohz_restart_sched_tick - restart the idle tick from the idle task
  281. *
  282. * Restart the idle tick when the CPU is woken up from idle
  283. */
  284. void tick_nohz_restart_sched_tick(void)
  285. {
  286. int cpu = smp_processor_id();
  287. struct tick_sched *ts = &per_cpu(tick_cpu_sched, cpu);
  288. unsigned long ticks;
  289. ktime_t now, delta;
  290. if (!ts->tick_stopped)
  291. return;
  292. /* Update jiffies first */
  293. now = ktime_get();
  294. local_irq_disable();
  295. select_nohz_load_balancer(0);
  296. tick_do_update_jiffies64(now);
  297. cpu_clear(cpu, nohz_cpu_mask);
  298. /* Account the idle time */
  299. delta = ktime_sub(now, ts->idle_entrytime);
  300. ts->idle_sleeptime = ktime_add(ts->idle_sleeptime, delta);
  301. /*
  302. * We stopped the tick in idle. Update process times would miss the
  303. * time we slept as update_process_times does only a 1 tick
  304. * accounting. Enforce that this is accounted to idle !
  305. */
  306. ticks = jiffies - ts->idle_jiffies;
  307. /*
  308. * We might be one off. Do not randomly account a huge number of ticks!
  309. */
  310. if (ticks && ticks < LONG_MAX) {
  311. add_preempt_count(HARDIRQ_OFFSET);
  312. account_system_time(current, HARDIRQ_OFFSET,
  313. jiffies_to_cputime(ticks));
  314. sub_preempt_count(HARDIRQ_OFFSET);
  315. }
  316. /*
  317. * Cancel the scheduled timer and restore the tick
  318. */
  319. ts->tick_stopped = 0;
  320. hrtimer_cancel(&ts->sched_timer);
  321. ts->sched_timer.expires = ts->idle_tick;
  322. while (1) {
  323. /* Forward the time to expire in the future */
  324. hrtimer_forward(&ts->sched_timer, now, tick_period);
  325. if (ts->nohz_mode == NOHZ_MODE_HIGHRES) {
  326. hrtimer_start(&ts->sched_timer,
  327. ts->sched_timer.expires,
  328. HRTIMER_MODE_ABS);
  329. /* Check, if the timer was already in the past */
  330. if (hrtimer_active(&ts->sched_timer))
  331. break;
  332. } else {
  333. if (!tick_program_event(ts->sched_timer.expires, 0))
  334. break;
  335. }
  336. /* Update jiffies and reread time */
  337. tick_do_update_jiffies64(now);
  338. now = ktime_get();
  339. }
  340. local_irq_enable();
  341. }
  342. static int tick_nohz_reprogram(struct tick_sched *ts, ktime_t now)
  343. {
  344. hrtimer_forward(&ts->sched_timer, now, tick_period);
  345. return tick_program_event(ts->sched_timer.expires, 0);
  346. }
  347. /*
  348. * The nohz low res interrupt handler
  349. */
  350. static void tick_nohz_handler(struct clock_event_device *dev)
  351. {
  352. struct tick_sched *ts = &__get_cpu_var(tick_cpu_sched);
  353. struct pt_regs *regs = get_irq_regs();
  354. int cpu = smp_processor_id();
  355. ktime_t now = ktime_get();
  356. dev->next_event.tv64 = KTIME_MAX;
  357. /*
  358. * Check if the do_timer duty was dropped. We don't care about
  359. * concurrency: This happens only when the cpu in charge went
  360. * into a long sleep. If two cpus happen to assign themself to
  361. * this duty, then the jiffies update is still serialized by
  362. * xtime_lock.
  363. */
  364. if (unlikely(tick_do_timer_cpu == -1))
  365. tick_do_timer_cpu = cpu;
  366. /* Check, if the jiffies need an update */
  367. if (tick_do_timer_cpu == cpu)
  368. tick_do_update_jiffies64(now);
  369. /*
  370. * When we are idle and the tick is stopped, we have to touch
  371. * the watchdog as we might not schedule for a really long
  372. * time. This happens on complete idle SMP systems while
  373. * waiting on the login prompt. We also increment the "start
  374. * of idle" jiffy stamp so the idle accounting adjustment we
  375. * do when we go busy again does not account too much ticks.
  376. */
  377. if (ts->tick_stopped) {
  378. touch_softlockup_watchdog();
  379. ts->idle_jiffies++;
  380. }
  381. update_process_times(user_mode(regs));
  382. profile_tick(CPU_PROFILING);
  383. /* Do not restart, when we are in the idle loop */
  384. if (ts->tick_stopped)
  385. return;
  386. while (tick_nohz_reprogram(ts, now)) {
  387. now = ktime_get();
  388. tick_do_update_jiffies64(now);
  389. }
  390. }
  391. /**
  392. * tick_nohz_switch_to_nohz - switch to nohz mode
  393. */
  394. static void tick_nohz_switch_to_nohz(void)
  395. {
  396. struct tick_sched *ts = &__get_cpu_var(tick_cpu_sched);
  397. ktime_t next;
  398. if (!tick_nohz_enabled)
  399. return;
  400. local_irq_disable();
  401. if (tick_switch_to_oneshot(tick_nohz_handler)) {
  402. local_irq_enable();
  403. return;
  404. }
  405. ts->nohz_mode = NOHZ_MODE_LOWRES;
  406. /*
  407. * Recycle the hrtimer in ts, so we can share the
  408. * hrtimer_forward with the highres code.
  409. */
  410. hrtimer_init(&ts->sched_timer, CLOCK_MONOTONIC, HRTIMER_MODE_ABS);
  411. /* Get the next period */
  412. next = tick_init_jiffy_update();
  413. for (;;) {
  414. ts->sched_timer.expires = next;
  415. if (!tick_program_event(next, 0))
  416. break;
  417. next = ktime_add(next, tick_period);
  418. }
  419. local_irq_enable();
  420. printk(KERN_INFO "Switched to NOHz mode on CPU #%d\n",
  421. smp_processor_id());
  422. }
  423. #else
  424. static inline void tick_nohz_switch_to_nohz(void) { }
  425. #endif /* NO_HZ */
  426. /*
  427. * High resolution timer specific code
  428. */
  429. #ifdef CONFIG_HIGH_RES_TIMERS
  430. /*
  431. * We rearm the timer until we get disabled by the idle code
  432. * Called with interrupts disabled and timer->base->cpu_base->lock held.
  433. */
  434. static enum hrtimer_restart tick_sched_timer(struct hrtimer *timer)
  435. {
  436. struct tick_sched *ts =
  437. container_of(timer, struct tick_sched, sched_timer);
  438. struct hrtimer_cpu_base *base = timer->base->cpu_base;
  439. struct pt_regs *regs = get_irq_regs();
  440. ktime_t now = ktime_get();
  441. int cpu = smp_processor_id();
  442. #ifdef CONFIG_NO_HZ
  443. /*
  444. * Check if the do_timer duty was dropped. We don't care about
  445. * concurrency: This happens only when the cpu in charge went
  446. * into a long sleep. If two cpus happen to assign themself to
  447. * this duty, then the jiffies update is still serialized by
  448. * xtime_lock.
  449. */
  450. if (unlikely(tick_do_timer_cpu == -1))
  451. tick_do_timer_cpu = cpu;
  452. #endif
  453. /* Check, if the jiffies need an update */
  454. if (tick_do_timer_cpu == cpu)
  455. tick_do_update_jiffies64(now);
  456. /*
  457. * Do not call, when we are not in irq context and have
  458. * no valid regs pointer
  459. */
  460. if (regs) {
  461. /*
  462. * When we are idle and the tick is stopped, we have to touch
  463. * the watchdog as we might not schedule for a really long
  464. * time. This happens on complete idle SMP systems while
  465. * waiting on the login prompt. We also increment the "start of
  466. * idle" jiffy stamp so the idle accounting adjustment we do
  467. * when we go busy again does not account too much ticks.
  468. */
  469. if (ts->tick_stopped) {
  470. touch_softlockup_watchdog();
  471. ts->idle_jiffies++;
  472. }
  473. /*
  474. * update_process_times() might take tasklist_lock, hence
  475. * drop the base lock. sched-tick hrtimers are per-CPU and
  476. * never accessible by userspace APIs, so this is safe to do.
  477. */
  478. spin_unlock(&base->lock);
  479. update_process_times(user_mode(regs));
  480. profile_tick(CPU_PROFILING);
  481. spin_lock(&base->lock);
  482. }
  483. /* Do not restart, when we are in the idle loop */
  484. if (ts->tick_stopped)
  485. return HRTIMER_NORESTART;
  486. hrtimer_forward(timer, now, tick_period);
  487. return HRTIMER_RESTART;
  488. }
  489. /**
  490. * tick_setup_sched_timer - setup the tick emulation timer
  491. */
  492. void tick_setup_sched_timer(void)
  493. {
  494. struct tick_sched *ts = &__get_cpu_var(tick_cpu_sched);
  495. ktime_t now = ktime_get();
  496. u64 offset;
  497. /*
  498. * Emulate tick processing via per-CPU hrtimers:
  499. */
  500. hrtimer_init(&ts->sched_timer, CLOCK_MONOTONIC, HRTIMER_MODE_ABS);
  501. ts->sched_timer.function = tick_sched_timer;
  502. ts->sched_timer.cb_mode = HRTIMER_CB_IRQSAFE_NO_SOFTIRQ;
  503. /* Get the next period (per cpu) */
  504. ts->sched_timer.expires = tick_init_jiffy_update();
  505. offset = ktime_to_ns(tick_period) >> 1;
  506. do_div(offset, num_possible_cpus());
  507. offset *= smp_processor_id();
  508. ts->sched_timer.expires = ktime_add_ns(ts->sched_timer.expires, offset);
  509. for (;;) {
  510. hrtimer_forward(&ts->sched_timer, now, tick_period);
  511. hrtimer_start(&ts->sched_timer, ts->sched_timer.expires,
  512. HRTIMER_MODE_ABS);
  513. /* Check, if the timer was already in the past */
  514. if (hrtimer_active(&ts->sched_timer))
  515. break;
  516. now = ktime_get();
  517. }
  518. #ifdef CONFIG_NO_HZ
  519. if (tick_nohz_enabled)
  520. ts->nohz_mode = NOHZ_MODE_HIGHRES;
  521. #endif
  522. }
  523. void tick_cancel_sched_timer(int cpu)
  524. {
  525. struct tick_sched *ts = &per_cpu(tick_cpu_sched, cpu);
  526. if (ts->sched_timer.base)
  527. hrtimer_cancel(&ts->sched_timer);
  528. ts->tick_stopped = 0;
  529. ts->nohz_mode = NOHZ_MODE_INACTIVE;
  530. }
  531. #endif /* HIGH_RES_TIMERS */
  532. /**
  533. * Async notification about clocksource changes
  534. */
  535. void tick_clock_notify(void)
  536. {
  537. int cpu;
  538. for_each_possible_cpu(cpu)
  539. set_bit(0, &per_cpu(tick_cpu_sched, cpu).check_clocks);
  540. }
  541. /*
  542. * Async notification about clock event changes
  543. */
  544. void tick_oneshot_notify(void)
  545. {
  546. struct tick_sched *ts = &__get_cpu_var(tick_cpu_sched);
  547. set_bit(0, &ts->check_clocks);
  548. }
  549. /**
  550. * Check, if a change happened, which makes oneshot possible.
  551. *
  552. * Called cyclic from the hrtimer softirq (driven by the timer
  553. * softirq) allow_nohz signals, that we can switch into low-res nohz
  554. * mode, because high resolution timers are disabled (either compile
  555. * or runtime).
  556. */
  557. int tick_check_oneshot_change(int allow_nohz)
  558. {
  559. struct tick_sched *ts = &__get_cpu_var(tick_cpu_sched);
  560. if (!test_and_clear_bit(0, &ts->check_clocks))
  561. return 0;
  562. if (ts->nohz_mode != NOHZ_MODE_INACTIVE)
  563. return 0;
  564. if (!timekeeping_is_continuous() || !tick_is_oneshot_available())
  565. return 0;
  566. if (!allow_nohz)
  567. return 1;
  568. tick_nohz_switch_to_nohz();
  569. return 0;
  570. }