1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * acpi_osl.c - OS-dependent functions ($Revision: 83 $)
5 * Copyright (C) 2000 Andrew Henroid
6 * Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com>
7 * Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
8 * Copyright (c) 2008 Intel Corporation
9 * Author: Matthew Wilcox <willy@linux.intel.com>
12 #include <linux/module.h>
13 #include <linux/kernel.h>
14 #include <linux/slab.h>
16 #include <linux/highmem.h>
17 #include <linux/lockdep.h>
18 #include <linux/pci.h>
19 #include <linux/interrupt.h>
20 #include <linux/kmod.h>
21 #include <linux/delay.h>
22 #include <linux/workqueue.h>
23 #include <linux/nmi.h>
24 #include <linux/acpi.h>
25 #include <linux/efi.h>
26 #include <linux/ioport.h>
27 #include <linux/list.h>
28 #include <linux/jiffies.h>
29 #include <linux/semaphore.h>
32 #include <linux/uaccess.h>
33 #include <linux/io-64-nonatomic-lo-hi.h>
35 #include "acpica/accommon.h"
36 #include "acpica/acnamesp.h"
39 #define _COMPONENT ACPI_OS_SERVICES
40 ACPI_MODULE_NAME("osl");
43 acpi_osd_exec_callback function;
45 struct work_struct work;
48 #ifdef ENABLE_DEBUGGER
49 #include <linux/kdb.h>
51 /* stuff for debugger support */
53 EXPORT_SYMBOL(acpi_in_debugger);
54 #endif /*ENABLE_DEBUGGER */
56 static int (*__acpi_os_prepare_sleep)(u8 sleep_state, u32 pm1a_ctrl,
58 static int (*__acpi_os_prepare_extended_sleep)(u8 sleep_state, u32 val_a,
61 static acpi_osd_handler acpi_irq_handler;
62 static void *acpi_irq_context;
63 static struct workqueue_struct *kacpid_wq;
64 static struct workqueue_struct *kacpi_notify_wq;
65 static struct workqueue_struct *kacpi_hotplug_wq;
66 static bool acpi_os_initialized;
67 unsigned int acpi_sci_irq = INVALID_ACPI_IRQ;
68 bool acpi_permanent_mmap = false;
71 * This list of permanent mappings is for memory that may be accessed from
72 * interrupt context, where we can't do the ioremap().
75 struct list_head list;
77 acpi_physical_address phys;
79 unsigned long refcount;
82 static LIST_HEAD(acpi_ioremaps);
83 static DEFINE_MUTEX(acpi_ioremap_lock);
84 #define acpi_ioremap_lock_held() lock_is_held(&acpi_ioremap_lock.dep_map)
86 static void __init acpi_request_region (struct acpi_generic_address *gas,
87 unsigned int length, char *desc)
91 /* Handle possible alignment issues */
92 memcpy(&addr, &gas->address, sizeof(addr));
96 /* Resources are never freed */
97 if (gas->space_id == ACPI_ADR_SPACE_SYSTEM_IO)
98 request_region(addr, length, desc);
99 else if (gas->space_id == ACPI_ADR_SPACE_SYSTEM_MEMORY)
100 request_mem_region(addr, length, desc);
103 static int __init acpi_reserve_resources(void)
105 acpi_request_region(&acpi_gbl_FADT.xpm1a_event_block, acpi_gbl_FADT.pm1_event_length,
106 "ACPI PM1a_EVT_BLK");
108 acpi_request_region(&acpi_gbl_FADT.xpm1b_event_block, acpi_gbl_FADT.pm1_event_length,
109 "ACPI PM1b_EVT_BLK");
111 acpi_request_region(&acpi_gbl_FADT.xpm1a_control_block, acpi_gbl_FADT.pm1_control_length,
112 "ACPI PM1a_CNT_BLK");
114 acpi_request_region(&acpi_gbl_FADT.xpm1b_control_block, acpi_gbl_FADT.pm1_control_length,
115 "ACPI PM1b_CNT_BLK");
117 if (acpi_gbl_FADT.pm_timer_length == 4)
118 acpi_request_region(&acpi_gbl_FADT.xpm_timer_block, 4, "ACPI PM_TMR");
120 acpi_request_region(&acpi_gbl_FADT.xpm2_control_block, acpi_gbl_FADT.pm2_control_length,
123 /* Length of GPE blocks must be a non-negative multiple of 2 */
125 if (!(acpi_gbl_FADT.gpe0_block_length & 0x1))
126 acpi_request_region(&acpi_gbl_FADT.xgpe0_block,
127 acpi_gbl_FADT.gpe0_block_length, "ACPI GPE0_BLK");
129 if (!(acpi_gbl_FADT.gpe1_block_length & 0x1))
130 acpi_request_region(&acpi_gbl_FADT.xgpe1_block,
131 acpi_gbl_FADT.gpe1_block_length, "ACPI GPE1_BLK");
135 fs_initcall_sync(acpi_reserve_resources);
137 void acpi_os_printf(const char *fmt, ...)
141 acpi_os_vprintf(fmt, args);
144 EXPORT_SYMBOL(acpi_os_printf);
146 void acpi_os_vprintf(const char *fmt, va_list args)
148 static char buffer[512];
150 vsprintf(buffer, fmt, args);
152 #ifdef ENABLE_DEBUGGER
153 if (acpi_in_debugger) {
154 kdb_printf("%s", buffer);
156 if (printk_get_level(buffer))
157 printk("%s", buffer);
159 printk(KERN_CONT "%s", buffer);
162 if (acpi_debugger_write_log(buffer) < 0) {
163 if (printk_get_level(buffer))
164 printk("%s", buffer);
166 printk(KERN_CONT "%s", buffer);
172 static unsigned long acpi_rsdp;
173 static int __init setup_acpi_rsdp(char *arg)
175 return kstrtoul(arg, 16, &acpi_rsdp);
177 early_param("acpi_rsdp", setup_acpi_rsdp);
180 acpi_physical_address __init acpi_os_get_root_pointer(void)
182 acpi_physical_address pa;
188 pa = acpi_arch_get_root_pointer();
192 if (efi_enabled(EFI_CONFIG_TABLES)) {
193 if (efi.acpi20 != EFI_INVALID_TABLE_ADDR)
195 if (efi.acpi != EFI_INVALID_TABLE_ADDR)
197 pr_err(PREFIX "System description tables not found\n");
198 } else if (IS_ENABLED(CONFIG_ACPI_LEGACY_TABLES_LOOKUP)) {
199 acpi_find_root_pointer(&pa);
205 /* Must be called with 'acpi_ioremap_lock' or RCU read lock held. */
206 static struct acpi_ioremap *
207 acpi_map_lookup(acpi_physical_address phys, acpi_size size)
209 struct acpi_ioremap *map;
211 list_for_each_entry_rcu(map, &acpi_ioremaps, list, acpi_ioremap_lock_held())
212 if (map->phys <= phys &&
213 phys + size <= map->phys + map->size)
219 /* Must be called with 'acpi_ioremap_lock' or RCU read lock held. */
220 static void __iomem *
221 acpi_map_vaddr_lookup(acpi_physical_address phys, unsigned int size)
223 struct acpi_ioremap *map;
225 map = acpi_map_lookup(phys, size);
227 return map->virt + (phys - map->phys);
232 void __iomem *acpi_os_get_iomem(acpi_physical_address phys, unsigned int size)
234 struct acpi_ioremap *map;
235 void __iomem *virt = NULL;
237 mutex_lock(&acpi_ioremap_lock);
238 map = acpi_map_lookup(phys, size);
240 virt = map->virt + (phys - map->phys);
243 mutex_unlock(&acpi_ioremap_lock);
246 EXPORT_SYMBOL_GPL(acpi_os_get_iomem);
248 /* Must be called with 'acpi_ioremap_lock' or RCU read lock held. */
249 static struct acpi_ioremap *
250 acpi_map_lookup_virt(void __iomem *virt, acpi_size size)
252 struct acpi_ioremap *map;
254 list_for_each_entry_rcu(map, &acpi_ioremaps, list, acpi_ioremap_lock_held())
255 if (map->virt <= virt &&
256 virt + size <= map->virt + map->size)
262 #if defined(CONFIG_IA64) || defined(CONFIG_ARM64)
263 /* ioremap will take care of cache attributes */
264 #define should_use_kmap(pfn) 0
266 #define should_use_kmap(pfn) page_is_ram(pfn)
269 static void __iomem *acpi_map(acpi_physical_address pg_off, unsigned long pg_sz)
273 pfn = pg_off >> PAGE_SHIFT;
274 if (should_use_kmap(pfn)) {
275 if (pg_sz > PAGE_SIZE)
277 return (void __iomem __force *)kmap(pfn_to_page(pfn));
279 return acpi_os_ioremap(pg_off, pg_sz);
282 static void acpi_unmap(acpi_physical_address pg_off, void __iomem *vaddr)
286 pfn = pg_off >> PAGE_SHIFT;
287 if (should_use_kmap(pfn))
288 kunmap(pfn_to_page(pfn));
294 * acpi_os_map_iomem - Get a virtual address for a given physical address range.
295 * @phys: Start of the physical address range to map.
296 * @size: Size of the physical address range to map.
298 * Look up the given physical address range in the list of existing ACPI memory
299 * mappings. If found, get a reference to it and return a pointer to it (its
300 * virtual address). If not found, map it, add it to that list and return a
303 * During early init (when acpi_permanent_mmap has not been set yet) this
304 * routine simply calls __acpi_map_table() to get the job done.
307 *acpi_os_map_iomem(acpi_physical_address phys, acpi_size size)
309 struct acpi_ioremap *map;
311 acpi_physical_address pg_off;
314 if (phys > ULONG_MAX) {
315 printk(KERN_ERR PREFIX "Cannot map memory that high\n");
319 if (!acpi_permanent_mmap)
320 return __acpi_map_table((unsigned long)phys, size);
322 mutex_lock(&acpi_ioremap_lock);
323 /* Check if there's a suitable mapping already. */
324 map = acpi_map_lookup(phys, size);
330 map = kzalloc(sizeof(*map), GFP_KERNEL);
332 mutex_unlock(&acpi_ioremap_lock);
336 pg_off = round_down(phys, PAGE_SIZE);
337 pg_sz = round_up(phys + size, PAGE_SIZE) - pg_off;
338 virt = acpi_map(pg_off, pg_sz);
340 mutex_unlock(&acpi_ioremap_lock);
345 INIT_LIST_HEAD(&map->list);
351 list_add_tail_rcu(&map->list, &acpi_ioremaps);
354 mutex_unlock(&acpi_ioremap_lock);
355 return map->virt + (phys - map->phys);
357 EXPORT_SYMBOL_GPL(acpi_os_map_iomem);
359 void *__ref acpi_os_map_memory(acpi_physical_address phys, acpi_size size)
361 return (void *)acpi_os_map_iomem(phys, size);
363 EXPORT_SYMBOL_GPL(acpi_os_map_memory);
365 static void acpi_os_drop_map_ref(struct acpi_ioremap *map)
367 if (!--map->refcount)
368 list_del_rcu(&map->list);
371 static void acpi_os_map_cleanup(struct acpi_ioremap *map)
373 if (!map->refcount) {
374 synchronize_rcu_expedited();
375 acpi_unmap(map->phys, map->virt);
381 * acpi_os_unmap_iomem - Drop a memory mapping reference.
382 * @virt: Start of the address range to drop a reference to.
383 * @size: Size of the address range to drop a reference to.
385 * Look up the given virtual address range in the list of existing ACPI memory
386 * mappings, drop a reference to it and unmap it if there are no more active
389 * During early init (when acpi_permanent_mmap has not been set yet) this
390 * routine simply calls __acpi_unmap_table() to get the job done. Since
391 * __acpi_unmap_table() is an __init function, the __ref annotation is needed
394 void __ref acpi_os_unmap_iomem(void __iomem *virt, acpi_size size)
396 struct acpi_ioremap *map;
398 if (!acpi_permanent_mmap) {
399 __acpi_unmap_table(virt, size);
403 mutex_lock(&acpi_ioremap_lock);
404 map = acpi_map_lookup_virt(virt, size);
406 mutex_unlock(&acpi_ioremap_lock);
407 WARN(true, PREFIX "%s: bad address %p\n", __func__, virt);
410 acpi_os_drop_map_ref(map);
411 mutex_unlock(&acpi_ioremap_lock);
413 acpi_os_map_cleanup(map);
415 EXPORT_SYMBOL_GPL(acpi_os_unmap_iomem);
417 void __ref acpi_os_unmap_memory(void *virt, acpi_size size)
419 return acpi_os_unmap_iomem((void __iomem *)virt, size);
421 EXPORT_SYMBOL_GPL(acpi_os_unmap_memory);
423 int acpi_os_map_generic_address(struct acpi_generic_address *gas)
428 if (gas->space_id != ACPI_ADR_SPACE_SYSTEM_MEMORY)
431 /* Handle possible alignment issues */
432 memcpy(&addr, &gas->address, sizeof(addr));
433 if (!addr || !gas->bit_width)
436 virt = acpi_os_map_iomem(addr, gas->bit_width / 8);
442 EXPORT_SYMBOL(acpi_os_map_generic_address);
444 void acpi_os_unmap_generic_address(struct acpi_generic_address *gas)
447 struct acpi_ioremap *map;
449 if (gas->space_id != ACPI_ADR_SPACE_SYSTEM_MEMORY)
452 /* Handle possible alignment issues */
453 memcpy(&addr, &gas->address, sizeof(addr));
454 if (!addr || !gas->bit_width)
457 mutex_lock(&acpi_ioremap_lock);
458 map = acpi_map_lookup(addr, gas->bit_width / 8);
460 mutex_unlock(&acpi_ioremap_lock);
463 acpi_os_drop_map_ref(map);
464 mutex_unlock(&acpi_ioremap_lock);
466 acpi_os_map_cleanup(map);
468 EXPORT_SYMBOL(acpi_os_unmap_generic_address);
470 #ifdef ACPI_FUTURE_USAGE
472 acpi_os_get_physical_address(void *virt, acpi_physical_address * phys)
475 return AE_BAD_PARAMETER;
477 *phys = virt_to_phys(virt);
483 #ifdef CONFIG_ACPI_REV_OVERRIDE_POSSIBLE
484 static bool acpi_rev_override;
486 int __init acpi_rev_override_setup(char *str)
488 acpi_rev_override = true;
491 __setup("acpi_rev_override", acpi_rev_override_setup);
493 #define acpi_rev_override false
496 #define ACPI_MAX_OVERRIDE_LEN 100
498 static char acpi_os_name[ACPI_MAX_OVERRIDE_LEN];
501 acpi_os_predefined_override(const struct acpi_predefined_names *init_val,
502 acpi_string *new_val)
504 if (!init_val || !new_val)
505 return AE_BAD_PARAMETER;
508 if (!memcmp(init_val->name, "_OS_", 4) && strlen(acpi_os_name)) {
509 printk(KERN_INFO PREFIX "Overriding _OS definition to '%s'\n",
511 *new_val = acpi_os_name;
514 if (!memcmp(init_val->name, "_REV", 4) && acpi_rev_override) {
515 printk(KERN_INFO PREFIX "Overriding _REV return value to 5\n");
516 *new_val = (char *)5;
522 static irqreturn_t acpi_irq(int irq, void *dev_id)
526 handled = (*acpi_irq_handler) (acpi_irq_context);
532 acpi_irq_not_handled++;
538 acpi_os_install_interrupt_handler(u32 gsi, acpi_osd_handler handler,
543 acpi_irq_stats_init();
546 * ACPI interrupts different from the SCI in our copy of the FADT are
549 if (gsi != acpi_gbl_FADT.sci_interrupt)
550 return AE_BAD_PARAMETER;
552 if (acpi_irq_handler)
553 return AE_ALREADY_ACQUIRED;
555 if (acpi_gsi_to_irq(gsi, &irq) < 0) {
556 printk(KERN_ERR PREFIX "SCI (ACPI GSI %d) not registered\n",
561 acpi_irq_handler = handler;
562 acpi_irq_context = context;
563 if (request_irq(irq, acpi_irq, IRQF_SHARED, "acpi", acpi_irq)) {
564 printk(KERN_ERR PREFIX "SCI (IRQ%d) allocation failed\n", irq);
565 acpi_irq_handler = NULL;
566 return AE_NOT_ACQUIRED;
573 acpi_status acpi_os_remove_interrupt_handler(u32 gsi, acpi_osd_handler handler)
575 if (gsi != acpi_gbl_FADT.sci_interrupt || !acpi_sci_irq_valid())
576 return AE_BAD_PARAMETER;
578 free_irq(acpi_sci_irq, acpi_irq);
579 acpi_irq_handler = NULL;
580 acpi_sci_irq = INVALID_ACPI_IRQ;
586 * Running in interpreter thread context, safe to sleep
589 void acpi_os_sleep(u64 ms)
594 void acpi_os_stall(u32 us)
602 touch_nmi_watchdog();
608 * Support ACPI 3.0 AML Timer operand. Returns a 64-bit free-running,
609 * monotonically increasing timer with 100ns granularity. Do not use
610 * ktime_get() to implement this function because this function may get
611 * called after timekeeping has been suspended. Note: calling this function
612 * after timekeeping has been suspended may lead to unexpected results
613 * because when timekeeping is suspended the jiffies counter is not
614 * incremented. See also timekeeping_suspend().
616 u64 acpi_os_get_timer(void)
618 return (get_jiffies_64() - INITIAL_JIFFIES) *
619 (ACPI_100NSEC_PER_SEC / HZ);
622 acpi_status acpi_os_read_port(acpi_io_address port, u32 * value, u32 width)
631 *(u8 *) value = inb(port);
632 } else if (width <= 16) {
633 *(u16 *) value = inw(port);
634 } else if (width <= 32) {
635 *(u32 *) value = inl(port);
643 EXPORT_SYMBOL(acpi_os_read_port);
645 acpi_status acpi_os_write_port(acpi_io_address port, u32 value, u32 width)
649 } else if (width <= 16) {
651 } else if (width <= 32) {
660 EXPORT_SYMBOL(acpi_os_write_port);
662 int acpi_os_read_iomem(void __iomem *virt_addr, u64 *value, u32 width)
667 *(u8 *) value = readb(virt_addr);
670 *(u16 *) value = readw(virt_addr);
673 *(u32 *) value = readl(virt_addr);
676 *(u64 *) value = readq(virt_addr);
686 acpi_os_read_memory(acpi_physical_address phys_addr, u64 *value, u32 width)
688 void __iomem *virt_addr;
689 unsigned int size = width / 8;
695 virt_addr = acpi_map_vaddr_lookup(phys_addr, size);
698 virt_addr = acpi_os_ioremap(phys_addr, size);
700 return AE_BAD_ADDRESS;
707 error = acpi_os_read_iomem(virt_addr, value, width);
719 acpi_os_write_memory(acpi_physical_address phys_addr, u64 value, u32 width)
721 void __iomem *virt_addr;
722 unsigned int size = width / 8;
726 virt_addr = acpi_map_vaddr_lookup(phys_addr, size);
729 virt_addr = acpi_os_ioremap(phys_addr, size);
731 return AE_BAD_ADDRESS;
737 writeb(value, virt_addr);
740 writew(value, virt_addr);
743 writel(value, virt_addr);
746 writeq(value, virt_addr);
762 acpi_os_read_pci_configuration(struct acpi_pci_id * pci_id, u32 reg,
763 u64 *value, u32 width)
769 return AE_BAD_PARAMETER;
785 result = raw_pci_read(pci_id->segment, pci_id->bus,
786 PCI_DEVFN(pci_id->device, pci_id->function),
787 reg, size, &value32);
790 return (result ? AE_ERROR : AE_OK);
794 acpi_os_write_pci_configuration(struct acpi_pci_id * pci_id, u32 reg,
795 u64 value, u32 width)
813 result = raw_pci_write(pci_id->segment, pci_id->bus,
814 PCI_DEVFN(pci_id->device, pci_id->function),
817 return (result ? AE_ERROR : AE_OK);
821 static void acpi_os_execute_deferred(struct work_struct *work)
823 struct acpi_os_dpc *dpc = container_of(work, struct acpi_os_dpc, work);
825 dpc->function(dpc->context);
829 #ifdef CONFIG_ACPI_DEBUGGER
830 static struct acpi_debugger acpi_debugger;
831 static bool acpi_debugger_initialized;
833 int acpi_register_debugger(struct module *owner,
834 const struct acpi_debugger_ops *ops)
838 mutex_lock(&acpi_debugger.lock);
839 if (acpi_debugger.ops) {
844 acpi_debugger.owner = owner;
845 acpi_debugger.ops = ops;
848 mutex_unlock(&acpi_debugger.lock);
851 EXPORT_SYMBOL(acpi_register_debugger);
853 void acpi_unregister_debugger(const struct acpi_debugger_ops *ops)
855 mutex_lock(&acpi_debugger.lock);
856 if (ops == acpi_debugger.ops) {
857 acpi_debugger.ops = NULL;
858 acpi_debugger.owner = NULL;
860 mutex_unlock(&acpi_debugger.lock);
862 EXPORT_SYMBOL(acpi_unregister_debugger);
864 int acpi_debugger_create_thread(acpi_osd_exec_callback function, void *context)
867 int (*func)(acpi_osd_exec_callback, void *);
868 struct module *owner;
870 if (!acpi_debugger_initialized)
872 mutex_lock(&acpi_debugger.lock);
873 if (!acpi_debugger.ops) {
877 if (!try_module_get(acpi_debugger.owner)) {
881 func = acpi_debugger.ops->create_thread;
882 owner = acpi_debugger.owner;
883 mutex_unlock(&acpi_debugger.lock);
885 ret = func(function, context);
887 mutex_lock(&acpi_debugger.lock);
890 mutex_unlock(&acpi_debugger.lock);
894 ssize_t acpi_debugger_write_log(const char *msg)
897 ssize_t (*func)(const char *);
898 struct module *owner;
900 if (!acpi_debugger_initialized)
902 mutex_lock(&acpi_debugger.lock);
903 if (!acpi_debugger.ops) {
907 if (!try_module_get(acpi_debugger.owner)) {
911 func = acpi_debugger.ops->write_log;
912 owner = acpi_debugger.owner;
913 mutex_unlock(&acpi_debugger.lock);
917 mutex_lock(&acpi_debugger.lock);
920 mutex_unlock(&acpi_debugger.lock);
924 ssize_t acpi_debugger_read_cmd(char *buffer, size_t buffer_length)
927 ssize_t (*func)(char *, size_t);
928 struct module *owner;
930 if (!acpi_debugger_initialized)
932 mutex_lock(&acpi_debugger.lock);
933 if (!acpi_debugger.ops) {
937 if (!try_module_get(acpi_debugger.owner)) {
941 func = acpi_debugger.ops->read_cmd;
942 owner = acpi_debugger.owner;
943 mutex_unlock(&acpi_debugger.lock);
945 ret = func(buffer, buffer_length);
947 mutex_lock(&acpi_debugger.lock);
950 mutex_unlock(&acpi_debugger.lock);
954 int acpi_debugger_wait_command_ready(void)
957 int (*func)(bool, char *, size_t);
958 struct module *owner;
960 if (!acpi_debugger_initialized)
962 mutex_lock(&acpi_debugger.lock);
963 if (!acpi_debugger.ops) {
967 if (!try_module_get(acpi_debugger.owner)) {
971 func = acpi_debugger.ops->wait_command_ready;
972 owner = acpi_debugger.owner;
973 mutex_unlock(&acpi_debugger.lock);
975 ret = func(acpi_gbl_method_executing,
976 acpi_gbl_db_line_buf, ACPI_DB_LINE_BUFFER_SIZE);
978 mutex_lock(&acpi_debugger.lock);
981 mutex_unlock(&acpi_debugger.lock);
985 int acpi_debugger_notify_command_complete(void)
989 struct module *owner;
991 if (!acpi_debugger_initialized)
993 mutex_lock(&acpi_debugger.lock);
994 if (!acpi_debugger.ops) {
998 if (!try_module_get(acpi_debugger.owner)) {
1002 func = acpi_debugger.ops->notify_command_complete;
1003 owner = acpi_debugger.owner;
1004 mutex_unlock(&acpi_debugger.lock);
1008 mutex_lock(&acpi_debugger.lock);
1011 mutex_unlock(&acpi_debugger.lock);
1015 int __init acpi_debugger_init(void)
1017 mutex_init(&acpi_debugger.lock);
1018 acpi_debugger_initialized = true;
1023 /*******************************************************************************
1025 * FUNCTION: acpi_os_execute
1027 * PARAMETERS: Type - Type of the callback
1028 * Function - Function to be executed
1029 * Context - Function parameters
1033 * DESCRIPTION: Depending on type, either queues function for deferred execution or
1034 * immediately executes function on a separate thread.
1036 ******************************************************************************/
1038 acpi_status acpi_os_execute(acpi_execute_type type,
1039 acpi_osd_exec_callback function, void *context)
1041 acpi_status status = AE_OK;
1042 struct acpi_os_dpc *dpc;
1043 struct workqueue_struct *queue;
1045 ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
1046 "Scheduling function [%p(%p)] for deferred execution.\n",
1047 function, context));
1049 if (type == OSL_DEBUGGER_MAIN_THREAD) {
1050 ret = acpi_debugger_create_thread(function, context);
1052 pr_err("Call to kthread_create() failed.\n");
1059 * Allocate/initialize DPC structure. Note that this memory will be
1060 * freed by the callee. The kernel handles the work_struct list in a
1061 * way that allows us to also free its memory inside the callee.
1062 * Because we may want to schedule several tasks with different
1063 * parameters we can't use the approach some kernel code uses of
1064 * having a static work_struct.
1067 dpc = kzalloc(sizeof(struct acpi_os_dpc), GFP_ATOMIC);
1069 return AE_NO_MEMORY;
1071 dpc->function = function;
1072 dpc->context = context;
1075 * To prevent lockdep from complaining unnecessarily, make sure that
1076 * there is a different static lockdep key for each workqueue by using
1077 * INIT_WORK() for each of them separately.
1079 if (type == OSL_NOTIFY_HANDLER) {
1080 queue = kacpi_notify_wq;
1081 INIT_WORK(&dpc->work, acpi_os_execute_deferred);
1082 } else if (type == OSL_GPE_HANDLER) {
1084 INIT_WORK(&dpc->work, acpi_os_execute_deferred);
1086 pr_err("Unsupported os_execute type %d.\n", type);
1090 if (ACPI_FAILURE(status))
1094 * On some machines, a software-initiated SMI causes corruption unless
1095 * the SMI runs on CPU 0. An SMI can be initiated by any AML, but
1096 * typically it's done in GPE-related methods that are run via
1097 * workqueues, so we can avoid the known corruption cases by always
1098 * queueing on CPU 0.
1100 ret = queue_work_on(0, queue, &dpc->work);
1102 printk(KERN_ERR PREFIX
1103 "Call to queue_work() failed.\n");
1107 if (ACPI_FAILURE(status))
1112 EXPORT_SYMBOL(acpi_os_execute);
1114 void acpi_os_wait_events_complete(void)
1117 * Make sure the GPE handler or the fixed event handler is not used
1118 * on another CPU after removal.
1120 if (acpi_sci_irq_valid())
1121 synchronize_hardirq(acpi_sci_irq);
1122 flush_workqueue(kacpid_wq);
1123 flush_workqueue(kacpi_notify_wq);
1125 EXPORT_SYMBOL(acpi_os_wait_events_complete);
1127 struct acpi_hp_work {
1128 struct work_struct work;
1129 struct acpi_device *adev;
1133 static void acpi_hotplug_work_fn(struct work_struct *work)
1135 struct acpi_hp_work *hpw = container_of(work, struct acpi_hp_work, work);
1137 acpi_os_wait_events_complete();
1138 acpi_device_hotplug(hpw->adev, hpw->src);
1142 acpi_status acpi_hotplug_schedule(struct acpi_device *adev, u32 src)
1144 struct acpi_hp_work *hpw;
1146 ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
1147 "Scheduling hotplug event (%p, %u) for deferred execution.\n",
1150 hpw = kmalloc(sizeof(*hpw), GFP_KERNEL);
1152 return AE_NO_MEMORY;
1154 INIT_WORK(&hpw->work, acpi_hotplug_work_fn);
1158 * We can't run hotplug code in kacpid_wq/kacpid_notify_wq etc., because
1159 * the hotplug code may call driver .remove() functions, which may
1160 * invoke flush_scheduled_work()/acpi_os_wait_events_complete() to flush
1163 if (!queue_work(kacpi_hotplug_wq, &hpw->work)) {
1170 bool acpi_queue_hotplug_work(struct work_struct *work)
1172 return queue_work(kacpi_hotplug_wq, work);
1176 acpi_os_create_semaphore(u32 max_units, u32 initial_units, acpi_handle * handle)
1178 struct semaphore *sem = NULL;
1180 sem = acpi_os_allocate_zeroed(sizeof(struct semaphore));
1182 return AE_NO_MEMORY;
1184 sema_init(sem, initial_units);
1186 *handle = (acpi_handle *) sem;
1188 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Creating semaphore[%p|%d].\n",
1189 *handle, initial_units));
1195 * TODO: A better way to delete semaphores? Linux doesn't have a
1196 * 'delete_semaphore()' function -- may result in an invalid
1197 * pointer dereference for non-synchronized consumers. Should
1198 * we at least check for blocked threads and signal/cancel them?
1201 acpi_status acpi_os_delete_semaphore(acpi_handle handle)
1203 struct semaphore *sem = (struct semaphore *)handle;
1206 return AE_BAD_PARAMETER;
1208 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Deleting semaphore[%p].\n", handle));
1210 BUG_ON(!list_empty(&sem->wait_list));
1218 * TODO: Support for units > 1?
1220 acpi_status acpi_os_wait_semaphore(acpi_handle handle, u32 units, u16 timeout)
1222 acpi_status status = AE_OK;
1223 struct semaphore *sem = (struct semaphore *)handle;
1227 if (!acpi_os_initialized)
1230 if (!sem || (units < 1))
1231 return AE_BAD_PARAMETER;
1236 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Waiting for semaphore[%p|%d|%d]\n",
1237 handle, units, timeout));
1239 if (timeout == ACPI_WAIT_FOREVER)
1240 jiffies = MAX_SCHEDULE_TIMEOUT;
1242 jiffies = msecs_to_jiffies(timeout);
1244 ret = down_timeout(sem, jiffies);
1248 if (ACPI_FAILURE(status)) {
1249 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX,
1250 "Failed to acquire semaphore[%p|%d|%d], %s",
1251 handle, units, timeout,
1252 acpi_format_exception(status)));
1254 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX,
1255 "Acquired semaphore[%p|%d|%d]", handle,
1263 * TODO: Support for units > 1?
1265 acpi_status acpi_os_signal_semaphore(acpi_handle handle, u32 units)
1267 struct semaphore *sem = (struct semaphore *)handle;
1269 if (!acpi_os_initialized)
1272 if (!sem || (units < 1))
1273 return AE_BAD_PARAMETER;
1278 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Signaling semaphore[%p|%d]\n", handle,
1286 acpi_status acpi_os_get_line(char *buffer, u32 buffer_length, u32 *bytes_read)
1288 #ifdef ENABLE_DEBUGGER
1289 if (acpi_in_debugger) {
1292 kdb_read(buffer, buffer_length);
1294 /* remove the CR kdb includes */
1295 chars = strlen(buffer) - 1;
1296 buffer[chars] = '\0';
1301 ret = acpi_debugger_read_cmd(buffer, buffer_length);
1310 EXPORT_SYMBOL(acpi_os_get_line);
1312 acpi_status acpi_os_wait_command_ready(void)
1316 ret = acpi_debugger_wait_command_ready();
1322 acpi_status acpi_os_notify_command_complete(void)
1326 ret = acpi_debugger_notify_command_complete();
1332 acpi_status acpi_os_signal(u32 function, void *info)
1335 case ACPI_SIGNAL_FATAL:
1336 printk(KERN_ERR PREFIX "Fatal opcode executed\n");
1338 case ACPI_SIGNAL_BREAKPOINT:
1341 * ACPI spec. says to treat it as a NOP unless
1342 * you are debugging. So if/when we integrate
1343 * AML debugger into the kernel debugger its
1344 * hook will go here. But until then it is
1345 * not useful to print anything on breakpoints.
1355 static int __init acpi_os_name_setup(char *str)
1357 char *p = acpi_os_name;
1358 int count = ACPI_MAX_OVERRIDE_LEN - 1;
1363 for (; count-- && *str; str++) {
1364 if (isalnum(*str) || *str == ' ' || *str == ':')
1366 else if (*str == '\'' || *str == '"')
1377 __setup("acpi_os_name=", acpi_os_name_setup);
1380 * Disable the auto-serialization of named objects creation methods.
1382 * This feature is enabled by default. It marks the AML control methods
1383 * that contain the opcodes to create named objects as "Serialized".
1385 static int __init acpi_no_auto_serialize_setup(char *str)
1387 acpi_gbl_auto_serialize_methods = FALSE;
1388 pr_info("ACPI: auto-serialization disabled\n");
1393 __setup("acpi_no_auto_serialize", acpi_no_auto_serialize_setup);
1395 /* Check of resource interference between native drivers and ACPI
1396 * OperationRegions (SystemIO and System Memory only).
1397 * IO ports and memory declared in ACPI might be used by the ACPI subsystem
1398 * in arbitrary AML code and can interfere with legacy drivers.
1399 * acpi_enforce_resources= can be set to:
1401 * - strict (default) (2)
1402 * -> further driver trying to access the resources will not load
1404 * -> further driver trying to access the resources will load, but you
1405 * get a system message that something might go wrong...
1408 * -> ACPI Operation Region resources will not be registered
1411 #define ENFORCE_RESOURCES_STRICT 2
1412 #define ENFORCE_RESOURCES_LAX 1
1413 #define ENFORCE_RESOURCES_NO 0
1415 static unsigned int acpi_enforce_resources = ENFORCE_RESOURCES_STRICT;
1417 static int __init acpi_enforce_resources_setup(char *str)
1419 if (str == NULL || *str == '\0')
1422 if (!strcmp("strict", str))
1423 acpi_enforce_resources = ENFORCE_RESOURCES_STRICT;
1424 else if (!strcmp("lax", str))
1425 acpi_enforce_resources = ENFORCE_RESOURCES_LAX;
1426 else if (!strcmp("no", str))
1427 acpi_enforce_resources = ENFORCE_RESOURCES_NO;
1432 __setup("acpi_enforce_resources=", acpi_enforce_resources_setup);
1434 /* Check for resource conflicts between ACPI OperationRegions and native
1436 int acpi_check_resource_conflict(const struct resource *res)
1438 acpi_adr_space_type space_id;
1443 if (acpi_enforce_resources == ENFORCE_RESOURCES_NO)
1445 if (!(res->flags & IORESOURCE_IO) && !(res->flags & IORESOURCE_MEM))
1448 if (res->flags & IORESOURCE_IO)
1449 space_id = ACPI_ADR_SPACE_SYSTEM_IO;
1451 space_id = ACPI_ADR_SPACE_SYSTEM_MEMORY;
1453 length = resource_size(res);
1454 if (acpi_enforce_resources != ENFORCE_RESOURCES_NO)
1456 clash = acpi_check_address_range(space_id, res->start, length, warn);
1459 if (acpi_enforce_resources != ENFORCE_RESOURCES_NO) {
1460 if (acpi_enforce_resources == ENFORCE_RESOURCES_LAX)
1461 printk(KERN_NOTICE "ACPI: This conflict may"
1462 " cause random problems and system"
1464 printk(KERN_INFO "ACPI: If an ACPI driver is available"
1465 " for this device, you should use it instead of"
1466 " the native driver\n");
1468 if (acpi_enforce_resources == ENFORCE_RESOURCES_STRICT)
1473 EXPORT_SYMBOL(acpi_check_resource_conflict);
1475 int acpi_check_region(resource_size_t start, resource_size_t n,
1478 struct resource res = {
1480 .end = start + n - 1,
1482 .flags = IORESOURCE_IO,
1485 return acpi_check_resource_conflict(&res);
1487 EXPORT_SYMBOL(acpi_check_region);
1489 static acpi_status acpi_deactivate_mem_region(acpi_handle handle, u32 level,
1490 void *_res, void **return_value)
1492 struct acpi_mem_space_context **mem_ctx;
1493 union acpi_operand_object *handler_obj;
1494 union acpi_operand_object *region_obj2;
1495 union acpi_operand_object *region_obj;
1496 struct resource *res = _res;
1499 region_obj = acpi_ns_get_attached_object(handle);
1503 handler_obj = region_obj->region.handler;
1507 if (region_obj->region.space_id != ACPI_ADR_SPACE_SYSTEM_MEMORY)
1510 if (!(region_obj->region.flags & AOPOBJ_SETUP_COMPLETE))
1513 region_obj2 = acpi_ns_get_secondary_object(region_obj);
1517 mem_ctx = (void *)®ion_obj2->extra.region_context;
1519 if (!(mem_ctx[0]->address >= res->start &&
1520 mem_ctx[0]->address < res->end))
1523 status = handler_obj->address_space.setup(region_obj,
1524 ACPI_REGION_DEACTIVATE,
1525 NULL, (void **)mem_ctx);
1526 if (ACPI_SUCCESS(status))
1527 region_obj->region.flags &= ~(AOPOBJ_SETUP_COMPLETE);
1533 * acpi_release_memory - Release any mappings done to a memory region
1534 * @handle: Handle to namespace node
1535 * @res: Memory resource
1536 * @level: A level that terminates the search
1538 * Walks through @handle and unmaps all SystemMemory Operation Regions that
1539 * overlap with @res and that have already been activated (mapped).
1541 * This is a helper that allows drivers to place special requirements on memory
1542 * region that may overlap with operation regions, primarily allowing them to
1543 * safely map the region as non-cached memory.
1545 * The unmapped Operation Regions will be automatically remapped next time they
1546 * are called, so the drivers do not need to do anything else.
1548 acpi_status acpi_release_memory(acpi_handle handle, struct resource *res,
1551 if (!(res->flags & IORESOURCE_MEM))
1554 return acpi_walk_namespace(ACPI_TYPE_REGION, handle, level,
1555 acpi_deactivate_mem_region, NULL, res, NULL);
1557 EXPORT_SYMBOL_GPL(acpi_release_memory);
1560 * Let drivers know whether the resource checks are effective
1562 int acpi_resources_are_enforced(void)
1564 return acpi_enforce_resources == ENFORCE_RESOURCES_STRICT;
1566 EXPORT_SYMBOL(acpi_resources_are_enforced);
1569 * Deallocate the memory for a spinlock.
1571 void acpi_os_delete_lock(acpi_spinlock handle)
1577 * Acquire a spinlock.
1579 * handle is a pointer to the spinlock_t.
1582 acpi_cpu_flags acpi_os_acquire_lock(acpi_spinlock lockp)
1584 acpi_cpu_flags flags;
1585 spin_lock_irqsave(lockp, flags);
1590 * Release a spinlock. See above.
1593 void acpi_os_release_lock(acpi_spinlock lockp, acpi_cpu_flags flags)
1595 spin_unlock_irqrestore(lockp, flags);
1598 #ifndef ACPI_USE_LOCAL_CACHE
1600 /*******************************************************************************
1602 * FUNCTION: acpi_os_create_cache
1604 * PARAMETERS: name - Ascii name for the cache
1605 * size - Size of each cached object
1606 * depth - Maximum depth of the cache (in objects) <ignored>
1607 * cache - Where the new cache object is returned
1611 * DESCRIPTION: Create a cache object
1613 ******************************************************************************/
1616 acpi_os_create_cache(char *name, u16 size, u16 depth, acpi_cache_t ** cache)
1618 *cache = kmem_cache_create(name, size, 0, 0, NULL);
1625 /*******************************************************************************
1627 * FUNCTION: acpi_os_purge_cache
1629 * PARAMETERS: Cache - Handle to cache object
1633 * DESCRIPTION: Free all objects within the requested cache.
1635 ******************************************************************************/
1637 acpi_status acpi_os_purge_cache(acpi_cache_t * cache)
1639 kmem_cache_shrink(cache);
1643 /*******************************************************************************
1645 * FUNCTION: acpi_os_delete_cache
1647 * PARAMETERS: Cache - Handle to cache object
1651 * DESCRIPTION: Free all objects within the requested cache and delete the
1654 ******************************************************************************/
1656 acpi_status acpi_os_delete_cache(acpi_cache_t * cache)
1658 kmem_cache_destroy(cache);
1662 /*******************************************************************************
1664 * FUNCTION: acpi_os_release_object
1666 * PARAMETERS: Cache - Handle to cache object
1667 * Object - The object to be released
1671 * DESCRIPTION: Release an object to the specified cache. If cache is full,
1672 * the object is deleted.
1674 ******************************************************************************/
1676 acpi_status acpi_os_release_object(acpi_cache_t * cache, void *object)
1678 kmem_cache_free(cache, object);
1683 static int __init acpi_no_static_ssdt_setup(char *s)
1685 acpi_gbl_disable_ssdt_table_install = TRUE;
1686 pr_info("ACPI: static SSDT installation disabled\n");
1691 early_param("acpi_no_static_ssdt", acpi_no_static_ssdt_setup);
1693 static int __init acpi_disable_return_repair(char *s)
1695 printk(KERN_NOTICE PREFIX
1696 "ACPI: Predefined validation mechanism disabled\n");
1697 acpi_gbl_disable_auto_repair = TRUE;
1702 __setup("acpica_no_return_repair", acpi_disable_return_repair);
1704 acpi_status __init acpi_os_initialize(void)
1706 acpi_os_map_generic_address(&acpi_gbl_FADT.xpm1a_event_block);
1707 acpi_os_map_generic_address(&acpi_gbl_FADT.xpm1b_event_block);
1708 acpi_os_map_generic_address(&acpi_gbl_FADT.xgpe0_block);
1709 acpi_os_map_generic_address(&acpi_gbl_FADT.xgpe1_block);
1710 if (acpi_gbl_FADT.flags & ACPI_FADT_RESET_REGISTER) {
1712 * Use acpi_os_map_generic_address to pre-map the reset
1713 * register if it's in system memory.
1717 rv = acpi_os_map_generic_address(&acpi_gbl_FADT.reset_register);
1718 pr_debug(PREFIX "%s: map reset_reg status %d\n", __func__, rv);
1720 acpi_os_initialized = true;
1725 acpi_status __init acpi_os_initialize1(void)
1727 kacpid_wq = alloc_workqueue("kacpid", 0, 1);
1728 kacpi_notify_wq = alloc_workqueue("kacpi_notify", 0, 1);
1729 kacpi_hotplug_wq = alloc_ordered_workqueue("kacpi_hotplug", 0);
1731 BUG_ON(!kacpi_notify_wq);
1732 BUG_ON(!kacpi_hotplug_wq);
1737 acpi_status acpi_os_terminate(void)
1739 if (acpi_irq_handler) {
1740 acpi_os_remove_interrupt_handler(acpi_gbl_FADT.sci_interrupt,
1744 acpi_os_unmap_generic_address(&acpi_gbl_FADT.xgpe1_block);
1745 acpi_os_unmap_generic_address(&acpi_gbl_FADT.xgpe0_block);
1746 acpi_os_unmap_generic_address(&acpi_gbl_FADT.xpm1b_event_block);
1747 acpi_os_unmap_generic_address(&acpi_gbl_FADT.xpm1a_event_block);
1748 if (acpi_gbl_FADT.flags & ACPI_FADT_RESET_REGISTER)
1749 acpi_os_unmap_generic_address(&acpi_gbl_FADT.reset_register);
1751 destroy_workqueue(kacpid_wq);
1752 destroy_workqueue(kacpi_notify_wq);
1753 destroy_workqueue(kacpi_hotplug_wq);
1758 acpi_status acpi_os_prepare_sleep(u8 sleep_state, u32 pm1a_control,
1762 if (__acpi_os_prepare_sleep)
1763 rc = __acpi_os_prepare_sleep(sleep_state,
1764 pm1a_control, pm1b_control);
1768 return AE_CTRL_TERMINATE;
1773 void acpi_os_set_prepare_sleep(int (*func)(u8 sleep_state,
1774 u32 pm1a_ctrl, u32 pm1b_ctrl))
1776 __acpi_os_prepare_sleep = func;
1779 #if (ACPI_REDUCED_HARDWARE)
1780 acpi_status acpi_os_prepare_extended_sleep(u8 sleep_state, u32 val_a,
1784 if (__acpi_os_prepare_extended_sleep)
1785 rc = __acpi_os_prepare_extended_sleep(sleep_state,
1790 return AE_CTRL_TERMINATE;
1795 acpi_status acpi_os_prepare_extended_sleep(u8 sleep_state, u32 val_a,
1802 void acpi_os_set_prepare_extended_sleep(int (*func)(u8 sleep_state,
1803 u32 val_a, u32 val_b))
1805 __acpi_os_prepare_extended_sleep = func;
1808 acpi_status acpi_os_enter_sleep(u8 sleep_state,
1809 u32 reg_a_value, u32 reg_b_value)
1813 if (acpi_gbl_reduced_hardware)
1814 status = acpi_os_prepare_extended_sleep(sleep_state,
1818 status = acpi_os_prepare_sleep(sleep_state,
1819 reg_a_value, reg_b_value);