Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/hid/hid
[linux-2.6-microblaze.git] / drivers / cpuidle / sysfs.c
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_str_function(name)
260 define_show_state_str_function(desc)
261 define_show_state_ull_function(above)
262 define_show_state_ull_function(below)
263
264 static ssize_t show_state_time(struct cpuidle_state *state,
265                                struct cpuidle_state_usage *state_usage,
266                                char *buf)
267 {
268         return sprintf(buf, "%llu\n", ktime_to_us(state_usage->time_ns));
269 }
270
271 static ssize_t show_state_disable(struct cpuidle_state *state,
272                                   struct cpuidle_state_usage *state_usage,
273                                   char *buf)
274 {
275         return sprintf(buf, "%llu\n",
276                        state_usage->disable & CPUIDLE_STATE_DISABLED_BY_USER);
277 }
278
279 static ssize_t store_state_disable(struct cpuidle_state *state,
280                                    struct cpuidle_state_usage *state_usage,
281                                    const char *buf, size_t size)
282 {
283         unsigned int value;
284         int err;
285
286         if (!capable(CAP_SYS_ADMIN))
287                 return -EPERM;
288
289         err = kstrtouint(buf, 0, &value);
290         if (err)
291                 return err;
292
293         if (value)
294                 state_usage->disable |= CPUIDLE_STATE_DISABLED_BY_USER;
295         else
296                 state_usage->disable &= ~CPUIDLE_STATE_DISABLED_BY_USER;
297
298         return size;
299 }
300
301 static ssize_t show_state_default_status(struct cpuidle_state *state,
302                                           struct cpuidle_state_usage *state_usage,
303                                           char *buf)
304 {
305         return sprintf(buf, "%s\n",
306                        state->flags & CPUIDLE_FLAG_OFF ? "disabled" : "enabled");
307 }
308
309 define_one_state_ro(name, show_state_name);
310 define_one_state_ro(desc, show_state_desc);
311 define_one_state_ro(latency, show_state_exit_latency);
312 define_one_state_ro(residency, show_state_target_residency);
313 define_one_state_ro(power, show_state_power_usage);
314 define_one_state_ro(usage, show_state_usage);
315 define_one_state_ro(time, show_state_time);
316 define_one_state_rw(disable, show_state_disable, store_state_disable);
317 define_one_state_ro(above, show_state_above);
318 define_one_state_ro(below, show_state_below);
319 define_one_state_ro(default_status, show_state_default_status);
320
321 static struct attribute *cpuidle_state_default_attrs[] = {
322         &attr_name.attr,
323         &attr_desc.attr,
324         &attr_latency.attr,
325         &attr_residency.attr,
326         &attr_power.attr,
327         &attr_usage.attr,
328         &attr_time.attr,
329         &attr_disable.attr,
330         &attr_above.attr,
331         &attr_below.attr,
332         &attr_default_status.attr,
333         NULL
334 };
335
336 struct cpuidle_state_kobj {
337         struct cpuidle_state *state;
338         struct cpuidle_state_usage *state_usage;
339         struct completion kobj_unregister;
340         struct kobject kobj;
341         struct cpuidle_device *device;
342 };
343
344 #ifdef CONFIG_SUSPEND
345 #define define_show_state_s2idle_ull_function(_name) \
346 static ssize_t show_state_s2idle_##_name(struct cpuidle_state *state, \
347                                          struct cpuidle_state_usage *state_usage, \
348                                          char *buf)                             \
349 { \
350         return sprintf(buf, "%llu\n", state_usage->s2idle_##_name);\
351 }
352
353 define_show_state_s2idle_ull_function(usage);
354 define_show_state_s2idle_ull_function(time);
355
356 #define define_one_state_s2idle_ro(_name, show) \
357 static struct cpuidle_state_attr attr_s2idle_##_name = \
358         __ATTR(_name, 0444, show, NULL)
359
360 define_one_state_s2idle_ro(usage, show_state_s2idle_usage);
361 define_one_state_s2idle_ro(time, show_state_s2idle_time);
362
363 static struct attribute *cpuidle_state_s2idle_attrs[] = {
364         &attr_s2idle_usage.attr,
365         &attr_s2idle_time.attr,
366         NULL
367 };
368
369 static const struct attribute_group cpuidle_state_s2idle_group = {
370         .name   = "s2idle",
371         .attrs  = cpuidle_state_s2idle_attrs,
372 };
373
374 static void cpuidle_add_s2idle_attr_group(struct cpuidle_state_kobj *kobj)
375 {
376         int ret;
377
378         if (!kobj->state->enter_s2idle)
379                 return;
380
381         ret = sysfs_create_group(&kobj->kobj, &cpuidle_state_s2idle_group);
382         if (ret)
383                 pr_debug("%s: sysfs attribute group not created\n", __func__);
384 }
385
386 static void cpuidle_remove_s2idle_attr_group(struct cpuidle_state_kobj *kobj)
387 {
388         if (kobj->state->enter_s2idle)
389                 sysfs_remove_group(&kobj->kobj, &cpuidle_state_s2idle_group);
390 }
391 #else
392 static inline void cpuidle_add_s2idle_attr_group(struct cpuidle_state_kobj *kobj) { }
393 static inline void cpuidle_remove_s2idle_attr_group(struct cpuidle_state_kobj *kobj) { }
394 #endif /* CONFIG_SUSPEND */
395
396 #define kobj_to_state_obj(k) container_of(k, struct cpuidle_state_kobj, kobj)
397 #define kobj_to_state(k) (kobj_to_state_obj(k)->state)
398 #define kobj_to_state_usage(k) (kobj_to_state_obj(k)->state_usage)
399 #define kobj_to_device(k) (kobj_to_state_obj(k)->device)
400 #define attr_to_stateattr(a) container_of(a, struct cpuidle_state_attr, attr)
401
402 static ssize_t cpuidle_state_show(struct kobject *kobj, struct attribute *attr,
403                                   char *buf)
404 {
405         int ret = -EIO;
406         struct cpuidle_state *state = kobj_to_state(kobj);
407         struct cpuidle_state_usage *state_usage = kobj_to_state_usage(kobj);
408         struct cpuidle_state_attr *cattr = attr_to_stateattr(attr);
409
410         if (cattr->show)
411                 ret = cattr->show(state, state_usage, buf);
412
413         return ret;
414 }
415
416 static ssize_t cpuidle_state_store(struct kobject *kobj, struct attribute *attr,
417                                    const char *buf, size_t size)
418 {
419         int ret = -EIO;
420         struct cpuidle_state *state = kobj_to_state(kobj);
421         struct cpuidle_state_usage *state_usage = kobj_to_state_usage(kobj);
422         struct cpuidle_state_attr *cattr = attr_to_stateattr(attr);
423         struct cpuidle_device *dev = kobj_to_device(kobj);
424
425         if (cattr->store)
426                 ret = cattr->store(state, state_usage, buf, size);
427
428         /* reset poll time cache */
429         dev->poll_limit_ns = 0;
430
431         return ret;
432 }
433
434 static const struct sysfs_ops cpuidle_state_sysfs_ops = {
435         .show = cpuidle_state_show,
436         .store = cpuidle_state_store,
437 };
438
439 static void cpuidle_state_sysfs_release(struct kobject *kobj)
440 {
441         struct cpuidle_state_kobj *state_obj = kobj_to_state_obj(kobj);
442
443         complete(&state_obj->kobj_unregister);
444 }
445
446 static struct kobj_type ktype_state_cpuidle = {
447         .sysfs_ops = &cpuidle_state_sysfs_ops,
448         .default_attrs = cpuidle_state_default_attrs,
449         .release = cpuidle_state_sysfs_release,
450 };
451
452 static inline void cpuidle_free_state_kobj(struct cpuidle_device *device, int i)
453 {
454         cpuidle_remove_s2idle_attr_group(device->kobjs[i]);
455         kobject_put(&device->kobjs[i]->kobj);
456         wait_for_completion(&device->kobjs[i]->kobj_unregister);
457         kfree(device->kobjs[i]);
458         device->kobjs[i] = NULL;
459 }
460
461 /**
462  * cpuidle_add_state_sysfs - adds cpuidle states sysfs attributes
463  * @device: the target device
464  */
465 static int cpuidle_add_state_sysfs(struct cpuidle_device *device)
466 {
467         int i, ret = -ENOMEM;
468         struct cpuidle_state_kobj *kobj;
469         struct cpuidle_device_kobj *kdev = device->kobj_dev;
470         struct cpuidle_driver *drv = cpuidle_get_cpu_driver(device);
471
472         /* state statistics */
473         for (i = 0; i < drv->state_count; i++) {
474                 kobj = kzalloc(sizeof(struct cpuidle_state_kobj), GFP_KERNEL);
475                 if (!kobj) {
476                         ret = -ENOMEM;
477                         goto error_state;
478                 }
479                 kobj->state = &drv->states[i];
480                 kobj->state_usage = &device->states_usage[i];
481                 kobj->device = device;
482                 init_completion(&kobj->kobj_unregister);
483
484                 ret = kobject_init_and_add(&kobj->kobj, &ktype_state_cpuidle,
485                                            &kdev->kobj, "state%d", i);
486                 if (ret) {
487                         kobject_put(&kobj->kobj);
488                         goto error_state;
489                 }
490                 cpuidle_add_s2idle_attr_group(kobj);
491                 kobject_uevent(&kobj->kobj, KOBJ_ADD);
492                 device->kobjs[i] = kobj;
493         }
494
495         return 0;
496
497 error_state:
498         for (i = i - 1; i >= 0; i--)
499                 cpuidle_free_state_kobj(device, i);
500         return ret;
501 }
502
503 /**
504  * cpuidle_remove_driver_sysfs - removes the cpuidle states sysfs attributes
505  * @device: the target device
506  */
507 static void cpuidle_remove_state_sysfs(struct cpuidle_device *device)
508 {
509         struct cpuidle_driver *drv = cpuidle_get_cpu_driver(device);
510         int i;
511
512         for (i = 0; i < drv->state_count; i++)
513                 cpuidle_free_state_kobj(device, i);
514 }
515
516 #ifdef CONFIG_CPU_IDLE_MULTIPLE_DRIVERS
517 #define kobj_to_driver_kobj(k) container_of(k, struct cpuidle_driver_kobj, kobj)
518 #define attr_to_driver_attr(a) container_of(a, struct cpuidle_driver_attr, attr)
519
520 #define define_one_driver_ro(_name, show)                       \
521         static struct cpuidle_driver_attr attr_driver_##_name = \
522                 __ATTR(_name, 0444, show, NULL)
523
524 struct cpuidle_driver_kobj {
525         struct cpuidle_driver *drv;
526         struct completion kobj_unregister;
527         struct kobject kobj;
528 };
529
530 struct cpuidle_driver_attr {
531         struct attribute attr;
532         ssize_t (*show)(struct cpuidle_driver *, char *);
533         ssize_t (*store)(struct cpuidle_driver *, const char *, size_t);
534 };
535
536 static ssize_t show_driver_name(struct cpuidle_driver *drv, char *buf)
537 {
538         ssize_t ret;
539
540         spin_lock(&cpuidle_driver_lock);
541         ret = sprintf(buf, "%s\n", drv ? drv->name : "none");
542         spin_unlock(&cpuidle_driver_lock);
543
544         return ret;
545 }
546
547 static void cpuidle_driver_sysfs_release(struct kobject *kobj)
548 {
549         struct cpuidle_driver_kobj *driver_kobj = kobj_to_driver_kobj(kobj);
550         complete(&driver_kobj->kobj_unregister);
551 }
552
553 static ssize_t cpuidle_driver_show(struct kobject *kobj, struct attribute *attr,
554                                    char *buf)
555 {
556         int ret = -EIO;
557         struct cpuidle_driver_kobj *driver_kobj = kobj_to_driver_kobj(kobj);
558         struct cpuidle_driver_attr *dattr = attr_to_driver_attr(attr);
559
560         if (dattr->show)
561                 ret = dattr->show(driver_kobj->drv, buf);
562
563         return ret;
564 }
565
566 static ssize_t cpuidle_driver_store(struct kobject *kobj, struct attribute *attr,
567                                     const char *buf, size_t size)
568 {
569         int ret = -EIO;
570         struct cpuidle_driver_kobj *driver_kobj = kobj_to_driver_kobj(kobj);
571         struct cpuidle_driver_attr *dattr = attr_to_driver_attr(attr);
572
573         if (dattr->store)
574                 ret = dattr->store(driver_kobj->drv, buf, size);
575
576         return ret;
577 }
578
579 define_one_driver_ro(name, show_driver_name);
580
581 static const struct sysfs_ops cpuidle_driver_sysfs_ops = {
582         .show = cpuidle_driver_show,
583         .store = cpuidle_driver_store,
584 };
585
586 static struct attribute *cpuidle_driver_default_attrs[] = {
587         &attr_driver_name.attr,
588         NULL
589 };
590
591 static struct kobj_type ktype_driver_cpuidle = {
592         .sysfs_ops = &cpuidle_driver_sysfs_ops,
593         .default_attrs = cpuidle_driver_default_attrs,
594         .release = cpuidle_driver_sysfs_release,
595 };
596
597 /**
598  * cpuidle_add_driver_sysfs - adds the driver name sysfs attribute
599  * @dev: the target device
600  */
601 static int cpuidle_add_driver_sysfs(struct cpuidle_device *dev)
602 {
603         struct cpuidle_driver_kobj *kdrv;
604         struct cpuidle_device_kobj *kdev = dev->kobj_dev;
605         struct cpuidle_driver *drv = cpuidle_get_cpu_driver(dev);
606         int ret;
607
608         kdrv = kzalloc(sizeof(*kdrv), GFP_KERNEL);
609         if (!kdrv)
610                 return -ENOMEM;
611
612         kdrv->drv = drv;
613         init_completion(&kdrv->kobj_unregister);
614
615         ret = kobject_init_and_add(&kdrv->kobj, &ktype_driver_cpuidle,
616                                    &kdev->kobj, "driver");
617         if (ret) {
618                 kobject_put(&kdrv->kobj);
619                 return ret;
620         }
621
622         kobject_uevent(&kdrv->kobj, KOBJ_ADD);
623         dev->kobj_driver = kdrv;
624
625         return ret;
626 }
627
628 /**
629  * cpuidle_remove_driver_sysfs - removes the driver name sysfs attribute
630  * @dev: the target device
631  */
632 static void cpuidle_remove_driver_sysfs(struct cpuidle_device *dev)
633 {
634         struct cpuidle_driver_kobj *kdrv = dev->kobj_driver;
635         kobject_put(&kdrv->kobj);
636         wait_for_completion(&kdrv->kobj_unregister);
637         kfree(kdrv);
638 }
639 #else
640 static inline int cpuidle_add_driver_sysfs(struct cpuidle_device *dev)
641 {
642         return 0;
643 }
644
645 static inline void cpuidle_remove_driver_sysfs(struct cpuidle_device *dev)
646 {
647         ;
648 }
649 #endif
650
651 /**
652  * cpuidle_add_device_sysfs - adds device specific sysfs attributes
653  * @device: the target device
654  */
655 int cpuidle_add_device_sysfs(struct cpuidle_device *device)
656 {
657         int ret;
658
659         ret = cpuidle_add_state_sysfs(device);
660         if (ret)
661                 return ret;
662
663         ret = cpuidle_add_driver_sysfs(device);
664         if (ret)
665                 cpuidle_remove_state_sysfs(device);
666         return ret;
667 }
668
669 /**
670  * cpuidle_remove_device_sysfs : removes device specific sysfs attributes
671  * @device : the target device
672  */
673 void cpuidle_remove_device_sysfs(struct cpuidle_device *device)
674 {
675         cpuidle_remove_driver_sysfs(device);
676         cpuidle_remove_state_sysfs(device);
677 }
678
679 /**
680  * cpuidle_add_sysfs - creates a sysfs instance for the target device
681  * @dev: the target device
682  */
683 int cpuidle_add_sysfs(struct cpuidle_device *dev)
684 {
685         struct cpuidle_device_kobj *kdev;
686         struct device *cpu_dev = get_cpu_device((unsigned long)dev->cpu);
687         int error;
688
689         /*
690          * Return if cpu_device is not setup for this CPU.
691          *
692          * This could happen if the arch did not set up cpu_device
693          * since this CPU is not in cpu_present mask and the
694          * driver did not send a correct CPU mask during registration.
695          * Without this check we would end up passing bogus
696          * value for &cpu_dev->kobj in kobject_init_and_add()
697          */
698         if (!cpu_dev)
699                 return -ENODEV;
700
701         kdev = kzalloc(sizeof(*kdev), GFP_KERNEL);
702         if (!kdev)
703                 return -ENOMEM;
704         kdev->dev = dev;
705         dev->kobj_dev = kdev;
706
707         init_completion(&kdev->kobj_unregister);
708
709         error = kobject_init_and_add(&kdev->kobj, &ktype_cpuidle, &cpu_dev->kobj,
710                                    "cpuidle");
711         if (error) {
712                 kobject_put(&kdev->kobj);
713                 return error;
714         }
715
716         kobject_uevent(&kdev->kobj, KOBJ_ADD);
717
718         return 0;
719 }
720
721 /**
722  * cpuidle_remove_sysfs - deletes a sysfs instance on the target device
723  * @dev: the target device
724  */
725 void cpuidle_remove_sysfs(struct cpuidle_device *dev)
726 {
727         struct cpuidle_device_kobj *kdev = dev->kobj_dev;
728
729         kobject_put(&kdev->kobj);
730         wait_for_completion(&kdev->kobj_unregister);
731         kfree(kdev);
732 }