blob: 4823af64e9db2148c23e1ae4d0ad3fe21de4368a [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * include/linux/cpu.h - generic cpu definition
3 *
4 * This is mainly for topological representation. We define the
5 * basic 'struct cpu' here, which can be embedded in per-arch
6 * definitions of processors.
7 *
8 * Basic handling of the devices is done in drivers/base/cpu.c
9 * and system devices are handled in drivers/base/sys.c.
10 *
Rolf Eike Beerd51fe1b2005-09-02 08:59:25 +020011 * CPUs are exported via sysfs in the class/cpu/devices/
Linus Torvalds1da177e2005-04-16 15:20:36 -070012 * directory.
13 *
14 * Per-cpu interfaces can be implemented using a struct device_interface.
15 * See the following for how to do this:
16 * - drivers/base/intf.c
17 * - Documentation/driver-model/interface.txt
18 */
19#ifndef _LINUX_CPU_H_
20#define _LINUX_CPU_H_
21
22#include <linux/sysdev.h>
23#include <linux/node.h>
24#include <linux/compiler.h>
25#include <linux/cpumask.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070026
27struct cpu {
28 int node_id; /* The node which contains the CPU */
Siddha, Suresh B72486f12006-12-07 02:14:10 +010029 int hotpluggable; /* creates sysfs control file if hotpluggable */
Linus Torvalds1da177e2005-04-16 15:20:36 -070030 struct sys_device sysdev;
31};
32
KAMEZAWA Hiroyuki76b67ed2006-06-27 02:53:41 -070033extern int register_cpu(struct cpu *cpu, int num);
Andrew Mortona29d6422006-03-07 23:53:25 -080034extern struct sys_device *get_cpu_sysdev(unsigned cpu);
Christian Krafft0344c6c2006-10-24 18:31:24 +020035
36extern int cpu_add_sysdev_attr(struct sysdev_attribute *attr);
37extern void cpu_remove_sysdev_attr(struct sysdev_attribute *attr);
38
39extern int cpu_add_sysdev_attr_group(struct attribute_group *attrs);
40extern void cpu_remove_sysdev_attr_group(struct attribute_group *attrs);
41
Ralf Baechle3367b992007-05-08 00:27:52 -070042extern int sched_create_sysfs_power_savings_entries(struct sysdev_class *cls);
Christian Krafft0344c6c2006-10-24 18:31:24 +020043
Linus Torvalds1da177e2005-04-16 15:20:36 -070044#ifdef CONFIG_HOTPLUG_CPU
KAMEZAWA Hiroyuki76b67ed2006-06-27 02:53:41 -070045extern void unregister_cpu(struct cpu *cpu);
Nathan Fontenot12633e82009-11-25 17:23:25 +000046extern ssize_t arch_cpu_probe(const char *, size_t);
47extern ssize_t arch_cpu_release(const char *, size_t);
Linus Torvalds1da177e2005-04-16 15:20:36 -070048#endif
49struct notifier_block;
50
Tejun Heo50a323b2010-06-08 21:40:36 +020051/*
52 * CPU notifier priorities.
53 */
54enum {
Tejun Heo3a101d02010-06-08 21:40:36 +020055 /*
56 * SCHED_ACTIVE marks a cpu which is coming up active during
57 * CPU_ONLINE and CPU_DOWN_FAILED and must be the first
58 * notifier. CPUSET_ACTIVE adjusts cpuset according to
59 * cpu_active mask right after SCHED_ACTIVE. During
60 * CPU_DOWN_PREPARE, SCHED_INACTIVE and CPUSET_INACTIVE are
61 * ordered in the similar way.
62 *
63 * This ordering guarantees consistent cpu_active mask and
64 * migration behavior to all cpu notifiers.
65 */
66 CPU_PRI_SCHED_ACTIVE = INT_MAX,
67 CPU_PRI_CPUSET_ACTIVE = INT_MAX - 1,
68 CPU_PRI_SCHED_INACTIVE = INT_MIN + 1,
69 CPU_PRI_CPUSET_INACTIVE = INT_MIN,
70
Tejun Heo50a323b2010-06-08 21:40:36 +020071 /* migration should happen before other stuff but after perf */
72 CPU_PRI_PERF = 20,
73 CPU_PRI_MIGRATION = 10,
Tejun Heodb7bccf2010-06-29 10:07:12 +020074 /* prepare workqueues for other notifiers */
75 CPU_PRI_WORKQUEUE = 5,
Tejun Heo50a323b2010-06-08 21:40:36 +020076};
77
Linus Torvalds1da177e2005-04-16 15:20:36 -070078#ifdef CONFIG_SMP
79/* Need to know about CPUs going up/down? */
Paul E. McKenney799e64f2009-08-15 09:53:47 -070080#if defined(CONFIG_HOTPLUG_CPU) || !defined(MODULE)
81#define cpu_notifier(fn, pri) { \
82 static struct notifier_block fn##_nb __cpuinitdata = \
83 { .notifier_call = fn, .priority = pri }; \
84 register_cpu_notifier(&fn##_nb); \
85}
86#else /* #if defined(CONFIG_HOTPLUG_CPU) || !defined(MODULE) */
87#define cpu_notifier(fn, pri) do { (void)(fn); } while (0)
88#endif /* #else #if defined(CONFIG_HOTPLUG_CPU) || !defined(MODULE) */
Chandra Seetharaman65edc682006-06-27 02:54:08 -070089#ifdef CONFIG_HOTPLUG_CPU
Avi Kivity47e627b2007-02-12 00:54:43 -080090extern int register_cpu_notifier(struct notifier_block *nb);
Linus Torvalds1da177e2005-04-16 15:20:36 -070091extern void unregister_cpu_notifier(struct notifier_block *nb);
Chandra Seetharaman65edc682006-06-27 02:54:08 -070092#else
Avi Kivity47e627b2007-02-12 00:54:43 -080093
94#ifndef MODULE
95extern int register_cpu_notifier(struct notifier_block *nb);
96#else
97static inline int register_cpu_notifier(struct notifier_block *nb)
98{
99 return 0;
100}
101#endif
102
Chandra Seetharaman65edc682006-06-27 02:54:08 -0700103static inline void unregister_cpu_notifier(struct notifier_block *nb)
104{
105}
106#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700107
108int cpu_up(unsigned int cpu);
Manfred Spraule545a612008-09-07 16:57:22 +0200109void notify_cpu_starting(unsigned int cpu);
Oleg Nesterov3da1c842008-07-25 01:47:50 -0700110extern void cpu_maps_update_begin(void);
111extern void cpu_maps_update_done(void);
Ingo Molnard0d23b52008-01-25 21:08:02 +0100112
Oleg Nesterov3da1c842008-07-25 01:47:50 -0700113#else /* CONFIG_SMP */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700114
Paul E. McKenney799e64f2009-08-15 09:53:47 -0700115#define cpu_notifier(fn, pri) do { (void)(fn); } while (0)
116
Linus Torvalds1da177e2005-04-16 15:20:36 -0700117static inline int register_cpu_notifier(struct notifier_block *nb)
118{
119 return 0;
120}
Ingo Molnard0d23b52008-01-25 21:08:02 +0100121
Linus Torvalds1da177e2005-04-16 15:20:36 -0700122static inline void unregister_cpu_notifier(struct notifier_block *nb)
123{
124}
125
Oleg Nesterov3da1c842008-07-25 01:47:50 -0700126static inline void cpu_maps_update_begin(void)
127{
128}
129
130static inline void cpu_maps_update_done(void)
131{
132}
133
Linus Torvalds1da177e2005-04-16 15:20:36 -0700134#endif /* CONFIG_SMP */
135extern struct sysdev_class cpu_sysdev_class;
136
137#ifdef CONFIG_HOTPLUG_CPU
138/* Stop CPUs going up and down. */
Gautham R Shenoyf7dff2b2006-12-06 20:38:58 -0800139
Gautham R Shenoy86ef5c92008-01-25 21:08:02 +0100140extern void get_online_cpus(void);
141extern void put_online_cpus(void);
Paul E. McKenney799e64f2009-08-15 09:53:47 -0700142#define hotcpu_notifier(fn, pri) cpu_notifier(fn, pri)
Chandra Seetharaman39f48852006-06-27 02:54:10 -0700143#define register_hotcpu_notifier(nb) register_cpu_notifier(nb)
144#define unregister_hotcpu_notifier(nb) unregister_cpu_notifier(nb)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700145int cpu_down(unsigned int cpu);
Gautham R Shenoyf7dff2b2006-12-06 20:38:58 -0800146
Gautham R Shenoy51badeb2009-11-26 09:59:05 +0000147#ifdef CONFIG_ARCH_CPU_PROBE_RELEASE
148extern void cpu_hotplug_driver_lock(void);
149extern void cpu_hotplug_driver_unlock(void);
150#else
151static inline void cpu_hotplug_driver_lock(void)
152{
153}
154
155static inline void cpu_hotplug_driver_unlock(void)
156{
157}
158#endif
159
Gautham R Shenoyf7dff2b2006-12-06 20:38:58 -0800160#else /* CONFIG_HOTPLUG_CPU */
161
Gautham R Shenoy86ef5c92008-01-25 21:08:02 +0100162#define get_online_cpus() do { } while (0)
163#define put_online_cpus() do { } while (0)
Ingo Molnar02316062006-12-06 20:38:17 -0800164#define hotcpu_notifier(fn, pri) do { (void)(fn); } while (0)
Satyam Sharma761bb432007-10-18 03:06:38 -0700165/* These aren't inline functions due to a GCC bug. */
166#define register_hotcpu_notifier(nb) ({ (void)(nb); 0; })
167#define unregister_hotcpu_notifier(nb) ({ (void)(nb); })
Gautham R Shenoyf7dff2b2006-12-06 20:38:58 -0800168#endif /* CONFIG_HOTPLUG_CPU */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700169
Rafael J. Wysockif3de4be2007-08-30 23:56:29 -0700170#ifdef CONFIG_PM_SLEEP_SMP
Rafael J. Wysocki1d64b9c2007-04-01 23:49:49 -0700171extern int suspend_cpu_hotplug;
172
Rafael J. Wysockie3920fb2006-09-25 23:32:48 -0700173extern int disable_nonboot_cpus(void);
174extern void enable_nonboot_cpus(void);
Rafael J. Wysockif3de4be2007-08-30 23:56:29 -0700175#else /* !CONFIG_PM_SLEEP_SMP */
Rafael J. Wysocki1d64b9c2007-04-01 23:49:49 -0700176#define suspend_cpu_hotplug 0
177
Rafael J. Wysockie3920fb2006-09-25 23:32:48 -0700178static inline int disable_nonboot_cpus(void) { return 0; }
179static inline void enable_nonboot_cpus(void) {}
Rafael J. Wysockif3de4be2007-08-30 23:56:29 -0700180#endif /* !CONFIG_PM_SLEEP_SMP */
Rafael J. Wysockie3920fb2006-09-25 23:32:48 -0700181
Linus Torvalds1da177e2005-04-16 15:20:36 -0700182#endif /* _LINUX_CPU_H_ */