smp.c 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519
  1. /*
  2. * Generic helpers for smp ipi calls
  3. *
  4. * (C) Jens Axboe <jens.axboe@oracle.com> 2008
  5. */
  6. #include <linux/rcupdate.h>
  7. #include <linux/rculist.h>
  8. #include <linux/kernel.h>
  9. #include <linux/module.h>
  10. #include <linux/percpu.h>
  11. #include <linux/init.h>
  12. #include <linux/smp.h>
  13. #include <linux/cpu.h>
  14. static struct {
  15. struct list_head queue;
  16. raw_spinlock_t lock;
  17. } call_function __cacheline_aligned_in_smp =
  18. {
  19. .queue = LIST_HEAD_INIT(call_function.queue),
  20. .lock = __RAW_SPIN_LOCK_UNLOCKED(call_function.lock),
  21. };
  22. enum {
  23. CSD_FLAG_LOCK = 0x01,
  24. };
  25. struct call_function_data {
  26. struct call_single_data csd;
  27. atomic_t refs;
  28. cpumask_var_t cpumask;
  29. };
  30. static DEFINE_PER_CPU_SHARED_ALIGNED(struct call_function_data, cfd_data);
  31. struct call_single_queue {
  32. struct list_head list;
  33. raw_spinlock_t lock;
  34. };
  35. static DEFINE_PER_CPU_SHARED_ALIGNED(struct call_single_queue, call_single_queue);
  36. static int
  37. hotplug_cfd(struct notifier_block *nfb, unsigned long action, void *hcpu)
  38. {
  39. long cpu = (long)hcpu;
  40. struct call_function_data *cfd = &per_cpu(cfd_data, cpu);
  41. switch (action) {
  42. case CPU_UP_PREPARE:
  43. case CPU_UP_PREPARE_FROZEN:
  44. if (!zalloc_cpumask_var_node(&cfd->cpumask, GFP_KERNEL,
  45. cpu_to_node(cpu)))
  46. return NOTIFY_BAD;
  47. break;
  48. #ifdef CONFIG_HOTPLUG_CPU
  49. case CPU_UP_CANCELED:
  50. case CPU_UP_CANCELED_FROZEN:
  51. case CPU_DEAD:
  52. case CPU_DEAD_FROZEN:
  53. free_cpumask_var(cfd->cpumask);
  54. break;
  55. #endif
  56. };
  57. return NOTIFY_OK;
  58. }
  59. static struct notifier_block __cpuinitdata hotplug_cfd_notifier = {
  60. .notifier_call = hotplug_cfd,
  61. };
  62. static int __cpuinit init_call_single_data(void)
  63. {
  64. void *cpu = (void *)(long)smp_processor_id();
  65. int i;
  66. for_each_possible_cpu(i) {
  67. struct call_single_queue *q = &per_cpu(call_single_queue, i);
  68. raw_spin_lock_init(&q->lock);
  69. INIT_LIST_HEAD(&q->list);
  70. }
  71. hotplug_cfd(&hotplug_cfd_notifier, CPU_UP_PREPARE, cpu);
  72. register_cpu_notifier(&hotplug_cfd_notifier);
  73. return 0;
  74. }
  75. early_initcall(init_call_single_data);
  76. /*
  77. * csd_lock/csd_unlock used to serialize access to per-cpu csd resources
  78. *
  79. * For non-synchronous ipi calls the csd can still be in use by the
  80. * previous function call. For multi-cpu calls its even more interesting
  81. * as we'll have to ensure no other cpu is observing our csd.
  82. */
  83. static void csd_lock_wait(struct call_single_data *data)
  84. {
  85. while (data->flags & CSD_FLAG_LOCK)
  86. cpu_relax();
  87. }
  88. static void csd_lock(struct call_single_data *data)
  89. {
  90. csd_lock_wait(data);
  91. data->flags = CSD_FLAG_LOCK;
  92. /*
  93. * prevent CPU from reordering the above assignment
  94. * to ->flags with any subsequent assignments to other
  95. * fields of the specified call_single_data structure:
  96. */
  97. smp_mb();
  98. }
  99. static void csd_unlock(struct call_single_data *data)
  100. {
  101. WARN_ON(!(data->flags & CSD_FLAG_LOCK));
  102. /*
  103. * ensure we're all done before releasing data:
  104. */
  105. smp_mb();
  106. data->flags &= ~CSD_FLAG_LOCK;
  107. }
  108. /*
  109. * Insert a previously allocated call_single_data element
  110. * for execution on the given CPU. data must already have
  111. * ->func, ->info, and ->flags set.
  112. */
  113. static
  114. void generic_exec_single(int cpu, struct call_single_data *data, int wait)
  115. {
  116. struct call_single_queue *dst = &per_cpu(call_single_queue, cpu);
  117. unsigned long flags;
  118. int ipi;
  119. raw_spin_lock_irqsave(&dst->lock, flags);
  120. ipi = list_empty(&dst->list);
  121. list_add_tail(&data->list, &dst->list);
  122. raw_spin_unlock_irqrestore(&dst->lock, flags);
  123. /*
  124. * The list addition should be visible before sending the IPI
  125. * handler locks the list to pull the entry off it because of
  126. * normal cache coherency rules implied by spinlocks.
  127. *
  128. * If IPIs can go out of order to the cache coherency protocol
  129. * in an architecture, sufficient synchronisation should be added
  130. * to arch code to make it appear to obey cache coherency WRT
  131. * locking and barrier primitives. Generic code isn't really
  132. * equipped to do the right thing...
  133. */
  134. if (ipi)
  135. arch_send_call_function_single_ipi(cpu);
  136. if (wait)
  137. csd_lock_wait(data);
  138. }
  139. /*
  140. * Invoked by arch to handle an IPI for call function. Must be called with
  141. * interrupts disabled.
  142. */
  143. void generic_smp_call_function_interrupt(void)
  144. {
  145. struct call_function_data *data;
  146. int cpu = smp_processor_id();
  147. /*
  148. * Shouldn't receive this interrupt on a cpu that is not yet online.
  149. */
  150. WARN_ON_ONCE(!cpu_online(cpu));
  151. /*
  152. * Ensure entry is visible on call_function_queue after we have
  153. * entered the IPI. See comment in smp_call_function_many.
  154. * If we don't have this, then we may miss an entry on the list
  155. * and never get another IPI to process it.
  156. */
  157. smp_mb();
  158. /*
  159. * It's ok to use list_for_each_rcu() here even though we may
  160. * delete 'pos', since list_del_rcu() doesn't clear ->next
  161. */
  162. list_for_each_entry_rcu(data, &call_function.queue, csd.list) {
  163. int refs;
  164. if (!cpumask_test_and_clear_cpu(cpu, data->cpumask))
  165. continue;
  166. data->csd.func(data->csd.info);
  167. refs = atomic_dec_return(&data->refs);
  168. WARN_ON(refs < 0);
  169. if (!refs) {
  170. raw_spin_lock(&call_function.lock);
  171. list_del_rcu(&data->csd.list);
  172. raw_spin_unlock(&call_function.lock);
  173. }
  174. if (refs)
  175. continue;
  176. csd_unlock(&data->csd);
  177. }
  178. }
  179. /*
  180. * Invoked by arch to handle an IPI for call function single. Must be
  181. * called from the arch with interrupts disabled.
  182. */
  183. void generic_smp_call_function_single_interrupt(void)
  184. {
  185. struct call_single_queue *q = &__get_cpu_var(call_single_queue);
  186. unsigned int data_flags;
  187. LIST_HEAD(list);
  188. /*
  189. * Shouldn't receive this interrupt on a cpu that is not yet online.
  190. */
  191. WARN_ON_ONCE(!cpu_online(smp_processor_id()));
  192. raw_spin_lock(&q->lock);
  193. list_replace_init(&q->list, &list);
  194. raw_spin_unlock(&q->lock);
  195. while (!list_empty(&list)) {
  196. struct call_single_data *data;
  197. data = list_entry(list.next, struct call_single_data, list);
  198. list_del(&data->list);
  199. /*
  200. * 'data' can be invalid after this call if flags == 0
  201. * (when called through generic_exec_single()),
  202. * so save them away before making the call:
  203. */
  204. data_flags = data->flags;
  205. data->func(data->info);
  206. /*
  207. * Unlocked CSDs are valid through generic_exec_single():
  208. */
  209. if (data_flags & CSD_FLAG_LOCK)
  210. csd_unlock(data);
  211. }
  212. }
  213. static DEFINE_PER_CPU_SHARED_ALIGNED(struct call_single_data, csd_data);
  214. /*
  215. * smp_call_function_single - Run a function on a specific CPU
  216. * @func: The function to run. This must be fast and non-blocking.
  217. * @info: An arbitrary pointer to pass to the function.
  218. * @wait: If true, wait until function has completed on other CPUs.
  219. *
  220. * Returns 0 on success, else a negative status code.
  221. */
  222. int smp_call_function_single(int cpu, void (*func) (void *info), void *info,
  223. int wait)
  224. {
  225. struct call_single_data d = {
  226. .flags = 0,
  227. };
  228. unsigned long flags;
  229. int this_cpu;
  230. int err = 0;
  231. /*
  232. * prevent preemption and reschedule on another processor,
  233. * as well as CPU removal
  234. */
  235. this_cpu = get_cpu();
  236. /*
  237. * Can deadlock when called with interrupts disabled.
  238. * We allow cpu's that are not yet online though, as no one else can
  239. * send smp call function interrupt to this cpu and as such deadlocks
  240. * can't happen.
  241. */
  242. WARN_ON_ONCE(cpu_online(this_cpu) && irqs_disabled()
  243. && !oops_in_progress);
  244. if (cpu == this_cpu) {
  245. local_irq_save(flags);
  246. func(info);
  247. local_irq_restore(flags);
  248. } else {
  249. if ((unsigned)cpu < nr_cpu_ids && cpu_online(cpu)) {
  250. struct call_single_data *data = &d;
  251. if (!wait)
  252. data = &__get_cpu_var(csd_data);
  253. csd_lock(data);
  254. data->func = func;
  255. data->info = info;
  256. generic_exec_single(cpu, data, wait);
  257. } else {
  258. err = -ENXIO; /* CPU not online */
  259. }
  260. }
  261. put_cpu();
  262. return err;
  263. }
  264. EXPORT_SYMBOL(smp_call_function_single);
  265. /*
  266. * smp_call_function_any - Run a function on any of the given cpus
  267. * @mask: The mask of cpus it can run on.
  268. * @func: The function to run. This must be fast and non-blocking.
  269. * @info: An arbitrary pointer to pass to the function.
  270. * @wait: If true, wait until function has completed.
  271. *
  272. * Returns 0 on success, else a negative status code (if no cpus were online).
  273. * Note that @wait will be implicitly turned on in case of allocation failures,
  274. * since we fall back to on-stack allocation.
  275. *
  276. * Selection preference:
  277. * 1) current cpu if in @mask
  278. * 2) any cpu of current node if in @mask
  279. * 3) any other online cpu in @mask
  280. */
  281. int smp_call_function_any(const struct cpumask *mask,
  282. void (*func)(void *info), void *info, int wait)
  283. {
  284. unsigned int cpu;
  285. const struct cpumask *nodemask;
  286. int ret;
  287. /* Try for same CPU (cheapest) */
  288. cpu = get_cpu();
  289. if (cpumask_test_cpu(cpu, mask))
  290. goto call;
  291. /* Try for same node. */
  292. nodemask = cpumask_of_node(cpu_to_node(cpu));
  293. for (cpu = cpumask_first_and(nodemask, mask); cpu < nr_cpu_ids;
  294. cpu = cpumask_next_and(cpu, nodemask, mask)) {
  295. if (cpu_online(cpu))
  296. goto call;
  297. }
  298. /* Any online will do: smp_call_function_single handles nr_cpu_ids. */
  299. cpu = cpumask_any_and(mask, cpu_online_mask);
  300. call:
  301. ret = smp_call_function_single(cpu, func, info, wait);
  302. put_cpu();
  303. return ret;
  304. }
  305. EXPORT_SYMBOL_GPL(smp_call_function_any);
  306. /**
  307. * __smp_call_function_single(): Run a function on another CPU
  308. * @cpu: The CPU to run on.
  309. * @data: Pre-allocated and setup data structure
  310. *
  311. * Like smp_call_function_single(), but allow caller to pass in a
  312. * pre-allocated data structure. Useful for embedding @data inside
  313. * other structures, for instance.
  314. */
  315. void __smp_call_function_single(int cpu, struct call_single_data *data,
  316. int wait)
  317. {
  318. csd_lock(data);
  319. /*
  320. * Can deadlock when called with interrupts disabled.
  321. * We allow cpu's that are not yet online though, as no one else can
  322. * send smp call function interrupt to this cpu and as such deadlocks
  323. * can't happen.
  324. */
  325. WARN_ON_ONCE(cpu_online(smp_processor_id()) && wait && irqs_disabled()
  326. && !oops_in_progress);
  327. generic_exec_single(cpu, data, wait);
  328. }
  329. /**
  330. * smp_call_function_many(): Run a function on a set of other CPUs.
  331. * @mask: The set of cpus to run on (only runs on online subset).
  332. * @func: The function to run. This must be fast and non-blocking.
  333. * @info: An arbitrary pointer to pass to the function.
  334. * @wait: If true, wait (atomically) until function has completed
  335. * on other CPUs.
  336. *
  337. * If @wait is true, then returns once @func has returned.
  338. *
  339. * You must not call this function with disabled interrupts or from a
  340. * hardware interrupt handler or from a bottom half handler. Preemption
  341. * must be disabled when calling this function.
  342. */
  343. void smp_call_function_many(const struct cpumask *mask,
  344. void (*func)(void *), void *info, bool wait)
  345. {
  346. struct call_function_data *data;
  347. unsigned long flags;
  348. int cpu, next_cpu, this_cpu = smp_processor_id();
  349. /*
  350. * Can deadlock when called with interrupts disabled.
  351. * We allow cpu's that are not yet online though, as no one else can
  352. * send smp call function interrupt to this cpu and as such deadlocks
  353. * can't happen.
  354. */
  355. WARN_ON_ONCE(cpu_online(this_cpu) && irqs_disabled()
  356. && !oops_in_progress);
  357. /* So, what's a CPU they want? Ignoring this one. */
  358. cpu = cpumask_first_and(mask, cpu_online_mask);
  359. if (cpu == this_cpu)
  360. cpu = cpumask_next_and(cpu, mask, cpu_online_mask);
  361. /* No online cpus? We're done. */
  362. if (cpu >= nr_cpu_ids)
  363. return;
  364. /* Do we have another CPU which isn't us? */
  365. next_cpu = cpumask_next_and(cpu, mask, cpu_online_mask);
  366. if (next_cpu == this_cpu)
  367. next_cpu = cpumask_next_and(next_cpu, mask, cpu_online_mask);
  368. /* Fastpath: do that cpu by itself. */
  369. if (next_cpu >= nr_cpu_ids) {
  370. smp_call_function_single(cpu, func, info, wait);
  371. return;
  372. }
  373. data = &__get_cpu_var(cfd_data);
  374. csd_lock(&data->csd);
  375. data->csd.func = func;
  376. data->csd.info = info;
  377. cpumask_and(data->cpumask, mask, cpu_online_mask);
  378. cpumask_clear_cpu(this_cpu, data->cpumask);
  379. atomic_set(&data->refs, cpumask_weight(data->cpumask));
  380. raw_spin_lock_irqsave(&call_function.lock, flags);
  381. /*
  382. * Place entry at the _HEAD_ of the list, so that any cpu still
  383. * observing the entry in generic_smp_call_function_interrupt()
  384. * will not miss any other list entries:
  385. */
  386. list_add_rcu(&data->csd.list, &call_function.queue);
  387. raw_spin_unlock_irqrestore(&call_function.lock, flags);
  388. /*
  389. * Make the list addition visible before sending the ipi.
  390. * (IPIs must obey or appear to obey normal Linux cache
  391. * coherency rules -- see comment in generic_exec_single).
  392. */
  393. smp_mb();
  394. /* Send a message to all CPUs in the map */
  395. arch_send_call_function_ipi_mask(data->cpumask);
  396. /* Optionally wait for the CPUs to complete */
  397. if (wait)
  398. csd_lock_wait(&data->csd);
  399. }
  400. EXPORT_SYMBOL(smp_call_function_many);
  401. /**
  402. * smp_call_function(): Run a function on all other CPUs.
  403. * @func: The function to run. This must be fast and non-blocking.
  404. * @info: An arbitrary pointer to pass to the function.
  405. * @wait: If true, wait (atomically) until function has completed
  406. * on other CPUs.
  407. *
  408. * Returns 0.
  409. *
  410. * If @wait is true, then returns once @func has returned; otherwise
  411. * it returns just before the target cpu calls @func.
  412. *
  413. * You must not call this function with disabled interrupts or from a
  414. * hardware interrupt handler or from a bottom half handler.
  415. */
  416. int smp_call_function(void (*func)(void *), void *info, int wait)
  417. {
  418. preempt_disable();
  419. smp_call_function_many(cpu_online_mask, func, info, wait);
  420. preempt_enable();
  421. return 0;
  422. }
  423. EXPORT_SYMBOL(smp_call_function);
  424. void ipi_call_lock(void)
  425. {
  426. raw_spin_lock(&call_function.lock);
  427. }
  428. void ipi_call_unlock(void)
  429. {
  430. raw_spin_unlock(&call_function.lock);
  431. }
  432. void ipi_call_lock_irq(void)
  433. {
  434. raw_spin_lock_irq(&call_function.lock);
  435. }
  436. void ipi_call_unlock_irq(void)
  437. {
  438. raw_spin_unlock_irq(&call_function.lock);
  439. }