Version:  2.0.40 2.2.26 2.4.37 3.4 3.5 3.6 3.7 3.8 3.9 3.10 3.11 3.12 3.13 3.14 3.15 3.16 3.17 3.18 3.19 4.0

Linux/drivers/acpi/scan.c

  1 /*
  2  * scan.c - support for transforming the ACPI namespace into individual objects
  3  */
  4 
  5 #include <linux/module.h>
  6 #include <linux/init.h>
  7 #include <linux/slab.h>
  8 #include <linux/kernel.h>
  9 #include <linux/acpi.h>
 10 #include <linux/signal.h>
 11 #include <linux/kthread.h>
 12 #include <linux/dmi.h>
 13 #include <linux/nls.h>
 14 
 15 #include <asm/pgtable.h>
 16 
 17 #include "internal.h"
 18 
 19 #define _COMPONENT              ACPI_BUS_COMPONENT
 20 ACPI_MODULE_NAME("scan");
 21 extern struct acpi_device *acpi_root;
 22 
 23 #define ACPI_BUS_CLASS                  "system_bus"
 24 #define ACPI_BUS_HID                    "LNXSYBUS"
 25 #define ACPI_BUS_DEVICE_NAME            "System Bus"
 26 
 27 #define ACPI_IS_ROOT_DEVICE(device)    (!(device)->parent)
 28 
 29 #define INVALID_ACPI_HANDLE     ((acpi_handle)empty_zero_page)
 30 
 31 /*
 32  * If set, devices will be hot-removed even if they cannot be put offline
 33  * gracefully (from the kernel's standpoint).
 34  */
 35 bool acpi_force_hot_remove;
 36 
 37 static const char *dummy_hid = "device";
 38 
 39 static LIST_HEAD(acpi_dep_list);
 40 static DEFINE_MUTEX(acpi_dep_list_lock);
 41 static LIST_HEAD(acpi_bus_id_list);
 42 static DEFINE_MUTEX(acpi_scan_lock);
 43 static LIST_HEAD(acpi_scan_handlers_list);
 44 DEFINE_MUTEX(acpi_device_lock);
 45 LIST_HEAD(acpi_wakeup_device_list);
 46 static DEFINE_MUTEX(acpi_hp_context_lock);
 47 
 48 struct acpi_dep_data {
 49         struct list_head node;
 50         acpi_handle master;
 51         acpi_handle slave;
 52 };
 53 
 54 struct acpi_device_bus_id{
 55         char bus_id[15];
 56         unsigned int instance_no;
 57         struct list_head node;
 58 };
 59 
 60 void acpi_scan_lock_acquire(void)
 61 {
 62         mutex_lock(&acpi_scan_lock);
 63 }
 64 EXPORT_SYMBOL_GPL(acpi_scan_lock_acquire);
 65 
 66 void acpi_scan_lock_release(void)
 67 {
 68         mutex_unlock(&acpi_scan_lock);
 69 }
 70 EXPORT_SYMBOL_GPL(acpi_scan_lock_release);
 71 
 72 void acpi_lock_hp_context(void)
 73 {
 74         mutex_lock(&acpi_hp_context_lock);
 75 }
 76 
 77 void acpi_unlock_hp_context(void)
 78 {
 79         mutex_unlock(&acpi_hp_context_lock);
 80 }
 81 
 82 void acpi_initialize_hp_context(struct acpi_device *adev,
 83                                 struct acpi_hotplug_context *hp,
 84                                 int (*notify)(struct acpi_device *, u32),
 85                                 void (*uevent)(struct acpi_device *, u32))
 86 {
 87         acpi_lock_hp_context();
 88         hp->notify = notify;
 89         hp->uevent = uevent;
 90         acpi_set_hp_context(adev, hp);
 91         acpi_unlock_hp_context();
 92 }
 93 EXPORT_SYMBOL_GPL(acpi_initialize_hp_context);
 94 
 95 int acpi_scan_add_handler(struct acpi_scan_handler *handler)
 96 {
 97         if (!handler)
 98                 return -EINVAL;
 99 
100         list_add_tail(&handler->list_node, &acpi_scan_handlers_list);
101         return 0;
102 }
103 
104 int acpi_scan_add_handler_with_hotplug(struct acpi_scan_handler *handler,
105                                        const char *hotplug_profile_name)
106 {
107         int error;
108 
109         error = acpi_scan_add_handler(handler);
110         if (error)
111                 return error;
112 
113         acpi_sysfs_add_hotplug_profile(&handler->hotplug, hotplug_profile_name);
114         return 0;
115 }
116 
117 /*
118  * Creates hid/cid(s) string needed for modalias and uevent
119  * e.g. on a device with hid:IBM0001 and cid:ACPI0001 you get:
120  * char *modalias: "acpi:IBM0001:ACPI0001"
121  * Return: 0: no _HID and no _CID
122  *         -EINVAL: output error
123  *         -ENOMEM: output is truncated
124 */
125 static int create_modalias(struct acpi_device *acpi_dev, char *modalias,
126                            int size)
127 {
128         int len;
129         int count;
130         struct acpi_hardware_id *id;
131 
132         if (list_empty(&acpi_dev->pnp.ids))
133                 return 0;
134 
135         /*
136          * If the device has PRP0001 we expose DT compatible modalias
137          * instead in form of of:NnameTCcompatible.
138          */
139         if (acpi_dev->data.of_compatible) {
140                 struct acpi_buffer buf = { ACPI_ALLOCATE_BUFFER };
141                 const union acpi_object *of_compatible, *obj;
142                 int i, nval;
143                 char *c;
144 
145                 acpi_get_name(acpi_dev->handle, ACPI_SINGLE_NAME, &buf);
146                 /* DT strings are all in lower case */
147                 for (c = buf.pointer; *c != '\0'; c++)
148                         *c = tolower(*c);
149 
150                 len = snprintf(modalias, size, "of:N%sT", (char *)buf.pointer);
151                 ACPI_FREE(buf.pointer);
152 
153                 of_compatible = acpi_dev->data.of_compatible;
154                 if (of_compatible->type == ACPI_TYPE_PACKAGE) {
155                         nval = of_compatible->package.count;
156                         obj = of_compatible->package.elements;
157                 } else { /* Must be ACPI_TYPE_STRING. */
158                         nval = 1;
159                         obj = of_compatible;
160                 }
161                 for (i = 0; i < nval; i++, obj++) {
162                         count = snprintf(&modalias[len], size, "C%s",
163                                          obj->string.pointer);
164                         if (count < 0)
165                                 return -EINVAL;
166                         if (count >= size)
167                                 return -ENOMEM;
168 
169                         len += count;
170                         size -= count;
171                 }
172         } else {
173                 len = snprintf(modalias, size, "acpi:");
174                 size -= len;
175 
176                 list_for_each_entry(id, &acpi_dev->pnp.ids, list) {
177                         count = snprintf(&modalias[len], size, "%s:", id->id);
178                         if (count < 0)
179                                 return -EINVAL;
180                         if (count >= size)
181                                 return -ENOMEM;
182                         len += count;
183                         size -= count;
184                 }
185         }
186 
187         modalias[len] = '\0';
188         return len;
189 }
190 
191 /*
192  * acpi_companion_match() - Can we match via ACPI companion device
193  * @dev: Device in question
194  *
195  * Check if the given device has an ACPI companion and if that companion has
196  * a valid list of PNP IDs, and if the device is the first (primary) physical
197  * device associated with it.
198  *
199  * If multiple physical devices are attached to a single ACPI companion, we need
200  * to be careful.  The usage scenario for this kind of relationship is that all
201  * of the physical devices in question use resources provided by the ACPI
202  * companion.  A typical case is an MFD device where all the sub-devices share
203  * the parent's ACPI companion.  In such cases we can only allow the primary
204  * (first) physical device to be matched with the help of the companion's PNP
205  * IDs.
206  *
207  * Additional physical devices sharing the ACPI companion can still use
208  * resources available from it but they will be matched normally using functions
209  * provided by their bus types (and analogously for their modalias).
210  */
211 static bool acpi_companion_match(const struct device *dev)
212 {
213         struct acpi_device *adev;
214         bool ret;
215 
216         adev = ACPI_COMPANION(dev);
217         if (!adev)
218                 return false;
219 
220         if (list_empty(&adev->pnp.ids))
221                 return false;
222 
223         mutex_lock(&adev->physical_node_lock);
224         if (list_empty(&adev->physical_node_list)) {
225                 ret = false;
226         } else {
227                 const struct acpi_device_physical_node *node;
228 
229                 node = list_first_entry(&adev->physical_node_list,
230                                         struct acpi_device_physical_node, node);
231                 ret = node->dev == dev;
232         }
233         mutex_unlock(&adev->physical_node_lock);
234 
235         return ret;
236 }
237 
238 /*
239  * Creates uevent modalias field for ACPI enumerated devices.
240  * Because the other buses does not support ACPI HIDs & CIDs.
241  * e.g. for a device with hid:IBM0001 and cid:ACPI0001 you get:
242  * "acpi:IBM0001:ACPI0001"
243  */
244 int acpi_device_uevent_modalias(struct device *dev, struct kobj_uevent_env *env)
245 {
246         int len;
247 
248         if (!acpi_companion_match(dev))
249                 return -ENODEV;
250 
251         if (add_uevent_var(env, "MODALIAS="))
252                 return -ENOMEM;
253         len = create_modalias(ACPI_COMPANION(dev), &env->buf[env->buflen - 1],
254                                 sizeof(env->buf) - env->buflen);
255         if (len <= 0)
256                 return len;
257         env->buflen += len;
258         return 0;
259 }
260 EXPORT_SYMBOL_GPL(acpi_device_uevent_modalias);
261 
262 /*
263  * Creates modalias sysfs attribute for ACPI enumerated devices.
264  * Because the other buses does not support ACPI HIDs & CIDs.
265  * e.g. for a device with hid:IBM0001 and cid:ACPI0001 you get:
266  * "acpi:IBM0001:ACPI0001"
267  */
268 int acpi_device_modalias(struct device *dev, char *buf, int size)
269 {
270         int len;
271 
272         if (!acpi_companion_match(dev))
273                 return -ENODEV;
274 
275         len = create_modalias(ACPI_COMPANION(dev), buf, size -1);
276         if (len <= 0)
277                 return len;
278         buf[len++] = '\n';
279         return len;
280 }
281 EXPORT_SYMBOL_GPL(acpi_device_modalias);
282 
283 static ssize_t
284 acpi_device_modalias_show(struct device *dev, struct device_attribute *attr, char *buf) {
285         struct acpi_device *acpi_dev = to_acpi_device(dev);
286         int len;
287 
288         len = create_modalias(acpi_dev, buf, 1024);
289         if (len <= 0)
290                 return len;
291         buf[len++] = '\n';
292         return len;
293 }
294 static DEVICE_ATTR(modalias, 0444, acpi_device_modalias_show, NULL);
295 
296 bool acpi_scan_is_offline(struct acpi_device *adev, bool uevent)
297 {
298         struct acpi_device_physical_node *pn;
299         bool offline = true;
300 
301         mutex_lock(&adev->physical_node_lock);
302 
303         list_for_each_entry(pn, &adev->physical_node_list, node)
304                 if (device_supports_offline(pn->dev) && !pn->dev->offline) {
305                         if (uevent)
306                                 kobject_uevent(&pn->dev->kobj, KOBJ_CHANGE);
307 
308                         offline = false;
309                         break;
310                 }
311 
312         mutex_unlock(&adev->physical_node_lock);
313         return offline;
314 }
315 
316 static acpi_status acpi_bus_offline(acpi_handle handle, u32 lvl, void *data,
317                                     void **ret_p)
318 {
319         struct acpi_device *device = NULL;
320         struct acpi_device_physical_node *pn;
321         bool second_pass = (bool)data;
322         acpi_status status = AE_OK;
323 
324         if (acpi_bus_get_device(handle, &device))
325                 return AE_OK;
326 
327         if (device->handler && !device->handler->hotplug.enabled) {
328                 *ret_p = &device->dev;
329                 return AE_SUPPORT;
330         }
331 
332         mutex_lock(&device->physical_node_lock);
333 
334         list_for_each_entry(pn, &device->physical_node_list, node) {
335                 int ret;
336 
337                 if (second_pass) {
338                         /* Skip devices offlined by the first pass. */
339                         if (pn->put_online)
340                                 continue;
341                 } else {
342                         pn->put_online = false;
343                 }
344                 ret = device_offline(pn->dev);
345                 if (acpi_force_hot_remove)
346                         continue;
347 
348                 if (ret >= 0) {
349                         pn->put_online = !ret;
350                 } else {
351                         *ret_p = pn->dev;
352                         if (second_pass) {
353                                 status = AE_ERROR;
354                                 break;
355                         }
356                 }
357         }
358 
359         mutex_unlock(&device->physical_node_lock);
360 
361         return status;
362 }
363 
364 static acpi_status acpi_bus_online(acpi_handle handle, u32 lvl, void *data,
365                                    void **ret_p)
366 {
367         struct acpi_device *device = NULL;
368         struct acpi_device_physical_node *pn;
369 
370         if (acpi_bus_get_device(handle, &device))
371                 return AE_OK;
372 
373         mutex_lock(&device->physical_node_lock);
374 
375         list_for_each_entry(pn, &device->physical_node_list, node)
376                 if (pn->put_online) {
377                         device_online(pn->dev);
378                         pn->put_online = false;
379                 }
380 
381         mutex_unlock(&device->physical_node_lock);
382 
383         return AE_OK;
384 }
385 
386 static int acpi_scan_try_to_offline(struct acpi_device *device)
387 {
388         acpi_handle handle = device->handle;
389         struct device *errdev = NULL;
390         acpi_status status;
391 
392         /*
393          * Carry out two passes here and ignore errors in the first pass,
394          * because if the devices in question are memory blocks and
395          * CONFIG_MEMCG is set, one of the blocks may hold data structures
396          * that the other blocks depend on, but it is not known in advance which
397          * block holds them.
398          *
399          * If the first pass is successful, the second one isn't needed, though.
400          */
401         status = acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
402                                      NULL, acpi_bus_offline, (void *)false,
403                                      (void **)&errdev);
404         if (status == AE_SUPPORT) {
405                 dev_warn(errdev, "Offline disabled.\n");
406                 acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
407                                     acpi_bus_online, NULL, NULL, NULL);
408                 return -EPERM;
409         }
410         acpi_bus_offline(handle, 0, (void *)false, (void **)&errdev);
411         if (errdev) {
412                 errdev = NULL;
413                 acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
414                                     NULL, acpi_bus_offline, (void *)true,
415                                     (void **)&errdev);
416                 if (!errdev || acpi_force_hot_remove)
417                         acpi_bus_offline(handle, 0, (void *)true,
418                                          (void **)&errdev);
419 
420                 if (errdev && !acpi_force_hot_remove) {
421                         dev_warn(errdev, "Offline failed.\n");
422                         acpi_bus_online(handle, 0, NULL, NULL);
423                         acpi_walk_namespace(ACPI_TYPE_ANY, handle,
424                                             ACPI_UINT32_MAX, acpi_bus_online,
425                                             NULL, NULL, NULL);
426                         return -EBUSY;
427                 }
428         }
429         return 0;
430 }
431 
432 static int acpi_scan_hot_remove(struct acpi_device *device)
433 {
434         acpi_handle handle = device->handle;
435         unsigned long long sta;
436         acpi_status status;
437 
438         if (device->handler && device->handler->hotplug.demand_offline
439             && !acpi_force_hot_remove) {
440                 if (!acpi_scan_is_offline(device, true))
441                         return -EBUSY;
442         } else {
443                 int error = acpi_scan_try_to_offline(device);
444                 if (error)
445                         return error;
446         }
447 
448         ACPI_DEBUG_PRINT((ACPI_DB_INFO,
449                 "Hot-removing device %s...\n", dev_name(&device->dev)));
450 
451         acpi_bus_trim(device);
452 
453         acpi_evaluate_lck(handle, 0);
454         /*
455          * TBD: _EJD support.
456          */
457         status = acpi_evaluate_ej0(handle);
458         if (status == AE_NOT_FOUND)
459                 return -ENODEV;
460         else if (ACPI_FAILURE(status))
461                 return -EIO;
462 
463         /*
464          * Verify if eject was indeed successful.  If not, log an error
465          * message.  No need to call _OST since _EJ0 call was made OK.
466          */
467         status = acpi_evaluate_integer(handle, "_STA", NULL, &sta);
468         if (ACPI_FAILURE(status)) {
469                 acpi_handle_warn(handle,
470                         "Status check after eject failed (0x%x)\n", status);
471         } else if (sta & ACPI_STA_DEVICE_ENABLED) {
472                 acpi_handle_warn(handle,
473                         "Eject incomplete - status 0x%llx\n", sta);
474         }
475 
476         return 0;
477 }
478 
479 static int acpi_scan_device_not_present(struct acpi_device *adev)
480 {
481         if (!acpi_device_enumerated(adev)) {
482                 dev_warn(&adev->dev, "Still not present\n");
483                 return -EALREADY;
484         }
485         acpi_bus_trim(adev);
486         return 0;
487 }
488 
489 static int acpi_scan_device_check(struct acpi_device *adev)
490 {
491         int error;
492 
493         acpi_bus_get_status(adev);
494         if (adev->status.present || adev->status.functional) {
495                 /*
496                  * This function is only called for device objects for which
497                  * matching scan handlers exist.  The only situation in which
498                  * the scan handler is not attached to this device object yet
499                  * is when the device has just appeared (either it wasn't
500                  * present at all before or it was removed and then added
501                  * again).
502                  */
503                 if (adev->handler) {
504                         dev_warn(&adev->dev, "Already enumerated\n");
505                         return -EALREADY;
506                 }
507                 error = acpi_bus_scan(adev->handle);
508                 if (error) {
509                         dev_warn(&adev->dev, "Namespace scan failure\n");
510                         return error;
511                 }
512                 if (!adev->handler) {
513                         dev_warn(&adev->dev, "Enumeration failure\n");
514                         error = -ENODEV;
515                 }
516         } else {
517                 error = acpi_scan_device_not_present(adev);
518         }
519         return error;
520 }
521 
522 static int acpi_scan_bus_check(struct acpi_device *adev)
523 {
524         struct acpi_scan_handler *handler = adev->handler;
525         struct acpi_device *child;
526         int error;
527 
528         acpi_bus_get_status(adev);
529         if (!(adev->status.present || adev->status.functional)) {
530                 acpi_scan_device_not_present(adev);
531                 return 0;
532         }
533         if (handler && handler->hotplug.scan_dependent)
534                 return handler->hotplug.scan_dependent(adev);
535 
536         error = acpi_bus_scan(adev->handle);
537         if (error) {
538                 dev_warn(&adev->dev, "Namespace scan failure\n");
539                 return error;
540         }
541         list_for_each_entry(child, &adev->children, node) {
542                 error = acpi_scan_bus_check(child);
543                 if (error)
544                         return error;
545         }
546         return 0;
547 }
548 
549 static int acpi_generic_hotplug_event(struct acpi_device *adev, u32 type)
550 {
551         switch (type) {
552         case ACPI_NOTIFY_BUS_CHECK:
553                 return acpi_scan_bus_check(adev);
554         case ACPI_NOTIFY_DEVICE_CHECK:
555                 return acpi_scan_device_check(adev);
556         case ACPI_NOTIFY_EJECT_REQUEST:
557         case ACPI_OST_EC_OSPM_EJECT:
558                 if (adev->handler && !adev->handler->hotplug.enabled) {
559                         dev_info(&adev->dev, "Eject disabled\n");
560                         return -EPERM;
561                 }
562                 acpi_evaluate_ost(adev->handle, ACPI_NOTIFY_EJECT_REQUEST,
563                                   ACPI_OST_SC_EJECT_IN_PROGRESS, NULL);
564                 return acpi_scan_hot_remove(adev);
565         }
566         return -EINVAL;
567 }
568 
569 void acpi_device_hotplug(struct acpi_device *adev, u32 src)
570 {
571         u32 ost_code = ACPI_OST_SC_NON_SPECIFIC_FAILURE;
572         int error = -ENODEV;
573 
574         lock_device_hotplug();
575         mutex_lock(&acpi_scan_lock);
576 
577         /*
578          * The device object's ACPI handle cannot become invalid as long as we
579          * are holding acpi_scan_lock, but it might have become invalid before
580          * that lock was acquired.
581          */
582         if (adev->handle == INVALID_ACPI_HANDLE)
583                 goto err_out;
584 
585         if (adev->flags.is_dock_station) {
586                 error = dock_notify(adev, src);
587         } else if (adev->flags.hotplug_notify) {
588                 error = acpi_generic_hotplug_event(adev, src);
589                 if (error == -EPERM) {
590                         ost_code = ACPI_OST_SC_EJECT_NOT_SUPPORTED;
591                         goto err_out;
592                 }
593         } else {
594                 int (*notify)(struct acpi_device *, u32);
595 
596                 acpi_lock_hp_context();
597                 notify = adev->hp ? adev->hp->notify : NULL;
598                 acpi_unlock_hp_context();
599                 /*
600                  * There may be additional notify handlers for device objects
601                  * without the .event() callback, so ignore them here.
602                  */
603                 if (notify)
604                         error = notify(adev, src);
605                 else
606                         goto out;
607         }
608         if (!error)
609                 ost_code = ACPI_OST_SC_SUCCESS;
610 
611  err_out:
612         acpi_evaluate_ost(adev->handle, src, ost_code, NULL);
613 
614  out:
615         acpi_bus_put_acpi_device(adev);
616         mutex_unlock(&acpi_scan_lock);
617         unlock_device_hotplug();
618 }
619 
620 static ssize_t real_power_state_show(struct device *dev,
621                                      struct device_attribute *attr, char *buf)
622 {
623         struct acpi_device *adev = to_acpi_device(dev);
624         int state;
625         int ret;
626 
627         ret = acpi_device_get_power(adev, &state);
628         if (ret)
629                 return ret;
630 
631         return sprintf(buf, "%s\n", acpi_power_state_string(state));
632 }
633 
634 static DEVICE_ATTR(real_power_state, 0444, real_power_state_show, NULL);
635 
636 static ssize_t power_state_show(struct device *dev,
637                                 struct device_attribute *attr, char *buf)
638 {
639         struct acpi_device *adev = to_acpi_device(dev);
640 
641         return sprintf(buf, "%s\n", acpi_power_state_string(adev->power.state));
642 }
643 
644 static DEVICE_ATTR(power_state, 0444, power_state_show, NULL);
645 
646 static ssize_t
647 acpi_eject_store(struct device *d, struct device_attribute *attr,
648                 const char *buf, size_t count)
649 {
650         struct acpi_device *acpi_device = to_acpi_device(d);
651         acpi_object_type not_used;
652         acpi_status status;
653 
654         if (!count || buf[0] != '1')
655                 return -EINVAL;
656 
657         if ((!acpi_device->handler || !acpi_device->handler->hotplug.enabled)
658             && !acpi_device->driver)
659                 return -ENODEV;
660 
661         status = acpi_get_type(acpi_device->handle, &not_used);
662         if (ACPI_FAILURE(status) || !acpi_device->flags.ejectable)
663                 return -ENODEV;
664 
665         get_device(&acpi_device->dev);
666         status = acpi_hotplug_schedule(acpi_device, ACPI_OST_EC_OSPM_EJECT);
667         if (ACPI_SUCCESS(status))
668                 return count;
669 
670         put_device(&acpi_device->dev);
671         acpi_evaluate_ost(acpi_device->handle, ACPI_OST_EC_OSPM_EJECT,
672                           ACPI_OST_SC_NON_SPECIFIC_FAILURE, NULL);
673         return status == AE_NO_MEMORY ? -ENOMEM : -EAGAIN;
674 }
675 
676 static DEVICE_ATTR(eject, 0200, NULL, acpi_eject_store);
677 
678 static ssize_t
679 acpi_device_hid_show(struct device *dev, struct device_attribute *attr, char *buf) {
680         struct acpi_device *acpi_dev = to_acpi_device(dev);
681 
682         return sprintf(buf, "%s\n", acpi_device_hid(acpi_dev));
683 }
684 static DEVICE_ATTR(hid, 0444, acpi_device_hid_show, NULL);
685 
686 static ssize_t acpi_device_uid_show(struct device *dev,
687                                     struct device_attribute *attr, char *buf)
688 {
689         struct acpi_device *acpi_dev = to_acpi_device(dev);
690 
691         return sprintf(buf, "%s\n", acpi_dev->pnp.unique_id);
692 }
693 static DEVICE_ATTR(uid, 0444, acpi_device_uid_show, NULL);
694 
695 static ssize_t acpi_device_adr_show(struct device *dev,
696                                     struct device_attribute *attr, char *buf)
697 {
698         struct acpi_device *acpi_dev = to_acpi_device(dev);
699 
700         return sprintf(buf, "0x%08x\n",
701                        (unsigned int)(acpi_dev->pnp.bus_address));
702 }
703 static DEVICE_ATTR(adr, 0444, acpi_device_adr_show, NULL);
704 
705 static ssize_t
706 acpi_device_path_show(struct device *dev, struct device_attribute *attr, char *buf) {
707         struct acpi_device *acpi_dev = to_acpi_device(dev);
708         struct acpi_buffer path = {ACPI_ALLOCATE_BUFFER, NULL};
709         int result;
710 
711         result = acpi_get_name(acpi_dev->handle, ACPI_FULL_PATHNAME, &path);
712         if (result)
713                 goto end;
714 
715         result = sprintf(buf, "%s\n", (char*)path.pointer);
716         kfree(path.pointer);
717 end:
718         return result;
719 }
720 static DEVICE_ATTR(path, 0444, acpi_device_path_show, NULL);
721 
722 /* sysfs file that shows description text from the ACPI _STR method */
723 static ssize_t description_show(struct device *dev,
724                                 struct device_attribute *attr,
725                                 char *buf) {
726         struct acpi_device *acpi_dev = to_acpi_device(dev);
727         int result;
728 
729         if (acpi_dev->pnp.str_obj == NULL)
730                 return 0;
731 
732         /*
733          * The _STR object contains a Unicode identifier for a device.
734          * We need to convert to utf-8 so it can be displayed.
735          */
736         result = utf16s_to_utf8s(
737                 (wchar_t *)acpi_dev->pnp.str_obj->buffer.pointer,
738                 acpi_dev->pnp.str_obj->buffer.length,
739                 UTF16_LITTLE_ENDIAN, buf,
740                 PAGE_SIZE);
741 
742         buf[result++] = '\n';
743 
744         return result;
745 }
746 static DEVICE_ATTR(description, 0444, description_show, NULL);
747 
748 static ssize_t
749 acpi_device_sun_show(struct device *dev, struct device_attribute *attr,
750                      char *buf) {
751         struct acpi_device *acpi_dev = to_acpi_device(dev);
752         acpi_status status;
753         unsigned long long sun;
754 
755         status = acpi_evaluate_integer(acpi_dev->handle, "_SUN", NULL, &sun);
756         if (ACPI_FAILURE(status))
757                 return -ENODEV;
758 
759         return sprintf(buf, "%llu\n", sun);
760 }
761 static DEVICE_ATTR(sun, 0444, acpi_device_sun_show, NULL);
762 
763 static ssize_t status_show(struct device *dev, struct device_attribute *attr,
764                                 char *buf) {
765         struct acpi_device *acpi_dev = to_acpi_device(dev);
766         acpi_status status;
767         unsigned long long sta;
768 
769         status = acpi_evaluate_integer(acpi_dev->handle, "_STA", NULL, &sta);
770         if (ACPI_FAILURE(status))
771                 return -ENODEV;
772 
773         return sprintf(buf, "%llu\n", sta);
774 }
775 static DEVICE_ATTR_RO(status);
776 
777 static int acpi_device_setup_files(struct acpi_device *dev)
778 {
779         struct acpi_buffer buffer = {ACPI_ALLOCATE_BUFFER, NULL};
780         acpi_status status;
781         int result = 0;
782 
783         /*
784          * Devices gotten from FADT don't have a "path" attribute
785          */
786         if (dev->handle) {
787                 result = device_create_file(&dev->dev, &dev_attr_path);
788                 if (result)
789                         goto end;
790         }
791 
792         if (!list_empty(&dev->pnp.ids)) {
793                 result = device_create_file(&dev->dev, &dev_attr_hid);
794                 if (result)
795                         goto end;
796 
797                 result = device_create_file(&dev->dev, &dev_attr_modalias);
798                 if (result)
799                         goto end;
800         }
801 
802         /*
803          * If device has _STR, 'description' file is created
804          */
805         if (acpi_has_method(dev->handle, "_STR")) {
806                 status = acpi_evaluate_object(dev->handle, "_STR",
807                                         NULL, &buffer);
808                 if (ACPI_FAILURE(status))
809                         buffer.pointer = NULL;
810                 dev->pnp.str_obj = buffer.pointer;
811                 result = device_create_file(&dev->dev, &dev_attr_description);
812                 if (result)
813                         goto end;
814         }
815 
816         if (dev->pnp.type.bus_address)
817                 result = device_create_file(&dev->dev, &dev_attr_adr);
818         if (dev->pnp.unique_id)
819                 result = device_create_file(&dev->dev, &dev_attr_uid);
820 
821         if (acpi_has_method(dev->handle, "_SUN")) {
822                 result = device_create_file(&dev->dev, &dev_attr_sun);
823                 if (result)
824                         goto end;
825         }
826 
827         if (acpi_has_method(dev->handle, "_STA")) {
828                 result = device_create_file(&dev->dev, &dev_attr_status);
829                 if (result)
830                         goto end;
831         }
832 
833         /*
834          * If device has _EJ0, 'eject' file is created that is used to trigger
835          * hot-removal function from userland.
836          */
837         if (acpi_has_method(dev->handle, "_EJ0")) {
838                 result = device_create_file(&dev->dev, &dev_attr_eject);
839                 if (result)
840                         return result;
841         }
842 
843         if (dev->flags.power_manageable) {
844                 result = device_create_file(&dev->dev, &dev_attr_power_state);
845                 if (result)
846                         return result;
847 
848                 if (dev->power.flags.power_resources)
849                         result = device_create_file(&dev->dev,
850                                                     &dev_attr_real_power_state);
851         }
852 
853 end:
854         return result;
855 }
856 
857 static void acpi_device_remove_files(struct acpi_device *dev)
858 {
859         if (dev->flags.power_manageable) {
860                 device_remove_file(&dev->dev, &dev_attr_power_state);
861                 if (dev->power.flags.power_resources)
862                         device_remove_file(&dev->dev,
863                                            &dev_attr_real_power_state);
864         }
865 
866         /*
867          * If device has _STR, remove 'description' file
868          */
869         if (acpi_has_method(dev->handle, "_STR")) {
870                 kfree(dev->pnp.str_obj);
871                 device_remove_file(&dev->dev, &dev_attr_description);
872         }
873         /*
874          * If device has _EJ0, remove 'eject' file.
875          */
876         if (acpi_has_method(dev->handle, "_EJ0"))
877                 device_remove_file(&dev->dev, &dev_attr_eject);
878 
879         if (acpi_has_method(dev->handle, "_SUN"))
880                 device_remove_file(&dev->dev, &dev_attr_sun);
881 
882         if (dev->pnp.unique_id)
883                 device_remove_file(&dev->dev, &dev_attr_uid);
884         if (dev->pnp.type.bus_address)
885                 device_remove_file(&dev->dev, &dev_attr_adr);
886         device_remove_file(&dev->dev, &dev_attr_modalias);
887         device_remove_file(&dev->dev, &dev_attr_hid);
888         if (acpi_has_method(dev->handle, "_STA"))
889                 device_remove_file(&dev->dev, &dev_attr_status);
890         if (dev->handle)
891                 device_remove_file(&dev->dev, &dev_attr_path);
892 }
893 /* --------------------------------------------------------------------------
894                         ACPI Bus operations
895    -------------------------------------------------------------------------- */
896 
897 static const struct acpi_device_id *__acpi_match_device(
898         struct acpi_device *device, const struct acpi_device_id *ids)
899 {
900         const struct acpi_device_id *id;
901         struct acpi_hardware_id *hwid;
902 
903         /*
904          * If the device is not present, it is unnecessary to load device
905          * driver for it.
906          */
907         if (!device->status.present)
908                 return NULL;
909 
910         for (id = ids; id->id[0]; id++)
911                 list_for_each_entry(hwid, &device->pnp.ids, list)
912                         if (!strcmp((char *) id->id, hwid->id))
913                                 return id;
914 
915         return NULL;
916 }
917 
918 /**
919  * acpi_match_device - Match a struct device against a given list of ACPI IDs
920  * @ids: Array of struct acpi_device_id object to match against.
921  * @dev: The device structure to match.
922  *
923  * Check if @dev has a valid ACPI handle and if there is a struct acpi_device
924  * object for that handle and use that object to match against a given list of
925  * device IDs.
926  *
927  * Return a pointer to the first matching ID on success or %NULL on failure.
928  */
929 const struct acpi_device_id *acpi_match_device(const struct acpi_device_id *ids,
930                                                const struct device *dev)
931 {
932         struct acpi_device *adev;
933         acpi_handle handle = ACPI_HANDLE(dev);
934 
935         if (!ids || !handle || acpi_bus_get_device(handle, &adev))
936                 return NULL;
937 
938         if (!acpi_companion_match(dev))
939                 return NULL;
940 
941         return __acpi_match_device(adev, ids);
942 }
943 EXPORT_SYMBOL_GPL(acpi_match_device);
944 
945 int acpi_match_device_ids(struct acpi_device *device,
946                           const struct acpi_device_id *ids)
947 {
948         return __acpi_match_device(device, ids) ? 0 : -ENOENT;
949 }
950 EXPORT_SYMBOL(acpi_match_device_ids);
951 
952 /* Performs match against special "PRP0001" shoehorn ACPI ID */
953 static bool acpi_of_driver_match_device(struct device *dev,
954                                         const struct device_driver *drv)
955 {
956         const union acpi_object *of_compatible, *obj;
957         struct acpi_device *adev;
958         int i, nval;
959 
960         adev = ACPI_COMPANION(dev);
961         if (!adev)
962                 return false;
963 
964         of_compatible = adev->data.of_compatible;
965         if (!drv->of_match_table || !of_compatible)
966                 return false;
967 
968         if (of_compatible->type == ACPI_TYPE_PACKAGE) {
969                 nval = of_compatible->package.count;
970                 obj = of_compatible->package.elements;
971         } else { /* Must be ACPI_TYPE_STRING. */
972                 nval = 1;
973                 obj = of_compatible;
974         }
975         /* Now we can look for the driver DT compatible strings */
976         for (i = 0; i < nval; i++, obj++) {
977                 const struct of_device_id *id;
978 
979                 for (id = drv->of_match_table; id->compatible[0]; id++)
980                         if (!strcasecmp(obj->string.pointer, id->compatible))
981                                 return true;
982         }
983 
984         return false;
985 }
986 
987 bool acpi_driver_match_device(struct device *dev,
988                               const struct device_driver *drv)
989 {
990         if (!drv->acpi_match_table)
991                 return acpi_of_driver_match_device(dev, drv);
992 
993         return !!acpi_match_device(drv->acpi_match_table, dev);
994 }
995 EXPORT_SYMBOL_GPL(acpi_driver_match_device);
996 
997 static void acpi_free_power_resources_lists(struct acpi_device *device)
998 {
999         int i;
1000 
1001         if (device->wakeup.flags.valid)
1002                 acpi_power_resources_list_free(&device->wakeup.resources);
1003 
1004         if (!device->power.flags.power_resources)
1005                 return;
1006 
1007         for (i = ACPI_STATE_D0; i <= ACPI_STATE_D3_HOT; i++) {
1008                 struct acpi_device_power_state *ps = &device->power.states[i];
1009                 acpi_power_resources_list_free(&ps->resources);
1010         }
1011 }
1012 
1013 static void acpi_device_release(struct device *dev)
1014 {
1015         struct acpi_device *acpi_dev = to_acpi_device(dev);
1016 
1017         acpi_free_properties(acpi_dev);
1018         acpi_free_pnp_ids(&acpi_dev->pnp);
1019         acpi_free_power_resources_lists(acpi_dev);
1020         kfree(acpi_dev);
1021 }
1022 
1023 static int acpi_bus_match(struct device *dev, struct device_driver *drv)
1024 {
1025         struct acpi_device *acpi_dev = to_acpi_device(dev);
1026         struct acpi_driver *acpi_drv = to_acpi_driver(drv);
1027 
1028         return acpi_dev->flags.match_driver
1029                 && !acpi_match_device_ids(acpi_dev, acpi_drv->ids);
1030 }
1031 
1032 static int acpi_device_uevent(struct device *dev, struct kobj_uevent_env *env)
1033 {
1034         struct acpi_device *acpi_dev = to_acpi_device(dev);
1035         int len;
1036 
1037         if (list_empty(&acpi_dev->pnp.ids))
1038                 return 0;
1039 
1040         if (add_uevent_var(env, "MODALIAS="))
1041                 return -ENOMEM;
1042         len = create_modalias(acpi_dev, &env->buf[env->buflen - 1],
1043                               sizeof(env->buf) - env->buflen);
1044         if (len <= 0)
1045                 return len;
1046         env->buflen += len;
1047         return 0;
1048 }
1049 
1050 static void acpi_device_notify(acpi_handle handle, u32 event, void *data)
1051 {
1052         struct acpi_device *device = data;
1053 
1054         device->driver->ops.notify(device, event);
1055 }
1056 
1057 static void acpi_device_notify_fixed(void *data)
1058 {
1059         struct acpi_device *device = data;
1060 
1061         /* Fixed hardware devices have no handles */
1062         acpi_device_notify(NULL, ACPI_FIXED_HARDWARE_EVENT, device);
1063 }
1064 
1065 static acpi_status acpi_device_fixed_event(void *data)
1066 {
1067         acpi_os_execute(OSL_NOTIFY_HANDLER, acpi_device_notify_fixed, data);
1068         return AE_OK;
1069 }
1070 
1071 static int acpi_device_install_notify_handler(struct acpi_device *device)
1072 {
1073         acpi_status status;
1074 
1075         if (device->device_type == ACPI_BUS_TYPE_POWER_BUTTON)
1076                 status =
1077                     acpi_install_fixed_event_handler(ACPI_EVENT_POWER_BUTTON,
1078                                                      acpi_device_fixed_event,
1079                                                      device);
1080         else if (device->device_type == ACPI_BUS_TYPE_SLEEP_BUTTON)
1081                 status =
1082                     acpi_install_fixed_event_handler(ACPI_EVENT_SLEEP_BUTTON,
1083                                                      acpi_device_fixed_event,
1084                                                      device);
1085         else
1086                 status = acpi_install_notify_handler(device->handle,
1087                                                      ACPI_DEVICE_NOTIFY,
1088                                                      acpi_device_notify,
1089                                                      device);
1090 
1091         if (ACPI_FAILURE(status))
1092                 return -EINVAL;
1093         return 0;
1094 }
1095 
1096 static void acpi_device_remove_notify_handler(struct acpi_device *device)
1097 {
1098         if (device->device_type == ACPI_BUS_TYPE_POWER_BUTTON)
1099                 acpi_remove_fixed_event_handler(ACPI_EVENT_POWER_BUTTON,
1100                                                 acpi_device_fixed_event);
1101         else if (device->device_type == ACPI_BUS_TYPE_SLEEP_BUTTON)
1102                 acpi_remove_fixed_event_handler(ACPI_EVENT_SLEEP_BUTTON,
1103                                                 acpi_device_fixed_event);
1104         else
1105                 acpi_remove_notify_handler(device->handle, ACPI_DEVICE_NOTIFY,
1106                                            acpi_device_notify);
1107 }
1108 
1109 static int acpi_device_probe(struct device *dev)
1110 {
1111         struct acpi_device *acpi_dev = to_acpi_device(dev);
1112         struct acpi_driver *acpi_drv = to_acpi_driver(dev->driver);
1113         int ret;
1114 
1115         if (acpi_dev->handler && !acpi_is_pnp_device(acpi_dev))
1116                 return -EINVAL;
1117 
1118         if (!acpi_drv->ops.add)
1119                 return -ENOSYS;
1120 
1121         ret = acpi_drv->ops.add(acpi_dev);
1122         if (ret)
1123                 return ret;
1124 
1125         acpi_dev->driver = acpi_drv;
1126         ACPI_DEBUG_PRINT((ACPI_DB_INFO,
1127                           "Driver [%s] successfully bound to device [%s]\n",
1128                           acpi_drv->name, acpi_dev->pnp.bus_id));
1129 
1130         if (acpi_drv->ops.notify) {
1131                 ret = acpi_device_install_notify_handler(acpi_dev);
1132                 if (ret) {
1133                         if (acpi_drv->ops.remove)
1134                                 acpi_drv->ops.remove(acpi_dev);
1135 
1136                         acpi_dev->driver = NULL;
1137                         acpi_dev->driver_data = NULL;
1138                         return ret;
1139                 }
1140         }
1141 
1142         ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Found driver [%s] for device [%s]\n",
1143                           acpi_drv->name, acpi_dev->pnp.bus_id));
1144         get_device(dev);
1145         return 0;
1146 }
1147 
1148 static int acpi_device_remove(struct device * dev)
1149 {
1150         struct acpi_device *acpi_dev = to_acpi_device(dev);
1151         struct acpi_driver *acpi_drv = acpi_dev->driver;
1152 
1153         if (acpi_drv) {
1154                 if (acpi_drv->ops.notify)
1155                         acpi_device_remove_notify_handler(acpi_dev);
1156                 if (acpi_drv->ops.remove)
1157                         acpi_drv->ops.remove(acpi_dev);
1158         }
1159         acpi_dev->driver = NULL;
1160         acpi_dev->driver_data = NULL;
1161 
1162         put_device(dev);
1163         return 0;
1164 }
1165 
1166 struct bus_type acpi_bus_type = {
1167         .name           = "acpi",
1168         .match          = acpi_bus_match,
1169         .probe          = acpi_device_probe,
1170         .remove         = acpi_device_remove,
1171         .uevent         = acpi_device_uevent,
1172 };
1173 
1174 static void acpi_device_del(struct acpi_device *device)
1175 {
1176         mutex_lock(&acpi_device_lock);
1177         if (device->parent)
1178                 list_del(&device->node);
1179 
1180         list_del(&device->wakeup_list);
1181         mutex_unlock(&acpi_device_lock);
1182 
1183         acpi_power_add_remove_device(device, false);
1184         acpi_device_remove_files(device);
1185         if (device->remove)
1186                 device->remove(device);
1187 
1188         device_del(&device->dev);
1189 }
1190 
1191 static LIST_HEAD(acpi_device_del_list);
1192 static DEFINE_MUTEX(acpi_device_del_lock);
1193 
1194 static void acpi_device_del_work_fn(struct work_struct *work_not_used)
1195 {
1196         for (;;) {
1197                 struct acpi_device *adev;
1198 
1199                 mutex_lock(&acpi_device_del_lock);
1200 
1201                 if (list_empty(&acpi_device_del_list)) {
1202                         mutex_unlock(&acpi_device_del_lock);
1203                         break;
1204                 }
1205                 adev = list_first_entry(&acpi_device_del_list,
1206                                         struct acpi_device, del_list);
1207                 list_del(&adev->del_list);
1208 
1209                 mutex_unlock(&acpi_device_del_lock);
1210 
1211                 acpi_device_del(adev);
1212                 /*
1213                  * Drop references to all power resources that might have been
1214                  * used by the device.
1215                  */
1216                 acpi_power_transition(adev, ACPI_STATE_D3_COLD);
1217                 put_device(&adev->dev);
1218         }
1219 }
1220 
1221 /**
1222  * acpi_scan_drop_device - Drop an ACPI device object.
1223  * @handle: Handle of an ACPI namespace node, not used.
1224  * @context: Address of the ACPI device object to drop.
1225  *
1226  * This is invoked by acpi_ns_delete_node() during the removal of the ACPI
1227  * namespace node the device object pointed to by @context is attached to.
1228  *
1229  * The unregistration is carried out asynchronously to avoid running
1230  * acpi_device_del() under the ACPICA's namespace mutex and the list is used to
1231  * ensure the correct ordering (the device objects must be unregistered in the
1232  * same order in which the corresponding namespace nodes are deleted).
1233  */
1234 static void acpi_scan_drop_device(acpi_handle handle, void *context)
1235 {
1236         static DECLARE_WORK(work, acpi_device_del_work_fn);
1237         struct acpi_device *adev = context;
1238 
1239         mutex_lock(&acpi_device_del_lock);
1240 
1241         /*
1242          * Use the ACPI hotplug workqueue which is ordered, so this work item
1243          * won't run after any hotplug work items submitted subsequently.  That
1244          * prevents attempts to register device objects identical to those being
1245          * deleted from happening concurrently (such attempts result from
1246          * hotplug events handled via the ACPI hotplug workqueue).  It also will
1247          * run after all of the work items submitted previosuly, which helps
1248          * those work items to ensure that they are not accessing stale device
1249          * objects.
1250          */
1251         if (list_empty(&acpi_device_del_list))
1252                 acpi_queue_hotplug_work(&work);
1253 
1254         list_add_tail(&adev->del_list, &acpi_device_del_list);
1255         /* Make acpi_ns_validate_handle() return NULL for this handle. */
1256         adev->handle = INVALID_ACPI_HANDLE;
1257 
1258         mutex_unlock(&acpi_device_del_lock);
1259 }
1260 
1261 static int acpi_get_device_data(acpi_handle handle, struct acpi_device **device,
1262                                 void (*callback)(void *))
1263 {
1264         acpi_status status;
1265 
1266         if (!device)
1267                 return -EINVAL;
1268 
1269         status = acpi_get_data_full(handle, acpi_scan_drop_device,
1270                                     (void **)device, callback);
1271         if (ACPI_FAILURE(status) || !*device) {
1272                 ACPI_DEBUG_PRINT((ACPI_DB_INFO, "No context for object [%p]\n",
1273                                   handle));
1274                 return -ENODEV;
1275         }
1276         return 0;
1277 }
1278 
1279 int acpi_bus_get_device(acpi_handle handle, struct acpi_device **device)
1280 {
1281         return acpi_get_device_data(handle, device, NULL);
1282 }
1283 EXPORT_SYMBOL(acpi_bus_get_device);
1284 
1285 static void get_acpi_device(void *dev)
1286 {
1287         if (dev)
1288                 get_device(&((struct acpi_device *)dev)->dev);
1289 }
1290 
1291 struct acpi_device *acpi_bus_get_acpi_device(acpi_handle handle)
1292 {
1293         struct acpi_device *adev = NULL;
1294 
1295         acpi_get_device_data(handle, &adev, get_acpi_device);
1296         return adev;
1297 }
1298 
1299 void acpi_bus_put_acpi_device(struct acpi_device *adev)
1300 {
1301         put_device(&adev->dev);
1302 }
1303 
1304 int acpi_device_add(struct acpi_device *device,
1305                     void (*release)(struct device *))
1306 {
1307         int result;
1308         struct acpi_device_bus_id *acpi_device_bus_id, *new_bus_id;
1309         int found = 0;
1310 
1311         if (device->handle) {
1312                 acpi_status status;
1313 
1314                 status = acpi_attach_data(device->handle, acpi_scan_drop_device,
1315                                           device);
1316                 if (ACPI_FAILURE(status)) {
1317                         acpi_handle_err(device->handle,
1318                                         "Unable to attach device data\n");
1319                         return -ENODEV;
1320                 }
1321         }
1322 
1323         /*
1324          * Linkage
1325          * -------
1326          * Link this device to its parent and siblings.
1327          */
1328         INIT_LIST_HEAD(&device->children);
1329         INIT_LIST_HEAD(&device->node);
1330         INIT_LIST_HEAD(&device->wakeup_list);
1331         INIT_LIST_HEAD(&device->physical_node_list);
1332         INIT_LIST_HEAD(&device->del_list);
1333         mutex_init(&device->physical_node_lock);
1334 
1335         new_bus_id = kzalloc(sizeof(struct acpi_device_bus_id), GFP_KERNEL);
1336         if (!new_bus_id) {
1337                 pr_err(PREFIX "Memory allocation error\n");
1338                 result = -ENOMEM;
1339                 goto err_detach;
1340         }
1341 
1342         mutex_lock(&acpi_device_lock);
1343         /*
1344          * Find suitable bus_id and instance number in acpi_bus_id_list
1345          * If failed, create one and link it into acpi_bus_id_list
1346          */
1347         list_for_each_entry(acpi_device_bus_id, &acpi_bus_id_list, node) {
1348                 if (!strcmp(acpi_device_bus_id->bus_id,
1349                             acpi_device_hid(device))) {
1350                         acpi_device_bus_id->instance_no++;
1351                         found = 1;
1352                         kfree(new_bus_id);
1353                         break;
1354                 }
1355         }
1356         if (!found) {
1357                 acpi_device_bus_id = new_bus_id;
1358                 strcpy(acpi_device_bus_id->bus_id, acpi_device_hid(device));
1359                 acpi_device_bus_id->instance_no = 0;
1360                 list_add_tail(&acpi_device_bus_id->node, &acpi_bus_id_list);
1361         }
1362         dev_set_name(&device->dev, "%s:%02x", acpi_device_bus_id->bus_id, acpi_device_bus_id->instance_no);
1363 
1364         if (device->parent)
1365                 list_add_tail(&device->node, &device->parent->children);
1366 
1367         if (device->wakeup.flags.valid)
1368                 list_add_tail(&device->wakeup_list, &acpi_wakeup_device_list);
1369         mutex_unlock(&acpi_device_lock);
1370 
1371         if (device->parent)
1372                 device->dev.parent = &device->parent->dev;
1373         device->dev.bus = &acpi_bus_type;
1374         device->dev.release = release;
1375         result = device_add(&device->dev);
1376         if (result) {
1377                 dev_err(&device->dev, "Error registering device\n");
1378                 goto err;
1379         }
1380 
1381         result = acpi_device_setup_files(device);
1382         if (result)
1383                 printk(KERN_ERR PREFIX "Error creating sysfs interface for device %s\n",
1384                        dev_name(&device->dev));
1385 
1386         return 0;
1387 
1388  err:
1389         mutex_lock(&acpi_device_lock);
1390         if (device->parent)
1391                 list_del(&device->node);
1392         list_del(&device->wakeup_list);
1393         mutex_unlock(&acpi_device_lock);
1394 
1395  err_detach:
1396         acpi_detach_data(device->handle, acpi_scan_drop_device);
1397         return result;
1398 }
1399 
1400 struct acpi_device *acpi_get_next_child(struct device *dev,
1401                                         struct acpi_device *child)
1402 {
1403         struct acpi_device *adev = ACPI_COMPANION(dev);
1404         struct list_head *head, *next;
1405 
1406         if (!adev)
1407                 return NULL;
1408 
1409         head = &adev->children;
1410         if (list_empty(head))
1411                 return NULL;
1412 
1413         if (!child)
1414                 return list_first_entry(head, struct acpi_device, node);
1415 
1416         next = child->node.next;
1417         return next == head ? NULL : list_entry(next, struct acpi_device, node);
1418 }
1419 
1420 /* --------------------------------------------------------------------------
1421                                  Driver Management
1422    -------------------------------------------------------------------------- */
1423 /**
1424  * acpi_bus_register_driver - register a driver with the ACPI bus
1425  * @driver: driver being registered
1426  *
1427  * Registers a driver with the ACPI bus.  Searches the namespace for all
1428  * devices that match the driver's criteria and binds.  Returns zero for
1429  * success or a negative error status for failure.
1430  */
1431 int acpi_bus_register_driver(struct acpi_driver *driver)
1432 {
1433         int ret;
1434 
1435         if (acpi_disabled)
1436                 return -ENODEV;
1437         driver->drv.name = driver->name;
1438         driver->drv.bus = &acpi_bus_type;
1439         driver->drv.owner = driver->owner;
1440 
1441         ret = driver_register(&driver->drv);
1442         return ret;
1443 }
1444 
1445 EXPORT_SYMBOL(acpi_bus_register_driver);
1446 
1447 /**
1448  * acpi_bus_unregister_driver - unregisters a driver with the ACPI bus
1449  * @driver: driver to unregister
1450  *
1451  * Unregisters a driver with the ACPI bus.  Searches the namespace for all
1452  * devices that match the driver's criteria and unbinds.
1453  */
1454 void acpi_bus_unregister_driver(struct acpi_driver *driver)
1455 {
1456         driver_unregister(&driver->drv);
1457 }
1458 
1459 EXPORT_SYMBOL(acpi_bus_unregister_driver);
1460 
1461 /* --------------------------------------------------------------------------
1462                                  Device Enumeration
1463    -------------------------------------------------------------------------- */
1464 static struct acpi_device *acpi_bus_get_parent(acpi_handle handle)
1465 {
1466         struct acpi_device *device = NULL;
1467         acpi_status status;
1468 
1469         /*
1470          * Fixed hardware devices do not appear in the namespace and do not
1471          * have handles, but we fabricate acpi_devices for them, so we have
1472          * to deal with them specially.
1473          */
1474         if (!handle)
1475                 return acpi_root;
1476 
1477         do {
1478                 status = acpi_get_parent(handle, &handle);
1479                 if (ACPI_FAILURE(status))
1480                         return status == AE_NULL_ENTRY ? NULL : acpi_root;
1481         } while (acpi_bus_get_device(handle, &device));
1482         return device;
1483 }
1484 
1485 acpi_status
1486 acpi_bus_get_ejd(acpi_handle handle, acpi_handle *ejd)
1487 {
1488         acpi_status status;
1489         acpi_handle tmp;
1490         struct acpi_buffer buffer = {ACPI_ALLOCATE_BUFFER, NULL};
1491         union acpi_object *obj;
1492 
1493         status = acpi_get_handle(handle, "_EJD", &tmp);
1494         if (ACPI_FAILURE(status))
1495                 return status;
1496 
1497         status = acpi_evaluate_object(handle, "_EJD", NULL, &buffer);
1498         if (ACPI_SUCCESS(status)) {
1499                 obj = buffer.pointer;
1500                 status = acpi_get_handle(ACPI_ROOT_OBJECT, obj->string.pointer,
1501                                          ejd);
1502                 kfree(buffer.pointer);
1503         }
1504         return status;
1505 }
1506 EXPORT_SYMBOL_GPL(acpi_bus_get_ejd);
1507 
1508 static int acpi_bus_extract_wakeup_device_power_package(acpi_handle handle,
1509                                         struct acpi_device_wakeup *wakeup)
1510 {
1511         struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
1512         union acpi_object *package = NULL;
1513         union acpi_object *element = NULL;
1514         acpi_status status;
1515         int err = -ENODATA;
1516 
1517         if (!wakeup)
1518                 return -EINVAL;
1519 
1520         INIT_LIST_HEAD(&wakeup->resources);
1521 
1522         /* _PRW */
1523         status = acpi_evaluate_object(handle, "_PRW", NULL, &buffer);
1524         if (ACPI_FAILURE(status)) {
1525                 ACPI_EXCEPTION((AE_INFO, status, "Evaluating _PRW"));
1526                 return err;
1527         }
1528 
1529         package = (union acpi_object *)buffer.pointer;
1530 
1531         if (!package || package->package.count < 2)
1532                 goto out;
1533 
1534         element = &(package->package.elements[0]);
1535         if (!element)
1536                 goto out;
1537 
1538         if (element->type == ACPI_TYPE_PACKAGE) {
1539                 if ((element->package.count < 2) ||
1540                     (element->package.elements[0].type !=
1541                      ACPI_TYPE_LOCAL_REFERENCE)
1542                     || (element->package.elements[1].type != ACPI_TYPE_INTEGER))
1543                         goto out;
1544 
1545                 wakeup->gpe_device =
1546                     element->package.elements[0].reference.handle;
1547                 wakeup->gpe_number =
1548                     (u32) element->package.elements[1].integer.value;
1549         } else if (element->type == ACPI_TYPE_INTEGER) {
1550                 wakeup->gpe_device = NULL;
1551                 wakeup->gpe_number = element->integer.value;
1552         } else {
1553                 goto out;
1554         }
1555 
1556         element = &(package->package.elements[1]);
1557         if (element->type != ACPI_TYPE_INTEGER)
1558                 goto out;
1559 
1560         wakeup->sleep_state = element->integer.value;
1561 
1562         err = acpi_extract_power_resources(package, 2, &wakeup->resources);
1563         if (err)
1564                 goto out;
1565 
1566         if (!list_empty(&wakeup->resources)) {
1567                 int sleep_state;
1568 
1569                 err = acpi_power_wakeup_list_init(&wakeup->resources,
1570                                                   &sleep_state);
1571                 if (err) {
1572                         acpi_handle_warn(handle, "Retrieving current states "
1573                                          "of wakeup power resources failed\n");
1574                         acpi_power_resources_list_free(&wakeup->resources);
1575                         goto out;
1576                 }
1577                 if (sleep_state < wakeup->sleep_state) {
1578                         acpi_handle_warn(handle, "Overriding _PRW sleep state "
1579                                          "(S%d) by S%d from power resources\n",
1580                                          (int)wakeup->sleep_state, sleep_state);
1581                         wakeup->sleep_state = sleep_state;
1582                 }
1583         }
1584 
1585  out:
1586         kfree(buffer.pointer);
1587         return err;
1588 }
1589 
1590 static void acpi_wakeup_gpe_init(struct acpi_device *device)
1591 {
1592         struct acpi_device_id button_device_ids[] = {
1593                 {"PNP0C0C", 0},
1594                 {"PNP0C0D", 0},
1595                 {"PNP0C0E", 0},
1596                 {"", 0},
1597         };
1598         struct acpi_device_wakeup *wakeup = &device->wakeup;
1599         acpi_status status;
1600         acpi_event_status event_status;
1601 
1602         wakeup->flags.notifier_present = 0;
1603 
1604         /* Power button, Lid switch always enable wakeup */
1605         if (!acpi_match_device_ids(device, button_device_ids)) {
1606                 wakeup->flags.run_wake = 1;
1607                 if (!acpi_match_device_ids(device, &button_device_ids[1])) {
1608                         /* Do not use Lid/sleep button for S5 wakeup */
1609                         if (wakeup->sleep_state == ACPI_STATE_S5)
1610                                 wakeup->sleep_state = ACPI_STATE_S4;
1611                 }
1612                 acpi_mark_gpe_for_wake(wakeup->gpe_device, wakeup->gpe_number);
1613                 device_set_wakeup_capable(&device->dev, true);
1614                 return;
1615         }
1616 
1617         acpi_setup_gpe_for_wake(device->handle, wakeup->gpe_device,
1618                                 wakeup->gpe_number);
1619         status = acpi_get_gpe_status(wakeup->gpe_device, wakeup->gpe_number,
1620                                      &event_status);
1621         if (ACPI_FAILURE(status))
1622                 return;
1623 
1624         wakeup->flags.run_wake = !!(event_status & ACPI_EVENT_FLAG_HAS_HANDLER);
1625 }
1626 
1627 static void acpi_bus_get_wakeup_device_flags(struct acpi_device *device)
1628 {
1629         int err;
1630 
1631         /* Presence of _PRW indicates wake capable */
1632         if (!acpi_has_method(device->handle, "_PRW"))
1633                 return;
1634 
1635         err = acpi_bus_extract_wakeup_device_power_package(device->handle,
1636                                                            &device->wakeup);
1637         if (err) {
1638                 dev_err(&device->dev, "_PRW evaluation error: %d\n", err);
1639                 return;
1640         }
1641 
1642         device->wakeup.flags.valid = 1;
1643         device->wakeup.prepare_count = 0;
1644         acpi_wakeup_gpe_init(device);
1645         /* Call _PSW/_DSW object to disable its ability to wake the sleeping
1646          * system for the ACPI device with the _PRW object.
1647          * The _PSW object is depreciated in ACPI 3.0 and is replaced by _DSW.
1648          * So it is necessary to call _DSW object first. Only when it is not
1649          * present will the _PSW object used.
1650          */
1651         err = acpi_device_sleep_wake(device, 0, 0, 0);
1652         if (err)
1653                 ACPI_DEBUG_PRINT((ACPI_DB_INFO,
1654                                 "error in _DSW or _PSW evaluation\n"));
1655 }
1656 
1657 static void acpi_bus_init_power_state(struct acpi_device *device, int state)
1658 {
1659         struct acpi_device_power_state *ps = &device->power.states[state];
1660         char pathname[5] = { '_', 'P', 'R', '' + state, '\0' };
1661         struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
1662         acpi_status status;
1663 
1664         INIT_LIST_HEAD(&ps->resources);
1665 
1666         /* Evaluate "_PRx" to get referenced power resources */
1667         status = acpi_evaluate_object(device->handle, pathname, NULL, &buffer);
1668         if (ACPI_SUCCESS(status)) {
1669                 union acpi_object *package = buffer.pointer;
1670 
1671                 if (buffer.length && package
1672                     && package->type == ACPI_TYPE_PACKAGE
1673                     && package->package.count) {
1674                         int err = acpi_extract_power_resources(package, 0,
1675                                                                &ps->resources);
1676                         if (!err)
1677                                 device->power.flags.power_resources = 1;
1678                 }
1679                 ACPI_FREE(buffer.pointer);
1680         }
1681 
1682         /* Evaluate "_PSx" to see if we can do explicit sets */
1683         pathname[2] = 'S';
1684         if (acpi_has_method(device->handle, pathname))
1685                 ps->flags.explicit_set = 1;
1686 
1687         /*
1688          * State is valid if there are means to put the device into it.
1689          * D3hot is only valid if _PR3 present.
1690          */
1691         if (!list_empty(&ps->resources)
1692             || (ps->flags.explicit_set && state < ACPI_STATE_D3_HOT)) {
1693                 ps->flags.valid = 1;
1694                 ps->flags.os_accessible = 1;
1695         }
1696 
1697         ps->power = -1;         /* Unknown - driver assigned */
1698         ps->latency = -1;       /* Unknown - driver assigned */
1699 }
1700 
1701 static void acpi_bus_get_power_flags(struct acpi_device *device)
1702 {
1703         u32 i;
1704 
1705         /* Presence of _PS0|_PR0 indicates 'power manageable' */
1706         if (!acpi_has_method(device->handle, "_PS0") &&
1707             !acpi_has_method(device->handle, "_PR0"))
1708                 return;
1709 
1710         device->flags.power_manageable = 1;
1711 
1712         /*
1713          * Power Management Flags
1714          */
1715         if (acpi_has_method(device->handle, "_PSC"))
1716                 device->power.flags.explicit_get = 1;
1717 
1718         if (acpi_has_method(device->handle, "_IRC"))
1719                 device->power.flags.inrush_current = 1;
1720 
1721         if (acpi_has_method(device->handle, "_DSW"))
1722                 device->power.flags.dsw_present = 1;
1723 
1724         /*
1725          * Enumerate supported power management states
1726          */
1727         for (i = ACPI_STATE_D0; i <= ACPI_STATE_D3_HOT; i++)
1728                 acpi_bus_init_power_state(device, i);
1729 
1730         INIT_LIST_HEAD(&device->power.states[ACPI_STATE_D3_COLD].resources);
1731 
1732         /* Set defaults for D0 and D3 states (always valid) */
1733         device->power.states[ACPI_STATE_D0].flags.valid = 1;
1734         device->power.states[ACPI_STATE_D0].power = 100;
1735         device->power.states[ACPI_STATE_D3_COLD].flags.valid = 1;
1736         device->power.states[ACPI_STATE_D3_COLD].power = 0;
1737 
1738         /* Set D3cold's explicit_set flag if _PS3 exists. */
1739         if (device->power.states[ACPI_STATE_D3_HOT].flags.explicit_set)
1740                 device->power.states[ACPI_STATE_D3_COLD].flags.explicit_set = 1;
1741 
1742         /* Presence of _PS3 or _PRx means we can put the device into D3 cold */
1743         if (device->power.states[ACPI_STATE_D3_HOT].flags.explicit_set ||
1744                         device->power.flags.power_resources)
1745                 device->power.states[ACPI_STATE_D3_COLD].flags.os_accessible = 1;
1746 
1747         if (acpi_bus_init_power(device))
1748                 device->flags.power_manageable = 0;
1749 }
1750 
1751 static void acpi_bus_get_flags(struct acpi_device *device)
1752 {
1753         /* Presence of _STA indicates 'dynamic_status' */
1754         if (acpi_has_method(device->handle, "_STA"))
1755                 device->flags.dynamic_status = 1;
1756 
1757         /* Presence of _RMV indicates 'removable' */
1758         if (acpi_has_method(device->handle, "_RMV"))
1759                 device->flags.removable = 1;
1760 
1761         /* Presence of _EJD|_EJ0 indicates 'ejectable' */
1762         if (acpi_has_method(device->handle, "_EJD") ||
1763             acpi_has_method(device->handle, "_EJ0"))
1764                 device->flags.ejectable = 1;
1765 }
1766 
1767 static void acpi_device_get_busid(struct acpi_device *device)
1768 {
1769         char bus_id[5] = { '?', 0 };
1770         struct acpi_buffer buffer = { sizeof(bus_id), bus_id };
1771         int i = 0;
1772 
1773         /*
1774          * Bus ID
1775          * ------
1776          * The device's Bus ID is simply the object name.
1777          * TBD: Shouldn't this value be unique (within the ACPI namespace)?
1778          */
1779         if (ACPI_IS_ROOT_DEVICE(device)) {
1780                 strcpy(device->pnp.bus_id, "ACPI");
1781                 return;
1782         }
1783 
1784         switch (device->device_type) {
1785         case ACPI_BUS_TYPE_POWER_BUTTON:
1786                 strcpy(device->pnp.bus_id, "PWRF");
1787                 break;
1788         case ACPI_BUS_TYPE_SLEEP_BUTTON:
1789                 strcpy(device->pnp.bus_id, "SLPF");
1790                 break;
1791         default:
1792                 acpi_get_name(device->handle, ACPI_SINGLE_NAME, &buffer);
1793                 /* Clean up trailing underscores (if any) */
1794                 for (i = 3; i > 1; i--) {
1795                         if (bus_id[i] == '_')
1796                                 bus_id[i] = '\0';
1797                         else
1798                                 break;
1799                 }
1800                 strcpy(device->pnp.bus_id, bus_id);
1801                 break;
1802         }
1803 }
1804 
1805 /*
1806  * acpi_ata_match - see if an acpi object is an ATA device
1807  *
1808  * If an acpi object has one of the ACPI ATA methods defined,
1809  * then we can safely call it an ATA device.
1810  */
1811 bool acpi_ata_match(acpi_handle handle)
1812 {
1813         return acpi_has_method(handle, "_GTF") ||
1814                acpi_has_method(handle, "_GTM") ||
1815                acpi_has_method(handle, "_STM") ||
1816                acpi_has_method(handle, "_SDD");
1817 }
1818 
1819 /*
1820  * acpi_bay_match - see if an acpi object is an ejectable driver bay
1821  *
1822  * If an acpi object is ejectable and has one of the ACPI ATA methods defined,
1823  * then we can safely call it an ejectable drive bay
1824  */
1825 bool acpi_bay_match(acpi_handle handle)
1826 {
1827         acpi_handle phandle;
1828 
1829         if (!acpi_has_method(handle, "_EJ0"))
1830                 return false;
1831         if (acpi_ata_match(handle))
1832                 return true;
1833         if (ACPI_FAILURE(acpi_get_parent(handle, &phandle)))
1834                 return false;
1835 
1836         return acpi_ata_match(phandle);
1837 }
1838 
1839 bool acpi_device_is_battery(struct acpi_device *adev)
1840 {
1841         struct acpi_hardware_id *hwid;
1842 
1843         list_for_each_entry(hwid, &adev->pnp.ids, list)
1844                 if (!strcmp("PNP0C0A", hwid->id))
1845                         return true;
1846 
1847         return false;
1848 }
1849 
1850 static bool is_ejectable_bay(struct acpi_device *adev)
1851 {
1852         acpi_handle handle = adev->handle;
1853 
1854         if (acpi_has_method(handle, "_EJ0") && acpi_device_is_battery(adev))
1855                 return true;
1856 
1857         return acpi_bay_match(handle);
1858 }
1859 
1860 /*
1861  * acpi_dock_match - see if an acpi object has a _DCK method
1862  */
1863 bool acpi_dock_match(acpi_handle handle)
1864 {
1865         return acpi_has_method(handle, "_DCK");
1866 }
1867 
1868 const char *acpi_device_hid(struct acpi_device *device)
1869 {
1870         struct acpi_hardware_id *hid;
1871 
1872         if (list_empty(&device->pnp.ids))
1873                 return dummy_hid;
1874 
1875         hid = list_first_entry(&device->pnp.ids, struct acpi_hardware_id, list);
1876         return hid->id;
1877 }
1878 EXPORT_SYMBOL(acpi_device_hid);
1879 
1880 static void acpi_add_id(struct acpi_device_pnp *pnp, const char *dev_id)
1881 {
1882         struct acpi_hardware_id *id;
1883 
1884         id = kmalloc(sizeof(*id), GFP_KERNEL);
1885         if (!id)
1886                 return;
1887 
1888         id->id = kstrdup(dev_id, GFP_KERNEL);
1889         if (!id->id) {
1890                 kfree(id);
1891                 return;
1892         }
1893 
1894         list_add_tail(&id->list, &pnp->ids);
1895         pnp->type.hardware_id = 1;
1896 }
1897 
1898 /*
1899  * Old IBM workstations have a DSDT bug wherein the SMBus object
1900  * lacks the SMBUS01 HID and the methods do not have the necessary "_"
1901  * prefix.  Work around this.
1902  */
1903 static bool acpi_ibm_smbus_match(acpi_handle handle)
1904 {
1905         char node_name[ACPI_PATH_SEGMENT_LENGTH];
1906         struct acpi_buffer path = { sizeof(node_name), node_name };
1907 
1908         if (!dmi_name_in_vendors("IBM"))
1909                 return false;
1910 
1911         /* Look for SMBS object */
1912         if (ACPI_FAILURE(acpi_get_name(handle, ACPI_SINGLE_NAME, &path)) ||
1913             strcmp("SMBS", path.pointer))
1914                 return false;
1915 
1916         /* Does it have the necessary (but misnamed) methods? */
1917         if (acpi_has_method(handle, "SBI") &&
1918             acpi_has_method(handle, "SBR") &&
1919             acpi_has_method(handle, "SBW"))
1920                 return true;
1921 
1922         return false;
1923 }
1924 
1925 static bool acpi_object_is_system_bus(acpi_handle handle)
1926 {
1927         acpi_handle tmp;
1928 
1929         if (ACPI_SUCCESS(acpi_get_handle(NULL, "\\_SB", &tmp)) &&
1930             tmp == handle)
1931                 return true;
1932         if (ACPI_SUCCESS(acpi_get_handle(NULL, "\\_TZ", &tmp)) &&
1933             tmp == handle)
1934                 return true;
1935 
1936         return false;
1937 }
1938 
1939 static void acpi_set_pnp_ids(acpi_handle handle, struct acpi_device_pnp *pnp,
1940                                 int device_type)
1941 {
1942         acpi_status status;
1943         struct acpi_device_info *info;
1944         struct acpi_pnp_device_id_list *cid_list;
1945         int i;
1946 
1947         switch (device_type) {
1948         case ACPI_BUS_TYPE_DEVICE:
1949                 if (handle == ACPI_ROOT_OBJECT) {
1950                         acpi_add_id(pnp, ACPI_SYSTEM_HID);
1951                         break;
1952                 }
1953 
1954                 status = acpi_get_object_info(handle, &info);
1955                 if (ACPI_FAILURE(status)) {
1956                         pr_err(PREFIX "%s: Error reading device info\n",
1957                                         __func__);
1958                         return;
1959                 }
1960 
1961                 if (info->valid & ACPI_VALID_HID) {
1962                         acpi_add_id(pnp, info->hardware_id.string);
1963                         pnp->type.platform_id = 1;
1964                 }
1965                 if (info->valid & ACPI_VALID_CID) {
1966                         cid_list = &info->compatible_id_list;
1967                         for (i = 0; i < cid_list->count; i++)
1968                                 acpi_add_id(pnp, cid_list->ids[i].string);
1969                 }
1970                 if (info->valid & ACPI_VALID_ADR) {
1971                         pnp->bus_address = info->address;
1972                         pnp->type.bus_address = 1;
1973                 }
1974                 if (info->valid & ACPI_VALID_UID)
1975                         pnp->unique_id = kstrdup(info->unique_id.string,
1976                                                         GFP_KERNEL);
1977 
1978                 kfree(info);
1979 
1980                 /*
1981                  * Some devices don't reliably have _HIDs & _CIDs, so add
1982                  * synthetic HIDs to make sure drivers can find them.
1983                  */
1984                 if (acpi_is_video_device(handle))
1985                         acpi_add_id(pnp, ACPI_VIDEO_HID);
1986                 else if (acpi_bay_match(handle))
1987                         acpi_add_id(pnp, ACPI_BAY_HID);
1988                 else if (acpi_dock_match(handle))
1989                         acpi_add_id(pnp, ACPI_DOCK_HID);
1990                 else if (acpi_ibm_smbus_match(handle))
1991                         acpi_add_id(pnp, ACPI_SMBUS_IBM_HID);
1992                 else if (list_empty(&pnp->ids) &&
1993                          acpi_object_is_system_bus(handle)) {
1994                         /* \_SB, \_TZ, LNXSYBUS */
1995                         acpi_add_id(pnp, ACPI_BUS_HID);
1996                         strcpy(pnp->device_name, ACPI_BUS_DEVICE_NAME);
1997                         strcpy(pnp->device_class, ACPI_BUS_CLASS);
1998                 }
1999 
2000                 break;
2001         case ACPI_BUS_TYPE_POWER:
2002                 acpi_add_id(pnp, ACPI_POWER_HID);
2003                 break;
2004         case ACPI_BUS_TYPE_PROCESSOR:
2005                 acpi_add_id(pnp, ACPI_PROCESSOR_OBJECT_HID);
2006                 break;
2007         case ACPI_BUS_TYPE_THERMAL:
2008                 acpi_add_id(pnp, ACPI_THERMAL_HID);
2009                 break;
2010         case ACPI_BUS_TYPE_POWER_BUTTON:
2011                 acpi_add_id(pnp, ACPI_BUTTON_HID_POWERF);
2012                 break;
2013         case ACPI_BUS_TYPE_SLEEP_BUTTON:
2014                 acpi_add_id(pnp, ACPI_BUTTON_HID_SLEEPF);
2015                 break;
2016         }
2017 }
2018 
2019 void acpi_free_pnp_ids(struct acpi_device_pnp *pnp)
2020 {
2021         struct acpi_hardware_id *id, *tmp;
2022 
2023         list_for_each_entry_safe(id, tmp, &pnp->ids, list) {
2024                 kfree(id->id);
2025                 kfree(id);
2026         }
2027         kfree(pnp->unique_id);
2028 }
2029 
2030 void acpi_init_device_object(struct acpi_device *device, acpi_handle handle,
2031                              int type, unsigned long long sta)
2032 {
2033         INIT_LIST_HEAD(&device->pnp.ids);
2034         device->device_type = type;
2035         device->handle = handle;
2036         device->parent = acpi_bus_get_parent(handle);
2037         device->fwnode.type = FWNODE_ACPI;
2038         acpi_set_device_status(device, sta);
2039         acpi_device_get_busid(device);
2040         acpi_set_pnp_ids(handle, &device->pnp, type);
2041         acpi_init_properties(device);
2042         acpi_bus_get_flags(device);
2043         device->flags.match_driver = false;
2044         device->flags.initialized = true;
2045         device->flags.visited = false;
2046         device_initialize(&device->dev);
2047         dev_set_uevent_suppress(&device->dev, true);
2048 }
2049 
2050 void acpi_device_add_finalize(struct acpi_device *device)
2051 {
2052         dev_set_uevent_suppress(&device->dev, false);
2053         kobject_uevent(&device->dev.kobj, KOBJ_ADD);
2054 }
2055 
2056 static int acpi_add_single_object(struct acpi_device **child,
2057                                   acpi_handle handle, int type,
2058                                   unsigned long long sta)
2059 {
2060         int result;
2061         struct acpi_device *device;
2062         struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
2063 
2064         device = kzalloc(sizeof(struct acpi_device), GFP_KERNEL);
2065         if (!device) {
2066                 printk(KERN_ERR PREFIX "Memory allocation error\n");
2067                 return -ENOMEM;
2068         }
2069 
2070         acpi_init_device_object(device, handle, type, sta);
2071         acpi_bus_get_power_flags(device);
2072         acpi_bus_get_wakeup_device_flags(device);
2073 
2074         result = acpi_device_add(device, acpi_device_release);
2075         if (result) {
2076                 acpi_device_release(&device->dev);
2077                 return result;
2078         }
2079 
2080         acpi_power_add_remove_device(device, true);
2081         acpi_device_add_finalize(device);
2082         acpi_get_name(handle, ACPI_FULL_PATHNAME, &buffer);
2083         ACPI_DEBUG_PRINT((ACPI_DB_INFO, "Added %s [%s] parent %s\n",
2084                 dev_name(&device->dev), (char *) buffer.pointer,
2085                 device->parent ? dev_name(&device->parent->dev) : "(null)"));
2086         kfree(buffer.pointer);
2087         *child = device;
2088         return 0;
2089 }
2090 
2091 static int acpi_bus_type_and_status(acpi_handle handle, int *type,
2092                                     unsigned long long *sta)
2093 {
2094         acpi_status status;
2095         acpi_object_type acpi_type;
2096 
2097         status = acpi_get_type(handle, &acpi_type);
2098         if (ACPI_FAILURE(status))
2099                 return -ENODEV;
2100 
2101         switch (acpi_type) {
2102         case ACPI_TYPE_ANY:             /* for ACPI_ROOT_OBJECT */
2103         case ACPI_TYPE_DEVICE:
2104                 *type = ACPI_BUS_TYPE_DEVICE;
2105                 status = acpi_bus_get_status_handle(handle, sta);
2106                 if (ACPI_FAILURE(status))
2107                         return -ENODEV;
2108                 break;
2109         case ACPI_TYPE_PROCESSOR:
2110                 *type = ACPI_BUS_TYPE_PROCESSOR;
2111                 status = acpi_bus_get_status_handle(handle, sta);
2112                 if (ACPI_FAILURE(status))
2113                         return -ENODEV;
2114                 break;
2115         case ACPI_TYPE_THERMAL:
2116                 *type = ACPI_BUS_TYPE_THERMAL;
2117                 *sta = ACPI_STA_DEFAULT;
2118                 break;
2119         case ACPI_TYPE_POWER:
2120                 *type = ACPI_BUS_TYPE_POWER;
2121                 *sta = ACPI_STA_DEFAULT;
2122                 break;
2123         default:
2124                 return -ENODEV;
2125         }
2126 
2127         return 0;
2128 }
2129 
2130 bool acpi_device_is_present(struct acpi_device *adev)
2131 {
2132         if (adev->status.present || adev->status.functional)
2133                 return true;
2134 
2135         adev->flags.initialized = false;
2136         return false;
2137 }
2138 
2139 static bool acpi_scan_handler_matching(struct acpi_scan_handler *handler,
2140                                        char *idstr,
2141                                        const struct acpi_device_id **matchid)
2142 {
2143         const struct acpi_device_id *devid;
2144 
2145         if (handler->match)
2146                 return handler->match(idstr, matchid);
2147 
2148         for (devid = handler->ids; devid->id[0]; devid++)
2149                 if (!strcmp((char *)devid->id, idstr)) {
2150                         if (matchid)
2151                                 *matchid = devid;
2152 
2153                         return true;
2154                 }
2155 
2156         return false;
2157 }
2158 
2159 static struct acpi_scan_handler *acpi_scan_match_handler(char *idstr,
2160                                         const struct acpi_device_id **matchid)
2161 {
2162         struct acpi_scan_handler *handler;
2163 
2164         list_for_each_entry(handler, &acpi_scan_handlers_list, list_node)
2165                 if (acpi_scan_handler_matching(handler, idstr, matchid))
2166                         return handler;
2167 
2168         return NULL;
2169 }
2170 
2171 void acpi_scan_hotplug_enabled(struct acpi_hotplug_profile *hotplug, bool val)
2172 {
2173         if (!!hotplug->enabled == !!val)
2174                 return;
2175 
2176         mutex_lock(&acpi_scan_lock);
2177 
2178         hotplug->enabled = val;
2179 
2180         mutex_unlock(&acpi_scan_lock);
2181 }
2182 
2183 static void acpi_scan_init_hotplug(struct acpi_device *adev)
2184 {
2185         struct acpi_hardware_id *hwid;
2186 
2187         if (acpi_dock_match(adev->handle) || is_ejectable_bay(adev)) {
2188                 acpi_dock_add(adev);
2189                 return;
2190         }
2191         list_for_each_entry(hwid, &adev->pnp.ids, list) {
2192                 struct acpi_scan_handler *handler;
2193 
2194                 handler = acpi_scan_match_handler(hwid->id, NULL);
2195                 if (handler) {
2196                         adev->flags.hotplug_notify = true;
2197                         break;
2198                 }
2199         }
2200 }
2201 
2202 static void acpi_device_dep_initialize(struct acpi_device *adev)
2203 {
2204         struct acpi_dep_data *dep;
2205         struct acpi_handle_list dep_devices;
2206         acpi_status status;
2207         int i;
2208 
2209         if (!acpi_has_method(adev->handle, "_DEP"))
2210                 return;
2211 
2212         status = acpi_evaluate_reference(adev->handle, "_DEP", NULL,
2213                                         &dep_devices);
2214         if (ACPI_FAILURE(status)) {
2215                 dev_dbg(&adev->dev, "Failed to evaluate _DEP.\n");
2216                 return;
2217         }
2218 
2219         for (i = 0; i < dep_devices.count; i++) {
2220                 struct acpi_device_info *info;
2221                 int skip;
2222 
2223                 status = acpi_get_object_info(dep_devices.handles[i], &info);
2224                 if (ACPI_FAILURE(status)) {
2225                         dev_dbg(&adev->dev, "Error reading _DEP device info\n");
2226                         continue;
2227                 }
2228 
2229                 /*
2230                  * Skip the dependency of Windows System Power
2231                  * Management Controller
2232                  */
2233                 skip = info->valid & ACPI_VALID_HID &&
2234                         !strcmp(info->hardware_id.string, "INT3396");
2235 
2236                 kfree(info);
2237 
2238                 if (skip)
2239                         continue;
2240 
2241                 dep = kzalloc(sizeof(struct acpi_dep_data), GFP_KERNEL);
2242                 if (!dep)
2243                         return;
2244 
2245                 dep->master = dep_devices.handles[i];
2246                 dep->slave  = adev->handle;
2247                 adev->dep_unmet++;
2248 
2249                 mutex_lock(&acpi_dep_list_lock);
2250                 list_add_tail(&dep->node , &acpi_dep_list);
2251                 mutex_unlock(&acpi_dep_list_lock);
2252         }
2253 }
2254 
2255 static acpi_status acpi_bus_check_add(acpi_handle handle, u32 lvl_not_used,
2256                                       void *not_used, void **return_value)
2257 {
2258         struct acpi_device *device = NULL;
2259         int type;
2260         unsigned long long sta;
2261         int result;
2262 
2263         acpi_bus_get_device(handle, &device);
2264         if (device)
2265                 goto out;
2266 
2267         result = acpi_bus_type_and_status(handle, &type, &sta);
2268         if (result)
2269                 return AE_OK;
2270 
2271         if (type == ACPI_BUS_TYPE_POWER) {
2272                 acpi_add_power_resource(handle);
2273                 return AE_OK;
2274         }
2275 
2276         acpi_add_single_object(&device, handle, type, sta);
2277         if (!device)
2278                 return AE_CTRL_DEPTH;
2279 
2280         acpi_scan_init_hotplug(device);
2281         acpi_device_dep_initialize(device);
2282 
2283  out:
2284         if (!*return_value)
2285                 *return_value = device;
2286 
2287         return AE_OK;
2288 }
2289 
2290 static int acpi_check_spi_i2c_slave(struct acpi_resource *ares, void *data)
2291 {
2292         bool *is_spi_i2c_slave_p = data;
2293 
2294         if (ares->type != ACPI_RESOURCE_TYPE_SERIAL_BUS)
2295                 return 1;
2296 
2297         /*
2298          * devices that are connected to UART still need to be enumerated to
2299          * platform bus
2300          */
2301         if (ares->data.common_serial_bus.type != ACPI_RESOURCE_SERIAL_TYPE_UART)
2302                 *is_spi_i2c_slave_p = true;
2303 
2304          /* no need to do more checking */
2305         return -1;
2306 }
2307 
2308 static void acpi_default_enumeration(struct acpi_device *device)
2309 {
2310         struct list_head resource_list;
2311         bool is_spi_i2c_slave = false;
2312 
2313         if (!device->pnp.type.platform_id || device->handler)
2314                 return;
2315 
2316         /*
2317          * Do not enemerate SPI/I2C slaves as they will be enuerated by their
2318          * respective parents.
2319          */
2320         INIT_LIST_HEAD(&resource_list);
2321         acpi_dev_get_resources(device, &resource_list, acpi_check_spi_i2c_slave,
2322                                &is_spi_i2c_slave);
2323         acpi_dev_free_resource_list(&resource_list);
2324         if (!is_spi_i2c_slave)
2325                 acpi_create_platform_device(device);
2326 }
2327 
2328 static int acpi_scan_attach_handler(struct acpi_device *device)
2329 {
2330         struct acpi_hardware_id *hwid;
2331         int ret = 0;
2332 
2333         list_for_each_entry(hwid, &device->pnp.ids, list) {
2334                 const struct acpi_device_id *devid;
2335                 struct acpi_scan_handler *handler;
2336 
2337                 handler = acpi_scan_match_handler(hwid->id, &devid);
2338                 if (handler) {
2339                         if (!handler->attach) {
2340                                 device->pnp.type.platform_id = 0;
2341                                 continue;
2342                         }
2343                         device->handler = handler;
2344                         ret = handler->attach(device, devid);
2345                         if (ret > 0)
2346                                 break;
2347 
2348                         device->handler = NULL;
2349                         if (ret < 0)
2350                                 break;
2351                 }
2352         }
2353         if (!ret)
2354                 acpi_default_enumeration(device);
2355 
2356         return ret;
2357 }
2358 
2359 static void acpi_bus_attach(struct acpi_device *device)
2360 {
2361         struct acpi_device *child;
2362         acpi_handle ejd;
2363         int ret;
2364 
2365         if (ACPI_SUCCESS(acpi_bus_get_ejd(device->handle, &ejd)))
2366                 register_dock_dependent_device(device, ejd);
2367 
2368         acpi_bus_get_status(device);
2369         /* Skip devices that are not present. */
2370         if (!acpi_device_is_present(device)) {
2371                 device->flags.visited = false;
2372                 device->flags.power_manageable = 0;
2373                 return;
2374         }
2375         if (device->handler)
2376                 goto ok;
2377 
2378         if (!device->flags.initialized) {
2379                 device->flags.power_manageable =
2380                         device->power.states[ACPI_STATE_D0].flags.valid;
2381                 if (acpi_bus_init_power(device))
2382                         device->flags.power_manageable = 0;
2383 
2384                 device->flags.initialized = true;
2385         }
2386         device->flags.visited = false;
2387         ret = acpi_scan_attach_handler(device);
2388         if (ret < 0)
2389                 return;
2390 
2391         device->flags.match_driver = true;
2392         if (!ret) {
2393                 ret = device_attach(&device->dev);
2394                 if (ret < 0)
2395                         return;
2396         }
2397         device->flags.visited = true;
2398 
2399  ok:
2400         list_for_each_entry(child, &device->children, node)
2401                 acpi_bus_attach(child);
2402 
2403         if (device->handler && device->handler->hotplug.notify_online)
2404                 device->handler->hotplug.notify_online(device);
2405 }
2406 
2407 void acpi_walk_dep_device_list(acpi_handle handle)
2408 {
2409         struct acpi_dep_data *dep, *tmp;
2410         struct acpi_device *adev;
2411 
2412         mutex_lock(&acpi_dep_list_lock);
2413         list_for_each_entry_safe(dep, tmp, &acpi_dep_list, node) {
2414                 if (dep->master == handle) {
2415                         acpi_bus_get_device(dep->slave, &adev);
2416                         if (!adev)
2417                                 continue;
2418 
2419                         adev->dep_unmet--;
2420                         if (!adev->dep_unmet)
2421                                 acpi_bus_attach(adev);
2422                         list_del(&dep->node);
2423                         kfree(dep);
2424                 }
2425         }
2426         mutex_unlock(&acpi_dep_list_lock);
2427 }
2428 EXPORT_SYMBOL_GPL(acpi_walk_dep_device_list);
2429 
2430 /**
2431  * acpi_bus_scan - Add ACPI device node objects in a given namespace scope.
2432  * @handle: Root of the namespace scope to scan.
2433  *
2434  * Scan a given ACPI tree (probably recently hot-plugged) and create and add
2435  * found devices.
2436  *
2437  * If no devices were found, -ENODEV is returned, but it does not mean that
2438  * there has been a real error.  There just have been no suitable ACPI objects
2439  * in the table trunk from which the kernel could create a device and add an
2440  * appropriate driver.
2441  *
2442  * Must be called under acpi_scan_lock.
2443  */
2444 int acpi_bus_scan(acpi_handle handle)
2445 {
2446         void *device = NULL;
2447 
2448         if (ACPI_SUCCESS(acpi_bus_check_add(handle, 0, NULL, &device)))
2449                 acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
2450                                     acpi_bus_check_add, NULL, NULL, &device);
2451 
2452         if (device) {
2453                 acpi_bus_attach(device);
2454                 return 0;
2455         }
2456         return -ENODEV;
2457 }
2458 EXPORT_SYMBOL(acpi_bus_scan);
2459 
2460 /**
2461  * acpi_bus_trim - Detach scan handlers and drivers from ACPI device objects.
2462  * @adev: Root of the ACPI namespace scope to walk.
2463  *
2464  * Must be called under acpi_scan_lock.
2465  */
2466 void acpi_bus_trim(struct acpi_device *adev)
2467 {
2468         struct acpi_scan_handler *handler = adev->handler;
2469         struct acpi_device *child;
2470 
2471         list_for_each_entry_reverse(child, &adev->children, node)
2472                 acpi_bus_trim(child);
2473 
2474         adev->flags.match_driver = false;
2475         if (handler) {
2476                 if (handler->detach)
2477                         handler->detach(adev);
2478 
2479                 adev->handler = NULL;
2480         } else {
2481                 device_release_driver(&adev->dev);
2482         }
2483         /*
2484          * Most likely, the device is going away, so put it into D3cold before
2485          * that.
2486          */
2487         acpi_device_set_power(adev, ACPI_STATE_D3_COLD);
2488         adev->flags.initialized = false;
2489         adev->flags.visited = false;
2490 }
2491 EXPORT_SYMBOL_GPL(acpi_bus_trim);
2492 
2493 static int acpi_bus_scan_fixed(void)
2494 {
2495         int result = 0;
2496 
2497         /*
2498          * Enumerate all fixed-feature devices.
2499          */
2500         if (!(acpi_gbl_FADT.flags & ACPI_FADT_POWER_BUTTON)) {
2501                 struct acpi_device *device = NULL;
2502 
2503                 result = acpi_add_single_object(&device, NULL,
2504                                                 ACPI_BUS_TYPE_POWER_BUTTON,
2505                                                 ACPI_STA_DEFAULT);
2506                 if (result)
2507                         return result;
2508 
2509                 device->flags.match_driver = true;
2510                 result = device_attach(&device->dev);
2511                 if (result < 0)
2512                         return result;
2513 
2514                 device_init_wakeup(&device->dev, true);
2515         }
2516 
2517         if (!(acpi_gbl_FADT.flags & ACPI_FADT_SLEEP_BUTTON)) {
2518                 struct acpi_device *device = NULL;
2519 
2520                 result = acpi_add_single_object(&device, NULL,
2521                                                 ACPI_BUS_TYPE_SLEEP_BUTTON,
2522                                                 ACPI_STA_DEFAULT);
2523                 if (result)
2524                         return result;
2525 
2526                 device->flags.match_driver = true;
2527                 result = device_attach(&device->dev);
2528         }
2529 
2530         return result < 0 ? result : 0;
2531 }
2532 
2533 int __init acpi_scan_init(void)
2534 {
2535         int result;
2536 
2537         result = bus_register(&acpi_bus_type);
2538         if (result) {
2539                 /* We don't want to quit even if we failed to add suspend/resume */
2540                 printk(KERN_ERR PREFIX "Could not register bus type\n");
2541         }
2542 
2543         acpi_pci_root_init();
2544         acpi_pci_link_init();
2545         acpi_processor_init();
2546         acpi_lpss_init();
2547         acpi_apd_init();
2548         acpi_cmos_rtc_init();
2549         acpi_container_init();
2550         acpi_memory_hotplug_init();
2551         acpi_pnp_init();
2552         acpi_int340x_thermal_init();
2553 
2554         mutex_lock(&acpi_scan_lock);
2555         /*
2556          * Enumerate devices in the ACPI namespace.
2557          */
2558         result = acpi_bus_scan(ACPI_ROOT_OBJECT);
2559         if (result)
2560                 goto out;
2561 
2562         result = acpi_bus_get_device(ACPI_ROOT_OBJECT, &acpi_root);
2563         if (result)
2564                 goto out;
2565 
2566         /* Fixed feature devices do not exist on HW-reduced platform */
2567         if (!acpi_gbl_reduced_hardware) {
2568                 result = acpi_bus_scan_fixed();
2569                 if (result) {
2570                         acpi_detach_data(acpi_root->handle,
2571                                          acpi_scan_drop_device);
2572                         acpi_device_del(acpi_root);
2573                         put_device(&acpi_root->dev);
2574                         goto out;
2575                 }
2576         }
2577 
2578         acpi_update_all_gpes();
2579 
2580  out:
2581         mutex_unlock(&acpi_scan_lock);
2582         return result;
2583 }
2584 

This page was automatically generated by LXR 0.3.1 (source).  •  Linux is a registered trademark of Linus Torvalds  •  Contact us