1 // SPDX-License-Identifier: GPL-2.0-only
3 * scan.c - support for transforming the ACPI namespace into individual objects
6 #define pr_fmt(fmt) "ACPI: " fmt
8 #include <linux/module.h>
9 #include <linux/init.h>
10 #include <linux/slab.h>
11 #include <linux/kernel.h>
12 #include <linux/acpi.h>
13 #include <linux/acpi_iort.h>
14 #include <linux/acpi_viot.h>
15 #include <linux/iommu.h>
16 #include <linux/signal.h>
17 #include <linux/kthread.h>
18 #include <linux/dmi.h>
19 #include <linux/dma-map-ops.h>
20 #include <linux/platform_data/x86/apple.h>
21 #include <linux/pgtable.h>
25 extern struct acpi_device *acpi_root;
27 #define ACPI_BUS_CLASS "system_bus"
28 #define ACPI_BUS_HID "LNXSYBUS"
29 #define ACPI_BUS_DEVICE_NAME "System Bus"
31 #define ACPI_IS_ROOT_DEVICE(device) (!(device)->parent)
33 #define INVALID_ACPI_HANDLE ((acpi_handle)empty_zero_page)
35 static const char *dummy_hid = "device";
37 static LIST_HEAD(acpi_dep_list);
38 static DEFINE_MUTEX(acpi_dep_list_lock);
39 LIST_HEAD(acpi_bus_id_list);
40 static DEFINE_MUTEX(acpi_scan_lock);
41 static LIST_HEAD(acpi_scan_handlers_list);
42 DEFINE_MUTEX(acpi_device_lock);
43 LIST_HEAD(acpi_wakeup_device_list);
44 static DEFINE_MUTEX(acpi_hp_context_lock);
47 * The UART device described by the SPCR table is the only object which needs
48 * special-casing. Everything else is covered by ACPI namespace paths in STAO
51 static u64 spcr_uart_addr;
53 void acpi_scan_lock_acquire(void)
55 mutex_lock(&acpi_scan_lock);
57 EXPORT_SYMBOL_GPL(acpi_scan_lock_acquire);
59 void acpi_scan_lock_release(void)
61 mutex_unlock(&acpi_scan_lock);
63 EXPORT_SYMBOL_GPL(acpi_scan_lock_release);
65 void acpi_lock_hp_context(void)
67 mutex_lock(&acpi_hp_context_lock);
70 void acpi_unlock_hp_context(void)
72 mutex_unlock(&acpi_hp_context_lock);
75 void acpi_initialize_hp_context(struct acpi_device *adev,
76 struct acpi_hotplug_context *hp,
77 int (*notify)(struct acpi_device *, u32),
78 void (*uevent)(struct acpi_device *, u32))
80 acpi_lock_hp_context();
83 acpi_set_hp_context(adev, hp);
84 acpi_unlock_hp_context();
86 EXPORT_SYMBOL_GPL(acpi_initialize_hp_context);
88 int acpi_scan_add_handler(struct acpi_scan_handler *handler)
93 list_add_tail(&handler->list_node, &acpi_scan_handlers_list);
97 int acpi_scan_add_handler_with_hotplug(struct acpi_scan_handler *handler,
98 const char *hotplug_profile_name)
102 error = acpi_scan_add_handler(handler);
106 acpi_sysfs_add_hotplug_profile(&handler->hotplug, hotplug_profile_name);
110 bool acpi_scan_is_offline(struct acpi_device *adev, bool uevent)
112 struct acpi_device_physical_node *pn;
114 char *envp[] = { "EVENT=offline", NULL };
117 * acpi_container_offline() calls this for all of the container's
118 * children under the container's physical_node_lock lock.
120 mutex_lock_nested(&adev->physical_node_lock, SINGLE_DEPTH_NESTING);
122 list_for_each_entry(pn, &adev->physical_node_list, node)
123 if (device_supports_offline(pn->dev) && !pn->dev->offline) {
125 kobject_uevent_env(&pn->dev->kobj, KOBJ_CHANGE, envp);
131 mutex_unlock(&adev->physical_node_lock);
135 static acpi_status acpi_bus_offline(acpi_handle handle, u32 lvl, void *data,
138 struct acpi_device *device = NULL;
139 struct acpi_device_physical_node *pn;
140 bool second_pass = (bool)data;
141 acpi_status status = AE_OK;
143 if (acpi_bus_get_device(handle, &device))
146 if (device->handler && !device->handler->hotplug.enabled) {
147 *ret_p = &device->dev;
151 mutex_lock(&device->physical_node_lock);
153 list_for_each_entry(pn, &device->physical_node_list, node) {
157 /* Skip devices offlined by the first pass. */
161 pn->put_online = false;
163 ret = device_offline(pn->dev);
165 pn->put_online = !ret;
175 mutex_unlock(&device->physical_node_lock);
180 static acpi_status acpi_bus_online(acpi_handle handle, u32 lvl, void *data,
183 struct acpi_device *device = NULL;
184 struct acpi_device_physical_node *pn;
186 if (acpi_bus_get_device(handle, &device))
189 mutex_lock(&device->physical_node_lock);
191 list_for_each_entry(pn, &device->physical_node_list, node)
192 if (pn->put_online) {
193 device_online(pn->dev);
194 pn->put_online = false;
197 mutex_unlock(&device->physical_node_lock);
202 static int acpi_scan_try_to_offline(struct acpi_device *device)
204 acpi_handle handle = device->handle;
205 struct device *errdev = NULL;
209 * Carry out two passes here and ignore errors in the first pass,
210 * because if the devices in question are memory blocks and
211 * CONFIG_MEMCG is set, one of the blocks may hold data structures
212 * that the other blocks depend on, but it is not known in advance which
215 * If the first pass is successful, the second one isn't needed, though.
217 status = acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
218 NULL, acpi_bus_offline, (void *)false,
220 if (status == AE_SUPPORT) {
221 dev_warn(errdev, "Offline disabled.\n");
222 acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
223 acpi_bus_online, NULL, NULL, NULL);
226 acpi_bus_offline(handle, 0, (void *)false, (void **)&errdev);
229 acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
230 NULL, acpi_bus_offline, (void *)true,
233 acpi_bus_offline(handle, 0, (void *)true,
237 dev_warn(errdev, "Offline failed.\n");
238 acpi_bus_online(handle, 0, NULL, NULL);
239 acpi_walk_namespace(ACPI_TYPE_ANY, handle,
240 ACPI_UINT32_MAX, acpi_bus_online,
248 static int acpi_scan_hot_remove(struct acpi_device *device)
250 acpi_handle handle = device->handle;
251 unsigned long long sta;
254 if (device->handler && device->handler->hotplug.demand_offline) {
255 if (!acpi_scan_is_offline(device, true))
258 int error = acpi_scan_try_to_offline(device);
263 acpi_handle_debug(handle, "Ejecting\n");
265 acpi_bus_trim(device);
267 acpi_evaluate_lck(handle, 0);
271 status = acpi_evaluate_ej0(handle);
272 if (status == AE_NOT_FOUND)
274 else if (ACPI_FAILURE(status))
278 * Verify if eject was indeed successful. If not, log an error
279 * message. No need to call _OST since _EJ0 call was made OK.
281 status = acpi_evaluate_integer(handle, "_STA", NULL, &sta);
282 if (ACPI_FAILURE(status)) {
283 acpi_handle_warn(handle,
284 "Status check after eject failed (0x%x)\n", status);
285 } else if (sta & ACPI_STA_DEVICE_ENABLED) {
286 acpi_handle_warn(handle,
287 "Eject incomplete - status 0x%llx\n", sta);
293 static int acpi_scan_device_not_present(struct acpi_device *adev)
295 if (!acpi_device_enumerated(adev)) {
296 dev_warn(&adev->dev, "Still not present\n");
303 static int acpi_scan_device_check(struct acpi_device *adev)
307 acpi_bus_get_status(adev);
308 if (adev->status.present || adev->status.functional) {
310 * This function is only called for device objects for which
311 * matching scan handlers exist. The only situation in which
312 * the scan handler is not attached to this device object yet
313 * is when the device has just appeared (either it wasn't
314 * present at all before or it was removed and then added
318 dev_warn(&adev->dev, "Already enumerated\n");
321 error = acpi_bus_scan(adev->handle);
323 dev_warn(&adev->dev, "Namespace scan failure\n");
326 if (!adev->handler) {
327 dev_warn(&adev->dev, "Enumeration failure\n");
331 error = acpi_scan_device_not_present(adev);
336 static int acpi_scan_bus_check(struct acpi_device *adev)
338 struct acpi_scan_handler *handler = adev->handler;
339 struct acpi_device *child;
342 acpi_bus_get_status(adev);
343 if (!(adev->status.present || adev->status.functional)) {
344 acpi_scan_device_not_present(adev);
347 if (handler && handler->hotplug.scan_dependent)
348 return handler->hotplug.scan_dependent(adev);
350 error = acpi_bus_scan(adev->handle);
352 dev_warn(&adev->dev, "Namespace scan failure\n");
355 list_for_each_entry(child, &adev->children, node) {
356 error = acpi_scan_bus_check(child);
363 static int acpi_generic_hotplug_event(struct acpi_device *adev, u32 type)
366 case ACPI_NOTIFY_BUS_CHECK:
367 return acpi_scan_bus_check(adev);
368 case ACPI_NOTIFY_DEVICE_CHECK:
369 return acpi_scan_device_check(adev);
370 case ACPI_NOTIFY_EJECT_REQUEST:
371 case ACPI_OST_EC_OSPM_EJECT:
372 if (adev->handler && !adev->handler->hotplug.enabled) {
373 dev_info(&adev->dev, "Eject disabled\n");
376 acpi_evaluate_ost(adev->handle, ACPI_NOTIFY_EJECT_REQUEST,
377 ACPI_OST_SC_EJECT_IN_PROGRESS, NULL);
378 return acpi_scan_hot_remove(adev);
383 void acpi_device_hotplug(struct acpi_device *adev, u32 src)
385 u32 ost_code = ACPI_OST_SC_NON_SPECIFIC_FAILURE;
388 lock_device_hotplug();
389 mutex_lock(&acpi_scan_lock);
392 * The device object's ACPI handle cannot become invalid as long as we
393 * are holding acpi_scan_lock, but it might have become invalid before
394 * that lock was acquired.
396 if (adev->handle == INVALID_ACPI_HANDLE)
399 if (adev->flags.is_dock_station) {
400 error = dock_notify(adev, src);
401 } else if (adev->flags.hotplug_notify) {
402 error = acpi_generic_hotplug_event(adev, src);
404 int (*notify)(struct acpi_device *, u32);
406 acpi_lock_hp_context();
407 notify = adev->hp ? adev->hp->notify : NULL;
408 acpi_unlock_hp_context();
410 * There may be additional notify handlers for device objects
411 * without the .event() callback, so ignore them here.
414 error = notify(adev, src);
420 ost_code = ACPI_OST_SC_SUCCESS;
423 ost_code = ACPI_OST_SC_EJECT_NOT_SUPPORTED;
426 ost_code = ACPI_OST_SC_DEVICE_BUSY;
429 ost_code = ACPI_OST_SC_NON_SPECIFIC_FAILURE;
434 acpi_evaluate_ost(adev->handle, src, ost_code, NULL);
437 acpi_bus_put_acpi_device(adev);
438 mutex_unlock(&acpi_scan_lock);
439 unlock_device_hotplug();
442 static void acpi_free_power_resources_lists(struct acpi_device *device)
446 if (device->wakeup.flags.valid)
447 acpi_power_resources_list_free(&device->wakeup.resources);
449 if (!device->power.flags.power_resources)
452 for (i = ACPI_STATE_D0; i <= ACPI_STATE_D3_HOT; i++) {
453 struct acpi_device_power_state *ps = &device->power.states[i];
454 acpi_power_resources_list_free(&ps->resources);
458 static void acpi_device_release(struct device *dev)
460 struct acpi_device *acpi_dev = to_acpi_device(dev);
462 acpi_free_properties(acpi_dev);
463 acpi_free_pnp_ids(&acpi_dev->pnp);
464 acpi_free_power_resources_lists(acpi_dev);
468 static void acpi_device_del(struct acpi_device *device)
470 struct acpi_device_bus_id *acpi_device_bus_id;
472 mutex_lock(&acpi_device_lock);
474 list_del(&device->node);
476 list_for_each_entry(acpi_device_bus_id, &acpi_bus_id_list, node)
477 if (!strcmp(acpi_device_bus_id->bus_id,
478 acpi_device_hid(device))) {
479 ida_simple_remove(&acpi_device_bus_id->instance_ida, device->pnp.instance_no);
480 if (ida_is_empty(&acpi_device_bus_id->instance_ida)) {
481 list_del(&acpi_device_bus_id->node);
482 kfree_const(acpi_device_bus_id->bus_id);
483 kfree(acpi_device_bus_id);
488 list_del(&device->wakeup_list);
489 mutex_unlock(&acpi_device_lock);
491 acpi_power_add_remove_device(device, false);
492 acpi_device_remove_files(device);
494 device->remove(device);
496 device_del(&device->dev);
499 static BLOCKING_NOTIFIER_HEAD(acpi_reconfig_chain);
501 static LIST_HEAD(acpi_device_del_list);
502 static DEFINE_MUTEX(acpi_device_del_lock);
504 static void acpi_device_del_work_fn(struct work_struct *work_not_used)
507 struct acpi_device *adev;
509 mutex_lock(&acpi_device_del_lock);
511 if (list_empty(&acpi_device_del_list)) {
512 mutex_unlock(&acpi_device_del_lock);
515 adev = list_first_entry(&acpi_device_del_list,
516 struct acpi_device, del_list);
517 list_del(&adev->del_list);
519 mutex_unlock(&acpi_device_del_lock);
521 blocking_notifier_call_chain(&acpi_reconfig_chain,
522 ACPI_RECONFIG_DEVICE_REMOVE, adev);
524 acpi_device_del(adev);
526 * Drop references to all power resources that might have been
527 * used by the device.
529 acpi_power_transition(adev, ACPI_STATE_D3_COLD);
535 * acpi_scan_drop_device - Drop an ACPI device object.
536 * @handle: Handle of an ACPI namespace node, not used.
537 * @context: Address of the ACPI device object to drop.
539 * This is invoked by acpi_ns_delete_node() during the removal of the ACPI
540 * namespace node the device object pointed to by @context is attached to.
542 * The unregistration is carried out asynchronously to avoid running
543 * acpi_device_del() under the ACPICA's namespace mutex and the list is used to
544 * ensure the correct ordering (the device objects must be unregistered in the
545 * same order in which the corresponding namespace nodes are deleted).
547 static void acpi_scan_drop_device(acpi_handle handle, void *context)
549 static DECLARE_WORK(work, acpi_device_del_work_fn);
550 struct acpi_device *adev = context;
552 mutex_lock(&acpi_device_del_lock);
555 * Use the ACPI hotplug workqueue which is ordered, so this work item
556 * won't run after any hotplug work items submitted subsequently. That
557 * prevents attempts to register device objects identical to those being
558 * deleted from happening concurrently (such attempts result from
559 * hotplug events handled via the ACPI hotplug workqueue). It also will
560 * run after all of the work items submitted previously, which helps
561 * those work items to ensure that they are not accessing stale device
564 if (list_empty(&acpi_device_del_list))
565 acpi_queue_hotplug_work(&work);
567 list_add_tail(&adev->del_list, &acpi_device_del_list);
568 /* Make acpi_ns_validate_handle() return NULL for this handle. */
569 adev->handle = INVALID_ACPI_HANDLE;
571 mutex_unlock(&acpi_device_del_lock);
574 static struct acpi_device *handle_to_device(acpi_handle handle,
575 void (*callback)(void *))
577 struct acpi_device *adev = NULL;
580 status = acpi_get_data_full(handle, acpi_scan_drop_device,
581 (void **)&adev, callback);
582 if (ACPI_FAILURE(status) || !adev) {
583 acpi_handle_debug(handle, "No context!\n");
589 int acpi_bus_get_device(acpi_handle handle, struct acpi_device **device)
594 *device = handle_to_device(handle, NULL);
600 EXPORT_SYMBOL(acpi_bus_get_device);
602 static void get_acpi_device(void *dev)
607 struct acpi_device *acpi_bus_get_acpi_device(acpi_handle handle)
609 return handle_to_device(handle, get_acpi_device);
612 static struct acpi_device_bus_id *acpi_device_bus_id_match(const char *dev_id)
614 struct acpi_device_bus_id *acpi_device_bus_id;
616 /* Find suitable bus_id and instance number in acpi_bus_id_list. */
617 list_for_each_entry(acpi_device_bus_id, &acpi_bus_id_list, node) {
618 if (!strcmp(acpi_device_bus_id->bus_id, dev_id))
619 return acpi_device_bus_id;
624 static int acpi_device_set_name(struct acpi_device *device,
625 struct acpi_device_bus_id *acpi_device_bus_id)
627 struct ida *instance_ida = &acpi_device_bus_id->instance_ida;
630 result = ida_simple_get(instance_ida, 0, ACPI_MAX_DEVICE_INSTANCES, GFP_KERNEL);
634 device->pnp.instance_no = result;
635 dev_set_name(&device->dev, "%s:%02x", acpi_device_bus_id->bus_id, result);
639 static int acpi_tie_acpi_dev(struct acpi_device *adev)
641 acpi_handle handle = adev->handle;
647 status = acpi_attach_data(handle, acpi_scan_drop_device, adev);
648 if (ACPI_FAILURE(status)) {
649 acpi_handle_err(handle, "Unable to attach device data\n");
656 static int __acpi_device_add(struct acpi_device *device,
657 void (*release)(struct device *))
659 struct acpi_device_bus_id *acpi_device_bus_id;
665 * Link this device to its parent and siblings.
667 INIT_LIST_HEAD(&device->children);
668 INIT_LIST_HEAD(&device->node);
669 INIT_LIST_HEAD(&device->wakeup_list);
670 INIT_LIST_HEAD(&device->physical_node_list);
671 INIT_LIST_HEAD(&device->del_list);
672 mutex_init(&device->physical_node_lock);
674 mutex_lock(&acpi_device_lock);
676 acpi_device_bus_id = acpi_device_bus_id_match(acpi_device_hid(device));
677 if (acpi_device_bus_id) {
678 result = acpi_device_set_name(device, acpi_device_bus_id);
682 acpi_device_bus_id = kzalloc(sizeof(*acpi_device_bus_id),
684 if (!acpi_device_bus_id) {
688 acpi_device_bus_id->bus_id =
689 kstrdup_const(acpi_device_hid(device), GFP_KERNEL);
690 if (!acpi_device_bus_id->bus_id) {
691 kfree(acpi_device_bus_id);
696 ida_init(&acpi_device_bus_id->instance_ida);
698 result = acpi_device_set_name(device, acpi_device_bus_id);
700 kfree_const(acpi_device_bus_id->bus_id);
701 kfree(acpi_device_bus_id);
705 list_add_tail(&acpi_device_bus_id->node, &acpi_bus_id_list);
709 list_add_tail(&device->node, &device->parent->children);
711 if (device->wakeup.flags.valid)
712 list_add_tail(&device->wakeup_list, &acpi_wakeup_device_list);
714 mutex_unlock(&acpi_device_lock);
717 device->dev.parent = &device->parent->dev;
719 device->dev.bus = &acpi_bus_type;
720 device->dev.release = release;
721 result = device_add(&device->dev);
723 dev_err(&device->dev, "Error registering device\n");
727 result = acpi_device_setup_files(device);
729 pr_err("Error creating sysfs interface for device %s\n",
730 dev_name(&device->dev));
735 mutex_lock(&acpi_device_lock);
738 list_del(&device->node);
740 list_del(&device->wakeup_list);
743 mutex_unlock(&acpi_device_lock);
745 acpi_detach_data(device->handle, acpi_scan_drop_device);
750 int acpi_device_add(struct acpi_device *adev, void (*release)(struct device *))
754 ret = acpi_tie_acpi_dev(adev);
758 return __acpi_device_add(adev, release);
761 /* --------------------------------------------------------------------------
763 -------------------------------------------------------------------------- */
764 static bool acpi_info_matches_ids(struct acpi_device_info *info,
765 const char * const ids[])
767 struct acpi_pnp_device_id_list *cid_list = NULL;
770 if (!(info->valid & ACPI_VALID_HID))
773 index = match_string(ids, -1, info->hardware_id.string);
777 if (info->valid & ACPI_VALID_CID)
778 cid_list = &info->compatible_id_list;
783 for (i = 0; i < cid_list->count; i++) {
784 index = match_string(ids, -1, cid_list->ids[i].string);
792 /* List of HIDs for which we ignore matching ACPI devices, when checking _DEP lists. */
793 static const char * const acpi_ignore_dep_ids[] = {
794 "PNP0D80", /* Windows-compatible System Power Management Controller */
795 "INT33BD", /* Intel Baytrail Mailbox Device */
799 static struct acpi_device *acpi_bus_get_parent(acpi_handle handle)
801 struct acpi_device *device = NULL;
805 * Fixed hardware devices do not appear in the namespace and do not
806 * have handles, but we fabricate acpi_devices for them, so we have
807 * to deal with them specially.
813 status = acpi_get_parent(handle, &handle);
814 if (ACPI_FAILURE(status))
815 return status == AE_NULL_ENTRY ? NULL : acpi_root;
816 } while (acpi_bus_get_device(handle, &device));
821 acpi_bus_get_ejd(acpi_handle handle, acpi_handle *ejd)
825 struct acpi_buffer buffer = {ACPI_ALLOCATE_BUFFER, NULL};
826 union acpi_object *obj;
828 status = acpi_get_handle(handle, "_EJD", &tmp);
829 if (ACPI_FAILURE(status))
832 status = acpi_evaluate_object(handle, "_EJD", NULL, &buffer);
833 if (ACPI_SUCCESS(status)) {
834 obj = buffer.pointer;
835 status = acpi_get_handle(ACPI_ROOT_OBJECT, obj->string.pointer,
837 kfree(buffer.pointer);
841 EXPORT_SYMBOL_GPL(acpi_bus_get_ejd);
843 static int acpi_bus_extract_wakeup_device_power_package(struct acpi_device *dev)
845 acpi_handle handle = dev->handle;
846 struct acpi_device_wakeup *wakeup = &dev->wakeup;
847 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
848 union acpi_object *package = NULL;
849 union acpi_object *element = NULL;
853 INIT_LIST_HEAD(&wakeup->resources);
856 status = acpi_evaluate_object(handle, "_PRW", NULL, &buffer);
857 if (ACPI_FAILURE(status)) {
858 acpi_handle_info(handle, "_PRW evaluation failed: %s\n",
859 acpi_format_exception(status));
863 package = (union acpi_object *)buffer.pointer;
865 if (!package || package->package.count < 2)
868 element = &(package->package.elements[0]);
872 if (element->type == ACPI_TYPE_PACKAGE) {
873 if ((element->package.count < 2) ||
874 (element->package.elements[0].type !=
875 ACPI_TYPE_LOCAL_REFERENCE)
876 || (element->package.elements[1].type != ACPI_TYPE_INTEGER))
880 element->package.elements[0].reference.handle;
882 (u32) element->package.elements[1].integer.value;
883 } else if (element->type == ACPI_TYPE_INTEGER) {
884 wakeup->gpe_device = NULL;
885 wakeup->gpe_number = element->integer.value;
890 element = &(package->package.elements[1]);
891 if (element->type != ACPI_TYPE_INTEGER)
894 wakeup->sleep_state = element->integer.value;
896 err = acpi_extract_power_resources(package, 2, &wakeup->resources);
900 if (!list_empty(&wakeup->resources)) {
903 err = acpi_power_wakeup_list_init(&wakeup->resources,
906 acpi_handle_warn(handle, "Retrieving current states "
907 "of wakeup power resources failed\n");
908 acpi_power_resources_list_free(&wakeup->resources);
911 if (sleep_state < wakeup->sleep_state) {
912 acpi_handle_warn(handle, "Overriding _PRW sleep state "
913 "(S%d) by S%d from power resources\n",
914 (int)wakeup->sleep_state, sleep_state);
915 wakeup->sleep_state = sleep_state;
920 kfree(buffer.pointer);
924 static bool acpi_wakeup_gpe_init(struct acpi_device *device)
926 static const struct acpi_device_id button_device_ids[] = {
927 {"PNP0C0C", 0}, /* Power button */
928 {"PNP0C0D", 0}, /* Lid */
929 {"PNP0C0E", 0}, /* Sleep button */
932 struct acpi_device_wakeup *wakeup = &device->wakeup;
935 wakeup->flags.notifier_present = 0;
937 /* Power button, Lid switch always enable wakeup */
938 if (!acpi_match_device_ids(device, button_device_ids)) {
939 if (!acpi_match_device_ids(device, &button_device_ids[1])) {
940 /* Do not use Lid/sleep button for S5 wakeup */
941 if (wakeup->sleep_state == ACPI_STATE_S5)
942 wakeup->sleep_state = ACPI_STATE_S4;
944 acpi_mark_gpe_for_wake(wakeup->gpe_device, wakeup->gpe_number);
945 device_set_wakeup_capable(&device->dev, true);
949 status = acpi_setup_gpe_for_wake(device->handle, wakeup->gpe_device,
951 return ACPI_SUCCESS(status);
954 static void acpi_bus_get_wakeup_device_flags(struct acpi_device *device)
958 /* Presence of _PRW indicates wake capable */
959 if (!acpi_has_method(device->handle, "_PRW"))
962 err = acpi_bus_extract_wakeup_device_power_package(device);
964 dev_err(&device->dev, "Unable to extract wakeup power resources");
968 device->wakeup.flags.valid = acpi_wakeup_gpe_init(device);
969 device->wakeup.prepare_count = 0;
971 * Call _PSW/_DSW object to disable its ability to wake the sleeping
972 * system for the ACPI device with the _PRW object.
973 * The _PSW object is deprecated in ACPI 3.0 and is replaced by _DSW.
974 * So it is necessary to call _DSW object first. Only when it is not
975 * present will the _PSW object used.
977 err = acpi_device_sleep_wake(device, 0, 0, 0);
979 pr_debug("error in _DSW or _PSW evaluation\n");
982 static void acpi_bus_init_power_state(struct acpi_device *device, int state)
984 struct acpi_device_power_state *ps = &device->power.states[state];
985 char pathname[5] = { '_', 'P', 'R', '0' + state, '\0' };
986 struct acpi_buffer buffer = { ACPI_ALLOCATE_BUFFER, NULL };
989 INIT_LIST_HEAD(&ps->resources);
991 /* Evaluate "_PRx" to get referenced power resources */
992 status = acpi_evaluate_object(device->handle, pathname, NULL, &buffer);
993 if (ACPI_SUCCESS(status)) {
994 union acpi_object *package = buffer.pointer;
996 if (buffer.length && package
997 && package->type == ACPI_TYPE_PACKAGE
998 && package->package.count)
999 acpi_extract_power_resources(package, 0, &ps->resources);
1001 ACPI_FREE(buffer.pointer);
1004 /* Evaluate "_PSx" to see if we can do explicit sets */
1006 if (acpi_has_method(device->handle, pathname))
1007 ps->flags.explicit_set = 1;
1009 /* State is valid if there are means to put the device into it. */
1010 if (!list_empty(&ps->resources) || ps->flags.explicit_set)
1011 ps->flags.valid = 1;
1013 ps->power = -1; /* Unknown - driver assigned */
1014 ps->latency = -1; /* Unknown - driver assigned */
1017 static void acpi_bus_get_power_flags(struct acpi_device *device)
1021 /* Presence of _PS0|_PR0 indicates 'power manageable' */
1022 if (!acpi_has_method(device->handle, "_PS0") &&
1023 !acpi_has_method(device->handle, "_PR0"))
1026 device->flags.power_manageable = 1;
1029 * Power Management Flags
1031 if (acpi_has_method(device->handle, "_PSC"))
1032 device->power.flags.explicit_get = 1;
1034 if (acpi_has_method(device->handle, "_IRC"))
1035 device->power.flags.inrush_current = 1;
1037 if (acpi_has_method(device->handle, "_DSW"))
1038 device->power.flags.dsw_present = 1;
1041 * Enumerate supported power management states
1043 for (i = ACPI_STATE_D0; i <= ACPI_STATE_D3_HOT; i++)
1044 acpi_bus_init_power_state(device, i);
1046 INIT_LIST_HEAD(&device->power.states[ACPI_STATE_D3_COLD].resources);
1048 /* Set the defaults for D0 and D3hot (always supported). */
1049 device->power.states[ACPI_STATE_D0].flags.valid = 1;
1050 device->power.states[ACPI_STATE_D0].power = 100;
1051 device->power.states[ACPI_STATE_D3_HOT].flags.valid = 1;
1054 * Use power resources only if the D0 list of them is populated, because
1055 * some platforms may provide _PR3 only to indicate D3cold support and
1056 * in those cases the power resources list returned by it may be bogus.
1058 if (!list_empty(&device->power.states[ACPI_STATE_D0].resources)) {
1059 device->power.flags.power_resources = 1;
1061 * D3cold is supported if the D3hot list of power resources is
1064 if (!list_empty(&device->power.states[ACPI_STATE_D3_HOT].resources))
1065 device->power.states[ACPI_STATE_D3_COLD].flags.valid = 1;
1068 if (acpi_bus_init_power(device))
1069 device->flags.power_manageable = 0;
1072 static void acpi_bus_get_flags(struct acpi_device *device)
1074 /* Presence of _STA indicates 'dynamic_status' */
1075 if (acpi_has_method(device->handle, "_STA"))
1076 device->flags.dynamic_status = 1;
1078 /* Presence of _RMV indicates 'removable' */
1079 if (acpi_has_method(device->handle, "_RMV"))
1080 device->flags.removable = 1;
1082 /* Presence of _EJD|_EJ0 indicates 'ejectable' */
1083 if (acpi_has_method(device->handle, "_EJD") ||
1084 acpi_has_method(device->handle, "_EJ0"))
1085 device->flags.ejectable = 1;
1088 static void acpi_device_get_busid(struct acpi_device *device)
1090 char bus_id[5] = { '?', 0 };
1091 struct acpi_buffer buffer = { sizeof(bus_id), bus_id };
1097 * The device's Bus ID is simply the object name.
1098 * TBD: Shouldn't this value be unique (within the ACPI namespace)?
1100 if (ACPI_IS_ROOT_DEVICE(device)) {
1101 strcpy(device->pnp.bus_id, "ACPI");
1105 switch (device->device_type) {
1106 case ACPI_BUS_TYPE_POWER_BUTTON:
1107 strcpy(device->pnp.bus_id, "PWRF");
1109 case ACPI_BUS_TYPE_SLEEP_BUTTON:
1110 strcpy(device->pnp.bus_id, "SLPF");
1112 case ACPI_BUS_TYPE_ECDT_EC:
1113 strcpy(device->pnp.bus_id, "ECDT");
1116 acpi_get_name(device->handle, ACPI_SINGLE_NAME, &buffer);
1117 /* Clean up trailing underscores (if any) */
1118 for (i = 3; i > 1; i--) {
1119 if (bus_id[i] == '_')
1124 strcpy(device->pnp.bus_id, bus_id);
1130 * acpi_ata_match - see if an acpi object is an ATA device
1132 * If an acpi object has one of the ACPI ATA methods defined,
1133 * then we can safely call it an ATA device.
1135 bool acpi_ata_match(acpi_handle handle)
1137 return acpi_has_method(handle, "_GTF") ||
1138 acpi_has_method(handle, "_GTM") ||
1139 acpi_has_method(handle, "_STM") ||
1140 acpi_has_method(handle, "_SDD");
1144 * acpi_bay_match - see if an acpi object is an ejectable driver bay
1146 * If an acpi object is ejectable and has one of the ACPI ATA methods defined,
1147 * then we can safely call it an ejectable drive bay
1149 bool acpi_bay_match(acpi_handle handle)
1151 acpi_handle phandle;
1153 if (!acpi_has_method(handle, "_EJ0"))
1155 if (acpi_ata_match(handle))
1157 if (ACPI_FAILURE(acpi_get_parent(handle, &phandle)))
1160 return acpi_ata_match(phandle);
1163 bool acpi_device_is_battery(struct acpi_device *adev)
1165 struct acpi_hardware_id *hwid;
1167 list_for_each_entry(hwid, &adev->pnp.ids, list)
1168 if (!strcmp("PNP0C0A", hwid->id))
1174 static bool is_ejectable_bay(struct acpi_device *adev)
1176 acpi_handle handle = adev->handle;
1178 if (acpi_has_method(handle, "_EJ0") && acpi_device_is_battery(adev))
1181 return acpi_bay_match(handle);
1185 * acpi_dock_match - see if an acpi object has a _DCK method
1187 bool acpi_dock_match(acpi_handle handle)
1189 return acpi_has_method(handle, "_DCK");
1193 acpi_backlight_cap_match(acpi_handle handle, u32 level, void *context,
1194 void **return_value)
1196 long *cap = context;
1198 if (acpi_has_method(handle, "_BCM") &&
1199 acpi_has_method(handle, "_BCL")) {
1200 acpi_handle_debug(handle, "Found generic backlight support\n");
1201 *cap |= ACPI_VIDEO_BACKLIGHT;
1202 /* We have backlight support, no need to scan further */
1203 return AE_CTRL_TERMINATE;
1208 /* Returns true if the ACPI object is a video device which can be
1209 * handled by video.ko.
1210 * The device will get a Linux specific CID added in scan.c to
1211 * identify the device as an ACPI graphics device
1212 * Be aware that the graphics device may not be physically present
1213 * Use acpi_video_get_capabilities() to detect general ACPI video
1214 * capabilities of present cards
1216 long acpi_is_video_device(acpi_handle handle)
1218 long video_caps = 0;
1220 /* Is this device able to support video switching ? */
1221 if (acpi_has_method(handle, "_DOD") || acpi_has_method(handle, "_DOS"))
1222 video_caps |= ACPI_VIDEO_OUTPUT_SWITCHING;
1224 /* Is this device able to retrieve a video ROM ? */
1225 if (acpi_has_method(handle, "_ROM"))
1226 video_caps |= ACPI_VIDEO_ROM_AVAILABLE;
1228 /* Is this device able to configure which video head to be POSTed ? */
1229 if (acpi_has_method(handle, "_VPO") &&
1230 acpi_has_method(handle, "_GPD") &&
1231 acpi_has_method(handle, "_SPD"))
1232 video_caps |= ACPI_VIDEO_DEVICE_POSTING;
1234 /* Only check for backlight functionality if one of the above hit. */
1236 acpi_walk_namespace(ACPI_TYPE_DEVICE, handle,
1237 ACPI_UINT32_MAX, acpi_backlight_cap_match, NULL,
1242 EXPORT_SYMBOL(acpi_is_video_device);
1244 const char *acpi_device_hid(struct acpi_device *device)
1246 struct acpi_hardware_id *hid;
1248 if (list_empty(&device->pnp.ids))
1251 hid = list_first_entry(&device->pnp.ids, struct acpi_hardware_id, list);
1254 EXPORT_SYMBOL(acpi_device_hid);
1256 static void acpi_add_id(struct acpi_device_pnp *pnp, const char *dev_id)
1258 struct acpi_hardware_id *id;
1260 id = kmalloc(sizeof(*id), GFP_KERNEL);
1264 id->id = kstrdup_const(dev_id, GFP_KERNEL);
1270 list_add_tail(&id->list, &pnp->ids);
1271 pnp->type.hardware_id = 1;
1275 * Old IBM workstations have a DSDT bug wherein the SMBus object
1276 * lacks the SMBUS01 HID and the methods do not have the necessary "_"
1277 * prefix. Work around this.
1279 static bool acpi_ibm_smbus_match(acpi_handle handle)
1281 char node_name[ACPI_PATH_SEGMENT_LENGTH];
1282 struct acpi_buffer path = { sizeof(node_name), node_name };
1284 if (!dmi_name_in_vendors("IBM"))
1287 /* Look for SMBS object */
1288 if (ACPI_FAILURE(acpi_get_name(handle, ACPI_SINGLE_NAME, &path)) ||
1289 strcmp("SMBS", path.pointer))
1292 /* Does it have the necessary (but misnamed) methods? */
1293 if (acpi_has_method(handle, "SBI") &&
1294 acpi_has_method(handle, "SBR") &&
1295 acpi_has_method(handle, "SBW"))
1301 static bool acpi_object_is_system_bus(acpi_handle handle)
1305 if (ACPI_SUCCESS(acpi_get_handle(NULL, "\\_SB", &tmp)) &&
1308 if (ACPI_SUCCESS(acpi_get_handle(NULL, "\\_TZ", &tmp)) &&
1315 static void acpi_set_pnp_ids(acpi_handle handle, struct acpi_device_pnp *pnp,
1318 struct acpi_device_info *info = NULL;
1319 struct acpi_pnp_device_id_list *cid_list;
1322 switch (device_type) {
1323 case ACPI_BUS_TYPE_DEVICE:
1324 if (handle == ACPI_ROOT_OBJECT) {
1325 acpi_add_id(pnp, ACPI_SYSTEM_HID);
1329 acpi_get_object_info(handle, &info);
1331 pr_err("%s: Error reading device info\n", __func__);
1335 if (info->valid & ACPI_VALID_HID) {
1336 acpi_add_id(pnp, info->hardware_id.string);
1337 pnp->type.platform_id = 1;
1339 if (info->valid & ACPI_VALID_CID) {
1340 cid_list = &info->compatible_id_list;
1341 for (i = 0; i < cid_list->count; i++)
1342 acpi_add_id(pnp, cid_list->ids[i].string);
1344 if (info->valid & ACPI_VALID_ADR) {
1345 pnp->bus_address = info->address;
1346 pnp->type.bus_address = 1;
1348 if (info->valid & ACPI_VALID_UID)
1349 pnp->unique_id = kstrdup(info->unique_id.string,
1351 if (info->valid & ACPI_VALID_CLS)
1352 acpi_add_id(pnp, info->class_code.string);
1357 * Some devices don't reliably have _HIDs & _CIDs, so add
1358 * synthetic HIDs to make sure drivers can find them.
1360 if (acpi_is_video_device(handle))
1361 acpi_add_id(pnp, ACPI_VIDEO_HID);
1362 else if (acpi_bay_match(handle))
1363 acpi_add_id(pnp, ACPI_BAY_HID);
1364 else if (acpi_dock_match(handle))
1365 acpi_add_id(pnp, ACPI_DOCK_HID);
1366 else if (acpi_ibm_smbus_match(handle))
1367 acpi_add_id(pnp, ACPI_SMBUS_IBM_HID);
1368 else if (list_empty(&pnp->ids) &&
1369 acpi_object_is_system_bus(handle)) {
1370 /* \_SB, \_TZ, LNXSYBUS */
1371 acpi_add_id(pnp, ACPI_BUS_HID);
1372 strcpy(pnp->device_name, ACPI_BUS_DEVICE_NAME);
1373 strcpy(pnp->device_class, ACPI_BUS_CLASS);
1377 case ACPI_BUS_TYPE_POWER:
1378 acpi_add_id(pnp, ACPI_POWER_HID);
1380 case ACPI_BUS_TYPE_PROCESSOR:
1381 acpi_add_id(pnp, ACPI_PROCESSOR_OBJECT_HID);
1383 case ACPI_BUS_TYPE_THERMAL:
1384 acpi_add_id(pnp, ACPI_THERMAL_HID);
1386 case ACPI_BUS_TYPE_POWER_BUTTON:
1387 acpi_add_id(pnp, ACPI_BUTTON_HID_POWERF);
1389 case ACPI_BUS_TYPE_SLEEP_BUTTON:
1390 acpi_add_id(pnp, ACPI_BUTTON_HID_SLEEPF);
1392 case ACPI_BUS_TYPE_ECDT_EC:
1393 acpi_add_id(pnp, ACPI_ECDT_HID);
1398 void acpi_free_pnp_ids(struct acpi_device_pnp *pnp)
1400 struct acpi_hardware_id *id, *tmp;
1402 list_for_each_entry_safe(id, tmp, &pnp->ids, list) {
1403 kfree_const(id->id);
1406 kfree(pnp->unique_id);
1410 * acpi_dma_supported - Check DMA support for the specified device.
1411 * @adev: The pointer to acpi device
1413 * Return false if DMA is not supported. Otherwise, return true
1415 bool acpi_dma_supported(const struct acpi_device *adev)
1420 if (adev->flags.cca_seen)
1424 * Per ACPI 6.0 sec 6.2.17, assume devices can do cache-coherent
1425 * DMA on "Intel platforms". Presumably that includes all x86 and
1426 * ia64, and other arches will set CONFIG_ACPI_CCA_REQUIRED=y.
1428 if (!IS_ENABLED(CONFIG_ACPI_CCA_REQUIRED))
1435 * acpi_get_dma_attr - Check the supported DMA attr for the specified device.
1436 * @adev: The pointer to acpi device
1438 * Return enum dev_dma_attr.
1440 enum dev_dma_attr acpi_get_dma_attr(struct acpi_device *adev)
1442 if (!acpi_dma_supported(adev))
1443 return DEV_DMA_NOT_SUPPORTED;
1445 if (adev->flags.coherent_dma)
1446 return DEV_DMA_COHERENT;
1448 return DEV_DMA_NON_COHERENT;
1452 * acpi_dma_get_range() - Get device DMA parameters.
1454 * @dev: device to configure
1455 * @dma_addr: pointer device DMA address result
1456 * @offset: pointer to the DMA offset result
1457 * @size: pointer to DMA range size result
1459 * Evaluate DMA regions and return respectively DMA region start, offset
1460 * and size in dma_addr, offset and size on parsing success; it does not
1461 * update the passed in values on failure.
1463 * Return 0 on success, < 0 on failure.
1465 int acpi_dma_get_range(struct device *dev, u64 *dma_addr, u64 *offset,
1468 struct acpi_device *adev;
1470 struct resource_entry *rentry;
1472 struct device *dma_dev = dev;
1473 u64 len, dma_start = U64_MAX, dma_end = 0, dma_offset = 0;
1476 * Walk the device tree chasing an ACPI companion with a _DMA
1477 * object while we go. Stop if we find a device with an ACPI
1478 * companion containing a _DMA method.
1481 adev = ACPI_COMPANION(dma_dev);
1482 if (adev && acpi_has_method(adev->handle, METHOD_NAME__DMA))
1485 dma_dev = dma_dev->parent;
1491 if (!acpi_has_method(adev->handle, METHOD_NAME__CRS)) {
1492 acpi_handle_warn(adev->handle, "_DMA is valid only if _CRS is present\n");
1496 ret = acpi_dev_get_dma_resources(adev, &list);
1498 list_for_each_entry(rentry, &list, node) {
1499 if (dma_offset && rentry->offset != dma_offset) {
1501 dev_warn(dma_dev, "Can't handle multiple windows with different offsets\n");
1504 dma_offset = rentry->offset;
1506 /* Take lower and upper limits */
1507 if (rentry->res->start < dma_start)
1508 dma_start = rentry->res->start;
1509 if (rentry->res->end > dma_end)
1510 dma_end = rentry->res->end;
1513 if (dma_start >= dma_end) {
1515 dev_dbg(dma_dev, "Invalid DMA regions configuration\n");
1519 *dma_addr = dma_start - dma_offset;
1520 len = dma_end - dma_start;
1521 *size = max(len, len + 1);
1522 *offset = dma_offset;
1525 acpi_dev_free_resource_list(&list);
1527 return ret >= 0 ? 0 : ret;
1530 #ifdef CONFIG_IOMMU_API
1531 int acpi_iommu_fwspec_init(struct device *dev, u32 id,
1532 struct fwnode_handle *fwnode,
1533 const struct iommu_ops *ops)
1535 int ret = iommu_fwspec_init(dev, fwnode, ops);
1538 ret = iommu_fwspec_add_ids(dev, &id, 1);
1543 static inline const struct iommu_ops *acpi_iommu_fwspec_ops(struct device *dev)
1545 struct iommu_fwspec *fwspec = dev_iommu_fwspec_get(dev);
1547 return fwspec ? fwspec->ops : NULL;
1550 static const struct iommu_ops *acpi_iommu_configure_id(struct device *dev,
1554 const struct iommu_ops *ops;
1557 * If we already translated the fwspec there is nothing left to do,
1558 * return the iommu_ops.
1560 ops = acpi_iommu_fwspec_ops(dev);
1564 err = iort_iommu_configure_id(dev, id_in);
1565 if (err && err != -EPROBE_DEFER)
1566 err = viot_iommu_configure(dev);
1569 * If we have reason to believe the IOMMU driver missed the initial
1570 * iommu_probe_device() call for dev, replay it to get things in order.
1572 if (!err && dev->bus && !device_iommu_mapped(dev))
1573 err = iommu_probe_device(dev);
1575 /* Ignore all other errors apart from EPROBE_DEFER */
1576 if (err == -EPROBE_DEFER) {
1577 return ERR_PTR(err);
1579 dev_dbg(dev, "Adding to IOMMU failed: %d\n", err);
1582 return acpi_iommu_fwspec_ops(dev);
1585 #else /* !CONFIG_IOMMU_API */
1587 int acpi_iommu_fwspec_init(struct device *dev, u32 id,
1588 struct fwnode_handle *fwnode,
1589 const struct iommu_ops *ops)
1594 static const struct iommu_ops *acpi_iommu_configure_id(struct device *dev,
1600 #endif /* !CONFIG_IOMMU_API */
1603 * acpi_dma_configure_id - Set-up DMA configuration for the device.
1604 * @dev: The pointer to the device
1605 * @attr: device dma attributes
1606 * @input_id: input device id const value pointer
1608 int acpi_dma_configure_id(struct device *dev, enum dev_dma_attr attr,
1609 const u32 *input_id)
1611 const struct iommu_ops *iommu;
1612 u64 dma_addr = 0, size = 0;
1614 if (attr == DEV_DMA_NOT_SUPPORTED) {
1615 set_dma_ops(dev, &dma_dummy_ops);
1619 acpi_arch_dma_setup(dev, &dma_addr, &size);
1621 iommu = acpi_iommu_configure_id(dev, input_id);
1622 if (PTR_ERR(iommu) == -EPROBE_DEFER)
1623 return -EPROBE_DEFER;
1625 arch_setup_dma_ops(dev, dma_addr, size,
1626 iommu, attr == DEV_DMA_COHERENT);
1630 EXPORT_SYMBOL_GPL(acpi_dma_configure_id);
1632 static void acpi_init_coherency(struct acpi_device *adev)
1634 unsigned long long cca = 0;
1636 struct acpi_device *parent = adev->parent;
1638 if (parent && parent->flags.cca_seen) {
1640 * From ACPI spec, OSPM will ignore _CCA if an ancestor
1643 adev->flags.cca_seen = 1;
1644 cca = parent->flags.coherent_dma;
1646 status = acpi_evaluate_integer(adev->handle, "_CCA",
1648 if (ACPI_SUCCESS(status))
1649 adev->flags.cca_seen = 1;
1650 else if (!IS_ENABLED(CONFIG_ACPI_CCA_REQUIRED))
1652 * If architecture does not specify that _CCA is
1653 * required for DMA-able devices (e.g. x86),
1654 * we default to _CCA=1.
1658 acpi_handle_debug(adev->handle,
1659 "ACPI device is missing _CCA.\n");
1662 adev->flags.coherent_dma = cca;
1665 static int acpi_check_serial_bus_slave(struct acpi_resource *ares, void *data)
1667 bool *is_serial_bus_slave_p = data;
1669 if (ares->type != ACPI_RESOURCE_TYPE_SERIAL_BUS)
1672 *is_serial_bus_slave_p = true;
1674 /* no need to do more checking */
1678 static bool acpi_is_indirect_io_slave(struct acpi_device *device)
1680 struct acpi_device *parent = device->parent;
1681 static const struct acpi_device_id indirect_io_hosts[] = {
1686 return parent && !acpi_match_device_ids(parent, indirect_io_hosts);
1689 static bool acpi_device_enumeration_by_parent(struct acpi_device *device)
1691 struct list_head resource_list;
1692 bool is_serial_bus_slave = false;
1694 * These devices have multiple I2cSerialBus resources and an i2c-client
1695 * must be instantiated for each, each with its own i2c_device_id.
1696 * Normally we only instantiate an i2c-client for the first resource,
1697 * using the ACPI HID as id. These special cases are handled by the
1698 * drivers/platform/x86/i2c-multi-instantiate.c driver, which knows
1699 * which i2c_device_id to use for each resource.
1701 static const struct acpi_device_id i2c_multi_instantiate_ids[] = {
1709 if (acpi_is_indirect_io_slave(device))
1712 /* Macs use device properties in lieu of _CRS resources */
1713 if (x86_apple_machine &&
1714 (fwnode_property_present(&device->fwnode, "spiSclkPeriod") ||
1715 fwnode_property_present(&device->fwnode, "i2cAddress") ||
1716 fwnode_property_present(&device->fwnode, "baud")))
1719 /* Instantiate a pdev for the i2c-multi-instantiate drv to bind to */
1720 if (!acpi_match_device_ids(device, i2c_multi_instantiate_ids))
1723 INIT_LIST_HEAD(&resource_list);
1724 acpi_dev_get_resources(device, &resource_list,
1725 acpi_check_serial_bus_slave,
1726 &is_serial_bus_slave);
1727 acpi_dev_free_resource_list(&resource_list);
1729 return is_serial_bus_slave;
1732 void acpi_init_device_object(struct acpi_device *device, acpi_handle handle,
1735 INIT_LIST_HEAD(&device->pnp.ids);
1736 device->device_type = type;
1737 device->handle = handle;
1738 device->parent = acpi_bus_get_parent(handle);
1739 fwnode_init(&device->fwnode, &acpi_device_fwnode_ops);
1740 acpi_set_device_status(device, ACPI_STA_DEFAULT);
1741 acpi_device_get_busid(device);
1742 acpi_set_pnp_ids(handle, &device->pnp, type);
1743 acpi_init_properties(device);
1744 acpi_bus_get_flags(device);
1745 device->flags.match_driver = false;
1746 device->flags.initialized = true;
1747 device->flags.enumeration_by_parent =
1748 acpi_device_enumeration_by_parent(device);
1749 acpi_device_clear_enumerated(device);
1750 device_initialize(&device->dev);
1751 dev_set_uevent_suppress(&device->dev, true);
1752 acpi_init_coherency(device);
1755 static void acpi_scan_dep_init(struct acpi_device *adev)
1757 struct acpi_dep_data *dep;
1759 list_for_each_entry(dep, &acpi_dep_list, node) {
1760 if (dep->consumer == adev->handle)
1765 void acpi_device_add_finalize(struct acpi_device *device)
1767 dev_set_uevent_suppress(&device->dev, false);
1768 kobject_uevent(&device->dev.kobj, KOBJ_ADD);
1771 static void acpi_scan_init_status(struct acpi_device *adev)
1773 if (acpi_bus_get_status(adev))
1774 acpi_set_device_status(adev, 0);
1777 static int acpi_add_single_object(struct acpi_device **child,
1778 acpi_handle handle, int type, bool dep_init)
1780 struct acpi_device *device;
1781 bool release_dep_lock = false;
1784 device = kzalloc(sizeof(struct acpi_device), GFP_KERNEL);
1788 acpi_init_device_object(device, handle, type);
1790 * Getting the status is delayed till here so that we can call
1791 * acpi_bus_get_status() and use its quirk handling. Note that
1792 * this must be done before the get power-/wakeup_dev-flags calls.
1794 if (type == ACPI_BUS_TYPE_DEVICE || type == ACPI_BUS_TYPE_PROCESSOR) {
1796 mutex_lock(&acpi_dep_list_lock);
1798 * Hold the lock until the acpi_tie_acpi_dev() call
1799 * below to prevent concurrent acpi_scan_clear_dep()
1800 * from deleting a dependency list entry without
1801 * updating dep_unmet for the device.
1803 release_dep_lock = true;
1804 acpi_scan_dep_init(device);
1806 acpi_scan_init_status(device);
1809 acpi_bus_get_power_flags(device);
1810 acpi_bus_get_wakeup_device_flags(device);
1812 result = acpi_tie_acpi_dev(device);
1814 if (release_dep_lock)
1815 mutex_unlock(&acpi_dep_list_lock);
1818 result = __acpi_device_add(device, acpi_device_release);
1821 acpi_device_release(&device->dev);
1825 acpi_power_add_remove_device(device, true);
1826 acpi_device_add_finalize(device);
1828 acpi_handle_debug(handle, "Added as %s, parent %s\n",
1829 dev_name(&device->dev), device->parent ?
1830 dev_name(&device->parent->dev) : "(null)");
1836 static acpi_status acpi_get_resource_memory(struct acpi_resource *ares,
1839 struct resource *res = context;
1841 if (acpi_dev_resource_memory(ares, res))
1842 return AE_CTRL_TERMINATE;
1847 static bool acpi_device_should_be_hidden(acpi_handle handle)
1850 struct resource res;
1852 /* Check if it should ignore the UART device */
1853 if (!(spcr_uart_addr && acpi_has_method(handle, METHOD_NAME__CRS)))
1857 * The UART device described in SPCR table is assumed to have only one
1858 * memory resource present. So we only look for the first one here.
1860 status = acpi_walk_resources(handle, METHOD_NAME__CRS,
1861 acpi_get_resource_memory, &res);
1862 if (ACPI_FAILURE(status) || res.start != spcr_uart_addr)
1865 acpi_handle_info(handle, "The UART device @%pa in SPCR table will be hidden\n",
1871 bool acpi_device_is_present(const struct acpi_device *adev)
1873 return adev->status.present || adev->status.functional;
1876 static bool acpi_scan_handler_matching(struct acpi_scan_handler *handler,
1878 const struct acpi_device_id **matchid)
1880 const struct acpi_device_id *devid;
1883 return handler->match(idstr, matchid);
1885 for (devid = handler->ids; devid->id[0]; devid++)
1886 if (!strcmp((char *)devid->id, idstr)) {
1896 static struct acpi_scan_handler *acpi_scan_match_handler(const char *idstr,
1897 const struct acpi_device_id **matchid)
1899 struct acpi_scan_handler *handler;
1901 list_for_each_entry(handler, &acpi_scan_handlers_list, list_node)
1902 if (acpi_scan_handler_matching(handler, idstr, matchid))
1908 void acpi_scan_hotplug_enabled(struct acpi_hotplug_profile *hotplug, bool val)
1910 if (!!hotplug->enabled == !!val)
1913 mutex_lock(&acpi_scan_lock);
1915 hotplug->enabled = val;
1917 mutex_unlock(&acpi_scan_lock);
1920 static void acpi_scan_init_hotplug(struct acpi_device *adev)
1922 struct acpi_hardware_id *hwid;
1924 if (acpi_dock_match(adev->handle) || is_ejectable_bay(adev)) {
1925 acpi_dock_add(adev);
1928 list_for_each_entry(hwid, &adev->pnp.ids, list) {
1929 struct acpi_scan_handler *handler;
1931 handler = acpi_scan_match_handler(hwid->id, NULL);
1933 adev->flags.hotplug_notify = true;
1939 static u32 acpi_scan_check_dep(acpi_handle handle, bool check_dep)
1941 struct acpi_handle_list dep_devices;
1947 * Check for _HID here to avoid deferring the enumeration of:
1949 * 2. ACPI nodes describing USB ports.
1950 * Still, checking for _HID catches more then just these cases ...
1952 if (!check_dep || !acpi_has_method(handle, "_DEP") ||
1953 !acpi_has_method(handle, "_HID"))
1956 status = acpi_evaluate_reference(handle, "_DEP", NULL, &dep_devices);
1957 if (ACPI_FAILURE(status)) {
1958 acpi_handle_debug(handle, "Failed to evaluate _DEP.\n");
1962 for (count = 0, i = 0; i < dep_devices.count; i++) {
1963 struct acpi_device_info *info;
1964 struct acpi_dep_data *dep;
1967 status = acpi_get_object_info(dep_devices.handles[i], &info);
1968 if (ACPI_FAILURE(status)) {
1969 acpi_handle_debug(handle, "Error reading _DEP device info\n");
1973 skip = acpi_info_matches_ids(info, acpi_ignore_dep_ids);
1979 dep = kzalloc(sizeof(*dep), GFP_KERNEL);
1985 dep->supplier = dep_devices.handles[i];
1986 dep->consumer = handle;
1988 mutex_lock(&acpi_dep_list_lock);
1989 list_add_tail(&dep->node , &acpi_dep_list);
1990 mutex_unlock(&acpi_dep_list_lock);
1996 static bool acpi_bus_scan_second_pass;
1998 static acpi_status acpi_bus_check_add(acpi_handle handle, bool check_dep,
1999 struct acpi_device **adev_p)
2001 struct acpi_device *device = NULL;
2002 acpi_object_type acpi_type;
2005 acpi_bus_get_device(handle, &device);
2009 if (ACPI_FAILURE(acpi_get_type(handle, &acpi_type)))
2012 switch (acpi_type) {
2013 case ACPI_TYPE_DEVICE:
2014 if (acpi_device_should_be_hidden(handle))
2017 /* Bail out if there are dependencies. */
2018 if (acpi_scan_check_dep(handle, check_dep) > 0) {
2019 acpi_bus_scan_second_pass = true;
2020 return AE_CTRL_DEPTH;
2024 case ACPI_TYPE_ANY: /* for ACPI_ROOT_OBJECT */
2025 type = ACPI_BUS_TYPE_DEVICE;
2028 case ACPI_TYPE_PROCESSOR:
2029 type = ACPI_BUS_TYPE_PROCESSOR;
2032 case ACPI_TYPE_THERMAL:
2033 type = ACPI_BUS_TYPE_THERMAL;
2036 case ACPI_TYPE_POWER:
2037 acpi_add_power_resource(handle);
2044 * If check_dep is true at this point, the device has no dependencies,
2045 * or the creation of the device object would have been postponed above.
2047 acpi_add_single_object(&device, handle, type, !check_dep);
2049 return AE_CTRL_DEPTH;
2051 acpi_scan_init_hotplug(device);
2060 static acpi_status acpi_bus_check_add_1(acpi_handle handle, u32 lvl_not_used,
2061 void *not_used, void **ret_p)
2063 return acpi_bus_check_add(handle, true, (struct acpi_device **)ret_p);
2066 static acpi_status acpi_bus_check_add_2(acpi_handle handle, u32 lvl_not_used,
2067 void *not_used, void **ret_p)
2069 return acpi_bus_check_add(handle, false, (struct acpi_device **)ret_p);
2072 static void acpi_default_enumeration(struct acpi_device *device)
2075 * Do not enumerate devices with enumeration_by_parent flag set as
2076 * they will be enumerated by their respective parents.
2078 if (!device->flags.enumeration_by_parent) {
2079 acpi_create_platform_device(device, NULL);
2080 acpi_device_set_enumerated(device);
2082 blocking_notifier_call_chain(&acpi_reconfig_chain,
2083 ACPI_RECONFIG_DEVICE_ADD, device);
2087 static const struct acpi_device_id generic_device_ids[] = {
2088 {ACPI_DT_NAMESPACE_HID, },
2092 static int acpi_generic_device_attach(struct acpi_device *adev,
2093 const struct acpi_device_id *not_used)
2096 * Since ACPI_DT_NAMESPACE_HID is the only ID handled here, the test
2097 * below can be unconditional.
2099 if (adev->data.of_compatible)
2100 acpi_default_enumeration(adev);
2105 static struct acpi_scan_handler generic_device_handler = {
2106 .ids = generic_device_ids,
2107 .attach = acpi_generic_device_attach,
2110 static int acpi_scan_attach_handler(struct acpi_device *device)
2112 struct acpi_hardware_id *hwid;
2115 list_for_each_entry(hwid, &device->pnp.ids, list) {
2116 const struct acpi_device_id *devid;
2117 struct acpi_scan_handler *handler;
2119 handler = acpi_scan_match_handler(hwid->id, &devid);
2121 if (!handler->attach) {
2122 device->pnp.type.platform_id = 0;
2125 device->handler = handler;
2126 ret = handler->attach(device, devid);
2130 device->handler = NULL;
2139 static void acpi_bus_attach(struct acpi_device *device, bool first_pass)
2141 struct acpi_device *child;
2142 bool skip = !first_pass && device->flags.visited;
2149 if (ACPI_SUCCESS(acpi_bus_get_ejd(device->handle, &ejd)))
2150 register_dock_dependent_device(device, ejd);
2152 acpi_bus_get_status(device);
2153 /* Skip devices that are not present. */
2154 if (!acpi_device_is_present(device)) {
2155 device->flags.initialized = false;
2156 acpi_device_clear_enumerated(device);
2157 device->flags.power_manageable = 0;
2160 if (device->handler)
2163 if (!device->flags.initialized) {
2164 device->flags.power_manageable =
2165 device->power.states[ACPI_STATE_D0].flags.valid;
2166 if (acpi_bus_init_power(device))
2167 device->flags.power_manageable = 0;
2169 device->flags.initialized = true;
2170 } else if (device->flags.visited) {
2174 ret = acpi_scan_attach_handler(device);
2178 device->flags.match_driver = true;
2179 if (ret > 0 && !device->flags.enumeration_by_parent) {
2180 acpi_device_set_enumerated(device);
2184 ret = device_attach(&device->dev);
2188 if (device->pnp.type.platform_id || device->flags.enumeration_by_parent)
2189 acpi_default_enumeration(device);
2191 acpi_device_set_enumerated(device);
2194 list_for_each_entry(child, &device->children, node)
2195 acpi_bus_attach(child, first_pass);
2197 if (!skip && device->handler && device->handler->hotplug.notify_online)
2198 device->handler->hotplug.notify_online(device);
2201 static int acpi_dev_get_first_consumer_dev_cb(struct acpi_dep_data *dep, void *data)
2203 struct acpi_device *adev;
2205 adev = acpi_bus_get_acpi_device(dep->consumer);
2207 *(struct acpi_device **)data = adev;
2210 /* Continue parsing if the device object is not present. */
2214 struct acpi_scan_clear_dep_work {
2215 struct work_struct work;
2216 struct acpi_device *adev;
2219 static void acpi_scan_clear_dep_fn(struct work_struct *work)
2221 struct acpi_scan_clear_dep_work *cdw;
2223 cdw = container_of(work, struct acpi_scan_clear_dep_work, work);
2225 acpi_scan_lock_acquire();
2226 acpi_bus_attach(cdw->adev, true);
2227 acpi_scan_lock_release();
2229 acpi_dev_put(cdw->adev);
2233 static bool acpi_scan_clear_dep_queue(struct acpi_device *adev)
2235 struct acpi_scan_clear_dep_work *cdw;
2237 if (adev->dep_unmet)
2240 cdw = kmalloc(sizeof(*cdw), GFP_KERNEL);
2245 INIT_WORK(&cdw->work, acpi_scan_clear_dep_fn);
2247 * Since the work function may block on the lock until the entire
2248 * initial enumeration of devices is complete, put it into the unbound
2251 queue_work(system_unbound_wq, &cdw->work);
2256 static int acpi_scan_clear_dep(struct acpi_dep_data *dep, void *data)
2258 struct acpi_device *adev = acpi_bus_get_acpi_device(dep->consumer);
2262 if (!acpi_scan_clear_dep_queue(adev))
2266 list_del(&dep->node);
2273 * acpi_walk_dep_device_list - Apply a callback to every entry in acpi_dep_list
2274 * @handle: The ACPI handle of the supplier device
2275 * @callback: Pointer to the callback function to apply
2276 * @data: Pointer to some data to pass to the callback
2278 * The return value of the callback determines this function's behaviour. If 0
2279 * is returned we continue to iterate over acpi_dep_list. If a positive value
2280 * is returned then the loop is broken but this function returns 0. If a
2281 * negative value is returned by the callback then the loop is broken and that
2282 * value is returned as the final error.
2284 static int acpi_walk_dep_device_list(acpi_handle handle,
2285 int (*callback)(struct acpi_dep_data *, void *),
2288 struct acpi_dep_data *dep, *tmp;
2291 mutex_lock(&acpi_dep_list_lock);
2292 list_for_each_entry_safe(dep, tmp, &acpi_dep_list, node) {
2293 if (dep->supplier == handle) {
2294 ret = callback(dep, data);
2299 mutex_unlock(&acpi_dep_list_lock);
2301 return ret > 0 ? 0 : ret;
2305 * acpi_dev_clear_dependencies - Inform consumers that the device is now active
2306 * @supplier: Pointer to the supplier &struct acpi_device
2308 * Clear dependencies on the given device.
2310 void acpi_dev_clear_dependencies(struct acpi_device *supplier)
2312 acpi_walk_dep_device_list(supplier->handle, acpi_scan_clear_dep, NULL);
2314 EXPORT_SYMBOL_GPL(acpi_dev_clear_dependencies);
2317 * acpi_dev_get_first_consumer_dev - Return ACPI device dependent on @supplier
2318 * @supplier: Pointer to the dependee device
2320 * Returns the first &struct acpi_device which declares itself dependent on
2321 * @supplier via the _DEP buffer, parsed from the acpi_dep_list.
2323 * The caller is responsible for putting the reference to adev when it is no
2326 struct acpi_device *acpi_dev_get_first_consumer_dev(struct acpi_device *supplier)
2328 struct acpi_device *adev = NULL;
2330 acpi_walk_dep_device_list(supplier->handle,
2331 acpi_dev_get_first_consumer_dev_cb, &adev);
2335 EXPORT_SYMBOL_GPL(acpi_dev_get_first_consumer_dev);
2338 * acpi_bus_scan - Add ACPI device node objects in a given namespace scope.
2339 * @handle: Root of the namespace scope to scan.
2341 * Scan a given ACPI tree (probably recently hot-plugged) and create and add
2344 * If no devices were found, -ENODEV is returned, but it does not mean that
2345 * there has been a real error. There just have been no suitable ACPI objects
2346 * in the table trunk from which the kernel could create a device and add an
2347 * appropriate driver.
2349 * Must be called under acpi_scan_lock.
2351 int acpi_bus_scan(acpi_handle handle)
2353 struct acpi_device *device = NULL;
2355 acpi_bus_scan_second_pass = false;
2357 /* Pass 1: Avoid enumerating devices with missing dependencies. */
2359 if (ACPI_SUCCESS(acpi_bus_check_add(handle, true, &device)))
2360 acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
2361 acpi_bus_check_add_1, NULL, NULL,
2367 acpi_bus_attach(device, true);
2369 if (!acpi_bus_scan_second_pass)
2372 /* Pass 2: Enumerate all of the remaining devices. */
2376 if (ACPI_SUCCESS(acpi_bus_check_add(handle, false, &device)))
2377 acpi_walk_namespace(ACPI_TYPE_ANY, handle, ACPI_UINT32_MAX,
2378 acpi_bus_check_add_2, NULL, NULL,
2381 acpi_bus_attach(device, false);
2385 EXPORT_SYMBOL(acpi_bus_scan);
2388 * acpi_bus_trim - Detach scan handlers and drivers from ACPI device objects.
2389 * @adev: Root of the ACPI namespace scope to walk.
2391 * Must be called under acpi_scan_lock.
2393 void acpi_bus_trim(struct acpi_device *adev)
2395 struct acpi_scan_handler *handler = adev->handler;
2396 struct acpi_device *child;
2398 list_for_each_entry_reverse(child, &adev->children, node)
2399 acpi_bus_trim(child);
2401 adev->flags.match_driver = false;
2403 if (handler->detach)
2404 handler->detach(adev);
2406 adev->handler = NULL;
2408 device_release_driver(&adev->dev);
2411 * Most likely, the device is going away, so put it into D3cold before
2414 acpi_device_set_power(adev, ACPI_STATE_D3_COLD);
2415 adev->flags.initialized = false;
2416 acpi_device_clear_enumerated(adev);
2418 EXPORT_SYMBOL_GPL(acpi_bus_trim);
2420 int acpi_bus_register_early_device(int type)
2422 struct acpi_device *device = NULL;
2425 result = acpi_add_single_object(&device, NULL, type, false);
2429 device->flags.match_driver = true;
2430 return device_attach(&device->dev);
2432 EXPORT_SYMBOL_GPL(acpi_bus_register_early_device);
2434 static int acpi_bus_scan_fixed(void)
2439 * Enumerate all fixed-feature devices.
2441 if (!(acpi_gbl_FADT.flags & ACPI_FADT_POWER_BUTTON)) {
2442 struct acpi_device *device = NULL;
2444 result = acpi_add_single_object(&device, NULL,
2445 ACPI_BUS_TYPE_POWER_BUTTON, false);
2449 device->flags.match_driver = true;
2450 result = device_attach(&device->dev);
2454 device_init_wakeup(&device->dev, true);
2457 if (!(acpi_gbl_FADT.flags & ACPI_FADT_SLEEP_BUTTON)) {
2458 struct acpi_device *device = NULL;
2460 result = acpi_add_single_object(&device, NULL,
2461 ACPI_BUS_TYPE_SLEEP_BUTTON, false);
2465 device->flags.match_driver = true;
2466 result = device_attach(&device->dev);
2469 return result < 0 ? result : 0;
2472 static void __init acpi_get_spcr_uart_addr(void)
2475 struct acpi_table_spcr *spcr_ptr;
2477 status = acpi_get_table(ACPI_SIG_SPCR, 0,
2478 (struct acpi_table_header **)&spcr_ptr);
2479 if (ACPI_FAILURE(status)) {
2480 pr_warn("STAO table present, but SPCR is missing\n");
2484 spcr_uart_addr = spcr_ptr->serial_port.address;
2485 acpi_put_table((struct acpi_table_header *)spcr_ptr);
2488 static bool acpi_scan_initialized;
2490 int __init acpi_scan_init(void)
2494 struct acpi_table_stao *stao_ptr;
2496 acpi_pci_root_init();
2497 acpi_pci_link_init();
2498 acpi_processor_init();
2499 acpi_platform_init();
2502 acpi_cmos_rtc_init();
2503 acpi_container_init();
2504 acpi_memory_hotplug_init();
2505 acpi_watchdog_init();
2507 acpi_int340x_thermal_init();
2511 acpi_scan_add_handler(&generic_device_handler);
2514 * If there is STAO table, check whether it needs to ignore the UART
2515 * device in SPCR table.
2517 status = acpi_get_table(ACPI_SIG_STAO, 0,
2518 (struct acpi_table_header **)&stao_ptr);
2519 if (ACPI_SUCCESS(status)) {
2520 if (stao_ptr->header.length > sizeof(struct acpi_table_stao))
2521 pr_info("STAO Name List not yet supported.\n");
2523 if (stao_ptr->ignore_uart)
2524 acpi_get_spcr_uart_addr();
2526 acpi_put_table((struct acpi_table_header *)stao_ptr);
2529 acpi_gpe_apply_masked_gpes();
2530 acpi_update_all_gpes();
2533 * Although we call __add_memory() that is documented to require the
2534 * device_hotplug_lock, it is not necessary here because this is an
2535 * early code when userspace or any other code path cannot trigger
2536 * hotplug/hotunplug operations.
2538 mutex_lock(&acpi_scan_lock);
2540 * Enumerate devices in the ACPI namespace.
2542 result = acpi_bus_scan(ACPI_ROOT_OBJECT);
2546 result = acpi_bus_get_device(ACPI_ROOT_OBJECT, &acpi_root);
2550 /* Fixed feature devices do not exist on HW-reduced platform */
2551 if (!acpi_gbl_reduced_hardware) {
2552 result = acpi_bus_scan_fixed();
2554 acpi_detach_data(acpi_root->handle,
2555 acpi_scan_drop_device);
2556 acpi_device_del(acpi_root);
2557 acpi_bus_put_acpi_device(acpi_root);
2562 acpi_turn_off_unused_power_resources();
2564 acpi_scan_initialized = true;
2567 mutex_unlock(&acpi_scan_lock);
2571 static struct acpi_probe_entry *ape;
2572 static int acpi_probe_count;
2573 static DEFINE_MUTEX(acpi_probe_mutex);
2575 static int __init acpi_match_madt(union acpi_subtable_headers *header,
2576 const unsigned long end)
2578 if (!ape->subtable_valid || ape->subtable_valid(&header->common, ape))
2579 if (!ape->probe_subtbl(header, end))
2585 int __init __acpi_probe_device_table(struct acpi_probe_entry *ap_head, int nr)
2592 mutex_lock(&acpi_probe_mutex);
2593 for (ape = ap_head; nr; ape++, nr--) {
2594 if (ACPI_COMPARE_NAMESEG(ACPI_SIG_MADT, ape->id)) {
2595 acpi_probe_count = 0;
2596 acpi_table_parse_madt(ape->type, acpi_match_madt, 0);
2597 count += acpi_probe_count;
2600 res = acpi_table_parse(ape->id, ape->probe_table);
2605 mutex_unlock(&acpi_probe_mutex);
2610 static void acpi_table_events_fn(struct work_struct *work)
2612 acpi_scan_lock_acquire();
2613 acpi_bus_scan(ACPI_ROOT_OBJECT);
2614 acpi_scan_lock_release();
2619 void acpi_scan_table_notify(void)
2621 struct work_struct *work;
2623 if (!acpi_scan_initialized)
2626 work = kmalloc(sizeof(*work), GFP_KERNEL);
2630 INIT_WORK(work, acpi_table_events_fn);
2631 schedule_work(work);
2634 int acpi_reconfig_notifier_register(struct notifier_block *nb)
2636 return blocking_notifier_chain_register(&acpi_reconfig_chain, nb);
2638 EXPORT_SYMBOL(acpi_reconfig_notifier_register);
2640 int acpi_reconfig_notifier_unregister(struct notifier_block *nb)
2642 return blocking_notifier_chain_unregister(&acpi_reconfig_chain, nb);
2644 EXPORT_SYMBOL(acpi_reconfig_notifier_unregister);