xref: /openbmc/linux/drivers/cpuidle/sysfs.c (revision 94047df1)
1 /*
2  * sysfs.c - sysfs support
3  *
4  * (C) 2006-2007 Shaohua Li <shaohua.li@intel.com>
5  *
6  * This code is licenced under the GPL.
7  */
8 
9 #include <linux/kernel.h>
10 #include <linux/cpuidle.h>
11 #include <linux/sysfs.h>
12 #include <linux/slab.h>
13 #include <linux/cpu.h>
14 #include <linux/completion.h>
15 #include <linux/capability.h>
16 #include <linux/device.h>
17 #include <linux/kobject.h>
18 
19 #include "cpuidle.h"
20 
21 static ssize_t show_available_governors(struct device *dev,
22 					struct device_attribute *attr,
23 					char *buf)
24 {
25 	ssize_t i = 0;
26 	struct cpuidle_governor *tmp;
27 
28 	mutex_lock(&cpuidle_lock);
29 	list_for_each_entry(tmp, &cpuidle_governors, governor_list) {
30 		if (i >= (ssize_t) (PAGE_SIZE - (CPUIDLE_NAME_LEN + 2)))
31 			goto out;
32 
33 		i += scnprintf(&buf[i], CPUIDLE_NAME_LEN + 1, "%s ", tmp->name);
34 	}
35 
36 out:
37 	i+= sprintf(&buf[i], "\n");
38 	mutex_unlock(&cpuidle_lock);
39 	return i;
40 }
41 
42 static ssize_t show_current_driver(struct device *dev,
43 				   struct device_attribute *attr,
44 				   char *buf)
45 {
46 	ssize_t ret;
47 	struct cpuidle_driver *drv;
48 
49 	spin_lock(&cpuidle_driver_lock);
50 	drv = cpuidle_get_driver();
51 	if (drv)
52 		ret = sprintf(buf, "%s\n", drv->name);
53 	else
54 		ret = sprintf(buf, "none\n");
55 	spin_unlock(&cpuidle_driver_lock);
56 
57 	return ret;
58 }
59 
60 static ssize_t show_current_governor(struct device *dev,
61 				     struct device_attribute *attr,
62 				     char *buf)
63 {
64 	ssize_t ret;
65 
66 	mutex_lock(&cpuidle_lock);
67 	if (cpuidle_curr_governor)
68 		ret = sprintf(buf, "%s\n", cpuidle_curr_governor->name);
69 	else
70 		ret = sprintf(buf, "none\n");
71 	mutex_unlock(&cpuidle_lock);
72 
73 	return ret;
74 }
75 
76 static ssize_t store_current_governor(struct device *dev,
77 				      struct device_attribute *attr,
78 				      const char *buf, size_t count)
79 {
80 	char gov_name[CPUIDLE_NAME_LEN + 1];
81 	int ret;
82 	struct cpuidle_governor *gov;
83 
84 	ret = sscanf(buf, "%" __stringify(CPUIDLE_NAME_LEN) "s", gov_name);
85 	if (ret != 1)
86 		return -EINVAL;
87 
88 	mutex_lock(&cpuidle_lock);
89 	ret = -EINVAL;
90 	list_for_each_entry(gov, &cpuidle_governors, governor_list) {
91 		if (!strncmp(gov->name, gov_name, CPUIDLE_NAME_LEN)) {
92 			ret = cpuidle_switch_governor(gov);
93 			break;
94 		}
95 	}
96 	mutex_unlock(&cpuidle_lock);
97 
98 	return ret ? ret : count;
99 }
100 
101 static DEVICE_ATTR(available_governors, 0444, show_available_governors, NULL);
102 static DEVICE_ATTR(current_driver, 0444, show_current_driver, NULL);
103 static DEVICE_ATTR(current_governor, 0644, show_current_governor,
104 				   store_current_governor);
105 static DEVICE_ATTR(current_governor_ro, 0444, show_current_governor, NULL);
106 
107 static struct attribute *cpuidle_attrs[] = {
108 	&dev_attr_available_governors.attr,
109 	&dev_attr_current_driver.attr,
110 	&dev_attr_current_governor.attr,
111 	&dev_attr_current_governor_ro.attr,
112 	NULL
113 };
114 
115 static struct attribute_group cpuidle_attr_group = {
116 	.attrs = cpuidle_attrs,
117 	.name = "cpuidle",
118 };
119 
120 /**
121  * cpuidle_add_interface - add CPU global sysfs attributes
122  * @dev: the target device
123  */
124 int cpuidle_add_interface(struct device *dev)
125 {
126 	return sysfs_create_group(&dev->kobj, &cpuidle_attr_group);
127 }
128 
129 /**
130  * cpuidle_remove_interface - remove CPU global sysfs attributes
131  * @dev: the target device
132  */
133 void cpuidle_remove_interface(struct device *dev)
134 {
135 	sysfs_remove_group(&dev->kobj, &cpuidle_attr_group);
136 }
137 
138 struct cpuidle_attr {
139 	struct attribute attr;
140 	ssize_t (*show)(struct cpuidle_device *, char *);
141 	ssize_t (*store)(struct cpuidle_device *, const char *, size_t count);
142 };
143 
144 #define attr_to_cpuidleattr(a) container_of(a, struct cpuidle_attr, attr)
145 
146 struct cpuidle_device_kobj {
147 	struct cpuidle_device *dev;
148 	struct completion kobj_unregister;
149 	struct kobject kobj;
150 };
151 
152 static inline struct cpuidle_device *to_cpuidle_device(struct kobject *kobj)
153 {
154 	struct cpuidle_device_kobj *kdev =
155 		container_of(kobj, struct cpuidle_device_kobj, kobj);
156 
157 	return kdev->dev;
158 }
159 
160 static ssize_t cpuidle_show(struct kobject *kobj, struct attribute *attr,
161 			    char *buf)
162 {
163 	int ret = -EIO;
164 	struct cpuidle_device *dev = to_cpuidle_device(kobj);
165 	struct cpuidle_attr *cattr = attr_to_cpuidleattr(attr);
166 
167 	if (cattr->show) {
168 		mutex_lock(&cpuidle_lock);
169 		ret = cattr->show(dev, buf);
170 		mutex_unlock(&cpuidle_lock);
171 	}
172 	return ret;
173 }
174 
175 static ssize_t cpuidle_store(struct kobject *kobj, struct attribute *attr,
176 			     const char *buf, size_t count)
177 {
178 	int ret = -EIO;
179 	struct cpuidle_device *dev = to_cpuidle_device(kobj);
180 	struct cpuidle_attr *cattr = attr_to_cpuidleattr(attr);
181 
182 	if (cattr->store) {
183 		mutex_lock(&cpuidle_lock);
184 		ret = cattr->store(dev, buf, count);
185 		mutex_unlock(&cpuidle_lock);
186 	}
187 	return ret;
188 }
189 
190 static const struct sysfs_ops cpuidle_sysfs_ops = {
191 	.show = cpuidle_show,
192 	.store = cpuidle_store,
193 };
194 
195 static void cpuidle_sysfs_release(struct kobject *kobj)
196 {
197 	struct cpuidle_device_kobj *kdev =
198 		container_of(kobj, struct cpuidle_device_kobj, kobj);
199 
200 	complete(&kdev->kobj_unregister);
201 }
202 
203 static struct kobj_type ktype_cpuidle = {
204 	.sysfs_ops = &cpuidle_sysfs_ops,
205 	.release = cpuidle_sysfs_release,
206 };
207 
208 struct cpuidle_state_attr {
209 	struct attribute attr;
210 	ssize_t (*show)(struct cpuidle_state *, \
211 					struct cpuidle_state_usage *, char *);
212 	ssize_t (*store)(struct cpuidle_state *, \
213 			struct cpuidle_state_usage *, const char *, size_t);
214 };
215 
216 #define define_one_state_ro(_name, show) \
217 static struct cpuidle_state_attr attr_##_name = __ATTR(_name, 0444, show, NULL)
218 
219 #define define_one_state_rw(_name, show, store) \
220 static struct cpuidle_state_attr attr_##_name = __ATTR(_name, 0644, show, store)
221 
222 #define define_show_state_function(_name) \
223 static ssize_t show_state_##_name(struct cpuidle_state *state, \
224 			 struct cpuidle_state_usage *state_usage, char *buf) \
225 { \
226 	return sprintf(buf, "%u\n", state->_name);\
227 }
228 
229 #define define_show_state_ull_function(_name) \
230 static ssize_t show_state_##_name(struct cpuidle_state *state, \
231 				  struct cpuidle_state_usage *state_usage, \
232 				  char *buf)				\
233 { \
234 	return sprintf(buf, "%llu\n", state_usage->_name);\
235 }
236 
237 #define define_show_state_str_function(_name) \
238 static ssize_t show_state_##_name(struct cpuidle_state *state, \
239 				  struct cpuidle_state_usage *state_usage, \
240 				  char *buf)				\
241 { \
242 	if (state->_name[0] == '\0')\
243 		return sprintf(buf, "<null>\n");\
244 	return sprintf(buf, "%s\n", state->_name);\
245 }
246 
247 #define define_show_state_time_function(_name) \
248 static ssize_t show_state_##_name(struct cpuidle_state *state, \
249 				  struct cpuidle_state_usage *state_usage, \
250 				  char *buf) \
251 { \
252 	return sprintf(buf, "%llu\n", ktime_to_us(state->_name##_ns)); \
253 }
254 
255 define_show_state_time_function(exit_latency)
256 define_show_state_time_function(target_residency)
257 define_show_state_function(power_usage)
258 define_show_state_ull_function(usage)
259 define_show_state_ull_function(rejected)
260 define_show_state_str_function(name)
261 define_show_state_str_function(desc)
262 define_show_state_ull_function(above)
263 define_show_state_ull_function(below)
264 
265 static ssize_t show_state_time(struct cpuidle_state *state,
266 			       struct cpuidle_state_usage *state_usage,
267 			       char *buf)
268 {
269 	return sprintf(buf, "%llu\n", ktime_to_us(state_usage->time_ns));
270 }
271 
272 static ssize_t show_state_disable(struct cpuidle_state *state,
273 				  struct cpuidle_state_usage *state_usage,
274 				  char *buf)
275 {
276 	return sprintf(buf, "%llu\n",
277 		       state_usage->disable & CPUIDLE_STATE_DISABLED_BY_USER);
278 }
279 
280 static ssize_t store_state_disable(struct cpuidle_state *state,
281 				   struct cpuidle_state_usage *state_usage,
282 				   const char *buf, size_t size)
283 {
284 	unsigned int value;
285 	int err;
286 
287 	if (!capable(CAP_SYS_ADMIN))
288 		return -EPERM;
289 
290 	err = kstrtouint(buf, 0, &value);
291 	if (err)
292 		return err;
293 
294 	if (value)
295 		state_usage->disable |= CPUIDLE_STATE_DISABLED_BY_USER;
296 	else
297 		state_usage->disable &= ~CPUIDLE_STATE_DISABLED_BY_USER;
298 
299 	return size;
300 }
301 
302 static ssize_t show_state_default_status(struct cpuidle_state *state,
303 					  struct cpuidle_state_usage *state_usage,
304 					  char *buf)
305 {
306 	return sprintf(buf, "%s\n",
307 		       state->flags & CPUIDLE_FLAG_OFF ? "disabled" : "enabled");
308 }
309 
310 define_one_state_ro(name, show_state_name);
311 define_one_state_ro(desc, show_state_desc);
312 define_one_state_ro(latency, show_state_exit_latency);
313 define_one_state_ro(residency, show_state_target_residency);
314 define_one_state_ro(power, show_state_power_usage);
315 define_one_state_ro(usage, show_state_usage);
316 define_one_state_ro(rejected, show_state_rejected);
317 define_one_state_ro(time, show_state_time);
318 define_one_state_rw(disable, show_state_disable, store_state_disable);
319 define_one_state_ro(above, show_state_above);
320 define_one_state_ro(below, show_state_below);
321 define_one_state_ro(default_status, show_state_default_status);
322 
323 static struct attribute *cpuidle_state_default_attrs[] = {
324 	&attr_name.attr,
325 	&attr_desc.attr,
326 	&attr_latency.attr,
327 	&attr_residency.attr,
328 	&attr_power.attr,
329 	&attr_usage.attr,
330 	&attr_rejected.attr,
331 	&attr_time.attr,
332 	&attr_disable.attr,
333 	&attr_above.attr,
334 	&attr_below.attr,
335 	&attr_default_status.attr,
336 	NULL
337 };
338 
339 struct cpuidle_state_kobj {
340 	struct cpuidle_state *state;
341 	struct cpuidle_state_usage *state_usage;
342 	struct completion kobj_unregister;
343 	struct kobject kobj;
344 	struct cpuidle_device *device;
345 };
346 
347 #ifdef CONFIG_SUSPEND
348 #define define_show_state_s2idle_ull_function(_name) \
349 static ssize_t show_state_s2idle_##_name(struct cpuidle_state *state, \
350 					 struct cpuidle_state_usage *state_usage, \
351 					 char *buf)				\
352 { \
353 	return sprintf(buf, "%llu\n", state_usage->s2idle_##_name);\
354 }
355 
356 define_show_state_s2idle_ull_function(usage);
357 define_show_state_s2idle_ull_function(time);
358 
359 #define define_one_state_s2idle_ro(_name, show) \
360 static struct cpuidle_state_attr attr_s2idle_##_name = \
361 	__ATTR(_name, 0444, show, NULL)
362 
363 define_one_state_s2idle_ro(usage, show_state_s2idle_usage);
364 define_one_state_s2idle_ro(time, show_state_s2idle_time);
365 
366 static struct attribute *cpuidle_state_s2idle_attrs[] = {
367 	&attr_s2idle_usage.attr,
368 	&attr_s2idle_time.attr,
369 	NULL
370 };
371 
372 static const struct attribute_group cpuidle_state_s2idle_group = {
373 	.name	= "s2idle",
374 	.attrs	= cpuidle_state_s2idle_attrs,
375 };
376 
377 static void cpuidle_add_s2idle_attr_group(struct cpuidle_state_kobj *kobj)
378 {
379 	int ret;
380 
381 	if (!kobj->state->enter_s2idle)
382 		return;
383 
384 	ret = sysfs_create_group(&kobj->kobj, &cpuidle_state_s2idle_group);
385 	if (ret)
386 		pr_debug("%s: sysfs attribute group not created\n", __func__);
387 }
388 
389 static void cpuidle_remove_s2idle_attr_group(struct cpuidle_state_kobj *kobj)
390 {
391 	if (kobj->state->enter_s2idle)
392 		sysfs_remove_group(&kobj->kobj, &cpuidle_state_s2idle_group);
393 }
394 #else
395 static inline void cpuidle_add_s2idle_attr_group(struct cpuidle_state_kobj *kobj) { }
396 static inline void cpuidle_remove_s2idle_attr_group(struct cpuidle_state_kobj *kobj) { }
397 #endif /* CONFIG_SUSPEND */
398 
399 #define kobj_to_state_obj(k) container_of(k, struct cpuidle_state_kobj, kobj)
400 #define kobj_to_state(k) (kobj_to_state_obj(k)->state)
401 #define kobj_to_state_usage(k) (kobj_to_state_obj(k)->state_usage)
402 #define kobj_to_device(k) (kobj_to_state_obj(k)->device)
403 #define attr_to_stateattr(a) container_of(a, struct cpuidle_state_attr, attr)
404 
405 static ssize_t cpuidle_state_show(struct kobject *kobj, struct attribute *attr,
406 				  char *buf)
407 {
408 	int ret = -EIO;
409 	struct cpuidle_state *state = kobj_to_state(kobj);
410 	struct cpuidle_state_usage *state_usage = kobj_to_state_usage(kobj);
411 	struct cpuidle_state_attr *cattr = attr_to_stateattr(attr);
412 
413 	if (cattr->show)
414 		ret = cattr->show(state, state_usage, buf);
415 
416 	return ret;
417 }
418 
419 static ssize_t cpuidle_state_store(struct kobject *kobj, struct attribute *attr,
420 				   const char *buf, size_t size)
421 {
422 	int ret = -EIO;
423 	struct cpuidle_state *state = kobj_to_state(kobj);
424 	struct cpuidle_state_usage *state_usage = kobj_to_state_usage(kobj);
425 	struct cpuidle_state_attr *cattr = attr_to_stateattr(attr);
426 	struct cpuidle_device *dev = kobj_to_device(kobj);
427 
428 	if (cattr->store)
429 		ret = cattr->store(state, state_usage, buf, size);
430 
431 	/* reset poll time cache */
432 	dev->poll_limit_ns = 0;
433 
434 	return ret;
435 }
436 
437 static const struct sysfs_ops cpuidle_state_sysfs_ops = {
438 	.show = cpuidle_state_show,
439 	.store = cpuidle_state_store,
440 };
441 
442 static void cpuidle_state_sysfs_release(struct kobject *kobj)
443 {
444 	struct cpuidle_state_kobj *state_obj = kobj_to_state_obj(kobj);
445 
446 	complete(&state_obj->kobj_unregister);
447 }
448 
449 static struct kobj_type ktype_state_cpuidle = {
450 	.sysfs_ops = &cpuidle_state_sysfs_ops,
451 	.default_attrs = cpuidle_state_default_attrs,
452 	.release = cpuidle_state_sysfs_release,
453 };
454 
455 static inline void cpuidle_free_state_kobj(struct cpuidle_device *device, int i)
456 {
457 	cpuidle_remove_s2idle_attr_group(device->kobjs[i]);
458 	kobject_put(&device->kobjs[i]->kobj);
459 	wait_for_completion(&device->kobjs[i]->kobj_unregister);
460 	kfree(device->kobjs[i]);
461 	device->kobjs[i] = NULL;
462 }
463 
464 /**
465  * cpuidle_add_state_sysfs - adds cpuidle states sysfs attributes
466  * @device: the target device
467  */
468 static int cpuidle_add_state_sysfs(struct cpuidle_device *device)
469 {
470 	int i, ret = -ENOMEM;
471 	struct cpuidle_state_kobj *kobj;
472 	struct cpuidle_device_kobj *kdev = device->kobj_dev;
473 	struct cpuidle_driver *drv = cpuidle_get_cpu_driver(device);
474 
475 	/* state statistics */
476 	for (i = 0; i < drv->state_count; i++) {
477 		kobj = kzalloc(sizeof(struct cpuidle_state_kobj), GFP_KERNEL);
478 		if (!kobj) {
479 			ret = -ENOMEM;
480 			goto error_state;
481 		}
482 		kobj->state = &drv->states[i];
483 		kobj->state_usage = &device->states_usage[i];
484 		kobj->device = device;
485 		init_completion(&kobj->kobj_unregister);
486 
487 		ret = kobject_init_and_add(&kobj->kobj, &ktype_state_cpuidle,
488 					   &kdev->kobj, "state%d", i);
489 		if (ret) {
490 			kobject_put(&kobj->kobj);
491 			kfree(kobj);
492 			goto error_state;
493 		}
494 		cpuidle_add_s2idle_attr_group(kobj);
495 		kobject_uevent(&kobj->kobj, KOBJ_ADD);
496 		device->kobjs[i] = kobj;
497 	}
498 
499 	return 0;
500 
501 error_state:
502 	for (i = i - 1; i >= 0; i--)
503 		cpuidle_free_state_kobj(device, i);
504 	return ret;
505 }
506 
507 /**
508  * cpuidle_remove_driver_sysfs - removes the cpuidle states sysfs attributes
509  * @device: the target device
510  */
511 static void cpuidle_remove_state_sysfs(struct cpuidle_device *device)
512 {
513 	struct cpuidle_driver *drv = cpuidle_get_cpu_driver(device);
514 	int i;
515 
516 	for (i = 0; i < drv->state_count; i++)
517 		cpuidle_free_state_kobj(device, i);
518 }
519 
520 #ifdef CONFIG_CPU_IDLE_MULTIPLE_DRIVERS
521 #define kobj_to_driver_kobj(k) container_of(k, struct cpuidle_driver_kobj, kobj)
522 #define attr_to_driver_attr(a) container_of(a, struct cpuidle_driver_attr, attr)
523 
524 #define define_one_driver_ro(_name, show)                       \
525 	static struct cpuidle_driver_attr attr_driver_##_name = \
526 		__ATTR(_name, 0444, show, NULL)
527 
528 struct cpuidle_driver_kobj {
529 	struct cpuidle_driver *drv;
530 	struct completion kobj_unregister;
531 	struct kobject kobj;
532 };
533 
534 struct cpuidle_driver_attr {
535 	struct attribute attr;
536 	ssize_t (*show)(struct cpuidle_driver *, char *);
537 	ssize_t (*store)(struct cpuidle_driver *, const char *, size_t);
538 };
539 
540 static ssize_t show_driver_name(struct cpuidle_driver *drv, char *buf)
541 {
542 	ssize_t ret;
543 
544 	spin_lock(&cpuidle_driver_lock);
545 	ret = sprintf(buf, "%s\n", drv ? drv->name : "none");
546 	spin_unlock(&cpuidle_driver_lock);
547 
548 	return ret;
549 }
550 
551 static void cpuidle_driver_sysfs_release(struct kobject *kobj)
552 {
553 	struct cpuidle_driver_kobj *driver_kobj = kobj_to_driver_kobj(kobj);
554 	complete(&driver_kobj->kobj_unregister);
555 }
556 
557 static ssize_t cpuidle_driver_show(struct kobject *kobj, struct attribute *attr,
558 				   char *buf)
559 {
560 	int ret = -EIO;
561 	struct cpuidle_driver_kobj *driver_kobj = kobj_to_driver_kobj(kobj);
562 	struct cpuidle_driver_attr *dattr = attr_to_driver_attr(attr);
563 
564 	if (dattr->show)
565 		ret = dattr->show(driver_kobj->drv, buf);
566 
567 	return ret;
568 }
569 
570 static ssize_t cpuidle_driver_store(struct kobject *kobj, struct attribute *attr,
571 				    const char *buf, size_t size)
572 {
573 	int ret = -EIO;
574 	struct cpuidle_driver_kobj *driver_kobj = kobj_to_driver_kobj(kobj);
575 	struct cpuidle_driver_attr *dattr = attr_to_driver_attr(attr);
576 
577 	if (dattr->store)
578 		ret = dattr->store(driver_kobj->drv, buf, size);
579 
580 	return ret;
581 }
582 
583 define_one_driver_ro(name, show_driver_name);
584 
585 static const struct sysfs_ops cpuidle_driver_sysfs_ops = {
586 	.show = cpuidle_driver_show,
587 	.store = cpuidle_driver_store,
588 };
589 
590 static struct attribute *cpuidle_driver_default_attrs[] = {
591 	&attr_driver_name.attr,
592 	NULL
593 };
594 
595 static struct kobj_type ktype_driver_cpuidle = {
596 	.sysfs_ops = &cpuidle_driver_sysfs_ops,
597 	.default_attrs = cpuidle_driver_default_attrs,
598 	.release = cpuidle_driver_sysfs_release,
599 };
600 
601 /**
602  * cpuidle_add_driver_sysfs - adds the driver name sysfs attribute
603  * @dev: the target device
604  */
605 static int cpuidle_add_driver_sysfs(struct cpuidle_device *dev)
606 {
607 	struct cpuidle_driver_kobj *kdrv;
608 	struct cpuidle_device_kobj *kdev = dev->kobj_dev;
609 	struct cpuidle_driver *drv = cpuidle_get_cpu_driver(dev);
610 	int ret;
611 
612 	kdrv = kzalloc(sizeof(*kdrv), GFP_KERNEL);
613 	if (!kdrv)
614 		return -ENOMEM;
615 
616 	kdrv->drv = drv;
617 	init_completion(&kdrv->kobj_unregister);
618 
619 	ret = kobject_init_and_add(&kdrv->kobj, &ktype_driver_cpuidle,
620 				   &kdev->kobj, "driver");
621 	if (ret) {
622 		kobject_put(&kdrv->kobj);
623 		kfree(kdrv);
624 		return ret;
625 	}
626 
627 	kobject_uevent(&kdrv->kobj, KOBJ_ADD);
628 	dev->kobj_driver = kdrv;
629 
630 	return ret;
631 }
632 
633 /**
634  * cpuidle_remove_driver_sysfs - removes the driver name sysfs attribute
635  * @dev: the target device
636  */
637 static void cpuidle_remove_driver_sysfs(struct cpuidle_device *dev)
638 {
639 	struct cpuidle_driver_kobj *kdrv = dev->kobj_driver;
640 	kobject_put(&kdrv->kobj);
641 	wait_for_completion(&kdrv->kobj_unregister);
642 	kfree(kdrv);
643 }
644 #else
645 static inline int cpuidle_add_driver_sysfs(struct cpuidle_device *dev)
646 {
647 	return 0;
648 }
649 
650 static inline void cpuidle_remove_driver_sysfs(struct cpuidle_device *dev)
651 {
652 	;
653 }
654 #endif
655 
656 /**
657  * cpuidle_add_device_sysfs - adds device specific sysfs attributes
658  * @device: the target device
659  */
660 int cpuidle_add_device_sysfs(struct cpuidle_device *device)
661 {
662 	int ret;
663 
664 	ret = cpuidle_add_state_sysfs(device);
665 	if (ret)
666 		return ret;
667 
668 	ret = cpuidle_add_driver_sysfs(device);
669 	if (ret)
670 		cpuidle_remove_state_sysfs(device);
671 	return ret;
672 }
673 
674 /**
675  * cpuidle_remove_device_sysfs : removes device specific sysfs attributes
676  * @device : the target device
677  */
678 void cpuidle_remove_device_sysfs(struct cpuidle_device *device)
679 {
680 	cpuidle_remove_driver_sysfs(device);
681 	cpuidle_remove_state_sysfs(device);
682 }
683 
684 /**
685  * cpuidle_add_sysfs - creates a sysfs instance for the target device
686  * @dev: the target device
687  */
688 int cpuidle_add_sysfs(struct cpuidle_device *dev)
689 {
690 	struct cpuidle_device_kobj *kdev;
691 	struct device *cpu_dev = get_cpu_device((unsigned long)dev->cpu);
692 	int error;
693 
694 	/*
695 	 * Return if cpu_device is not setup for this CPU.
696 	 *
697 	 * This could happen if the arch did not set up cpu_device
698 	 * since this CPU is not in cpu_present mask and the
699 	 * driver did not send a correct CPU mask during registration.
700 	 * Without this check we would end up passing bogus
701 	 * value for &cpu_dev->kobj in kobject_init_and_add()
702 	 */
703 	if (!cpu_dev)
704 		return -ENODEV;
705 
706 	kdev = kzalloc(sizeof(*kdev), GFP_KERNEL);
707 	if (!kdev)
708 		return -ENOMEM;
709 	kdev->dev = dev;
710 
711 	init_completion(&kdev->kobj_unregister);
712 
713 	error = kobject_init_and_add(&kdev->kobj, &ktype_cpuidle, &cpu_dev->kobj,
714 				   "cpuidle");
715 	if (error) {
716 		kobject_put(&kdev->kobj);
717 		kfree(kdev);
718 		return error;
719 	}
720 
721 	dev->kobj_dev = kdev;
722 	kobject_uevent(&kdev->kobj, KOBJ_ADD);
723 
724 	return 0;
725 }
726 
727 /**
728  * cpuidle_remove_sysfs - deletes a sysfs instance on the target device
729  * @dev: the target device
730  */
731 void cpuidle_remove_sysfs(struct cpuidle_device *dev)
732 {
733 	struct cpuidle_device_kobj *kdev = dev->kobj_dev;
734 
735 	kobject_put(&kdev->kobj);
736 	wait_for_completion(&kdev->kobj_unregister);
737 	kfree(kdev);
738 }
739