cpu_ops.h 2.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374
  1. /*
  2. * Copyright (C) 2013 ARM Ltd.
  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 version 2 as
  6. * published by the Free Software Foundation.
  7. *
  8. * This program is distributed in the hope that it will be useful,
  9. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  10. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  11. * GNU General Public License for more details.
  12. *
  13. * You should have received a copy of the GNU General Public License
  14. * along with this program. If not, see <http://www.gnu.org/licenses/>.
  15. */
  16. #ifndef __ASM_CPU_OPS_H
  17. #define __ASM_CPU_OPS_H
  18. #include <linux/init.h>
  19. #include <linux/threads.h>
  20. /**
  21. * struct cpu_operations - Callback operations for hotplugging CPUs.
  22. *
  23. * @name: Name of the property as appears in a devicetree cpu node's
  24. * enable-method property. On systems booting with ACPI, @name
  25. * identifies the struct cpu_operations entry corresponding to
  26. * the boot protocol specified in the ACPI MADT table.
  27. * @cpu_init: Reads any data necessary for a specific enable-method for a
  28. * proposed logical id.
  29. * @cpu_prepare: Early one-time preparation step for a cpu. If there is a
  30. * mechanism for doing so, tests whether it is possible to boot
  31. * the given CPU.
  32. * @cpu_boot: Boots a cpu into the kernel.
  33. * @cpu_postboot: Optionally, perform any post-boot cleanup or necesary
  34. * synchronisation. Called from the cpu being booted.
  35. * @cpu_disable: Prepares a cpu to die. May fail for some mechanism-specific
  36. * reason, which will cause the hot unplug to be aborted. Called
  37. * from the cpu to be killed.
  38. * @cpu_die: Makes a cpu leave the kernel. Must not fail. Called from the
  39. * cpu being killed.
  40. * @cpu_kill: Ensures a cpu has left the kernel. Called from another cpu.
  41. * @cpu_init_idle: Reads any data necessary to initialize CPU idle states for
  42. * a proposed logical id.
  43. * @cpu_suspend: Suspends a cpu and saves the required context. May fail owing
  44. * to wrong parameters or error conditions. Called from the
  45. * CPU being suspended. Must be called with IRQs disabled.
  46. */
  47. struct cpu_operations {
  48. const char *name;
  49. int (*cpu_init)(unsigned int);
  50. int (*cpu_prepare)(unsigned int);
  51. int (*cpu_boot)(unsigned int);
  52. void (*cpu_postboot)(void);
  53. #ifdef CONFIG_HOTPLUG_CPU
  54. int (*cpu_disable)(unsigned int cpu);
  55. void (*cpu_die)(unsigned int cpu);
  56. int (*cpu_kill)(unsigned int cpu);
  57. #endif
  58. #ifdef CONFIG_CPU_IDLE
  59. int (*cpu_init_idle)(unsigned int);
  60. int (*cpu_suspend)(unsigned long);
  61. #endif
  62. };
  63. extern const struct cpu_operations *cpu_ops[NR_CPUS];
  64. int __init cpu_read_ops(int cpu);
  65. static inline void __init cpu_read_bootcpu_ops(void)
  66. {
  67. cpu_read_ops(0);
  68. }
  69. #endif /* ifndef __ASM_CPU_OPS_H */