2 * acpi_osl.c - OS-dependent functions ($Revision: 83 $)
4 * Copyright (C) 2000 Andrew Henroid
5 * Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com>
6 * Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
8 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
28 #include <linux/module.h>
29 #include <linux/kernel.h>
30 #include <linux/slab.h>
32 #include <linux/pci.h>
33 #include <linux/smp_lock.h>
34 #include <linux/interrupt.h>
35 #include <linux/kmod.h>
36 #include <linux/delay.h>
37 #include <linux/workqueue.h>
38 #include <linux/nmi.h>
39 #include <linux/acpi.h>
40 #include <acpi/acpi.h>
42 #include <acpi/acpi_bus.h>
43 #include <acpi/processor.h>
44 #include <asm/uaccess.h>
46 #include <linux/efi.h>
48 #define _COMPONENT ACPI_OS_SERVICES
49 ACPI_MODULE_NAME("osl")
50 #define PREFIX "ACPI: "
52 acpi_osd_exec_callback function;
54 struct work_struct work;
57 #ifdef CONFIG_ACPI_CUSTOM_DSDT
58 #include CONFIG_ACPI_CUSTOM_DSDT_FILE
61 #ifdef ENABLE_DEBUGGER
62 #include <linux/kdb.h>
64 /* stuff for debugger support */
66 EXPORT_SYMBOL(acpi_in_debugger);
68 extern char line_buf[80];
69 #endif /*ENABLE_DEBUGGER */
71 int acpi_specific_hotkey_enabled = TRUE;
72 EXPORT_SYMBOL(acpi_specific_hotkey_enabled);
74 static unsigned int acpi_irq_irq;
75 static acpi_osd_handler acpi_irq_handler;
76 static void *acpi_irq_context;
77 static struct workqueue_struct *kacpid_wq;
79 static void __init acpi_request_region (struct acpi_generic_address *addr,
80 unsigned int length, char *desc)
84 if (!addr->address || !length)
87 if (addr->space_id == ACPI_ADR_SPACE_SYSTEM_IO)
88 res = request_region(addr->address, length, desc);
89 else if (addr->space_id == ACPI_ADR_SPACE_SYSTEM_MEMORY)
90 res = request_mem_region(addr->address, length, desc);
93 static int __init acpi_reserve_resources(void)
95 acpi_request_region(&acpi_gbl_FADT.xpm1a_event_block, acpi_gbl_FADT.pm1_event_length,
98 acpi_request_region(&acpi_gbl_FADT.xpm1b_event_block, acpi_gbl_FADT.pm1_event_length,
101 acpi_request_region(&acpi_gbl_FADT.xpm1a_control_block, acpi_gbl_FADT.pm1_control_length,
102 "ACPI PM1a_CNT_BLK");
104 acpi_request_region(&acpi_gbl_FADT.xpm1b_control_block, acpi_gbl_FADT.pm1_control_length,
105 "ACPI PM1b_CNT_BLK");
107 if (acpi_gbl_FADT.pm_timer_length == 4)
108 acpi_request_region(&acpi_gbl_FADT.xpm_timer_block, 4, "ACPI PM_TMR");
110 acpi_request_region(&acpi_gbl_FADT.xpm2_control_block, acpi_gbl_FADT.pm2_control_length,
113 /* Length of GPE blocks must be a non-negative multiple of 2 */
115 if (!(acpi_gbl_FADT.gpe0_block_length & 0x1))
116 acpi_request_region(&acpi_gbl_FADT.xgpe0_block,
117 acpi_gbl_FADT.gpe0_block_length, "ACPI GPE0_BLK");
119 if (!(acpi_gbl_FADT.gpe1_block_length & 0x1))
120 acpi_request_region(&acpi_gbl_FADT.xgpe1_block,
121 acpi_gbl_FADT.gpe1_block_length, "ACPI GPE1_BLK");
125 device_initcall(acpi_reserve_resources);
127 acpi_status acpi_os_initialize(void)
132 acpi_status acpi_os_initialize1(void)
135 * Initialize PCI configuration space access, as we'll need to access
136 * it while walking the namespace (bus 0 and root bridges w/ _BBNs).
139 printk(KERN_ERR PREFIX
140 "Access to PCI configuration space unavailable\n");
141 return AE_NULL_ENTRY;
143 kacpid_wq = create_singlethread_workqueue("kacpid");
149 acpi_status acpi_os_terminate(void)
151 if (acpi_irq_handler) {
152 acpi_os_remove_interrupt_handler(acpi_irq_irq,
156 destroy_workqueue(kacpid_wq);
161 void acpi_os_printf(const char *fmt, ...)
165 acpi_os_vprintf(fmt, args);
169 EXPORT_SYMBOL(acpi_os_printf);
171 void acpi_os_vprintf(const char *fmt, va_list args)
173 static char buffer[512];
175 vsprintf(buffer, fmt, args);
177 #ifdef ENABLE_DEBUGGER
178 if (acpi_in_debugger) {
179 kdb_printf("%s", buffer);
181 printk("%s", buffer);
184 printk("%s", buffer);
188 acpi_physical_address __init acpi_os_get_root_pointer(void)
191 if (efi.acpi20 != EFI_INVALID_TABLE_ADDR)
193 else if (efi.acpi != EFI_INVALID_TABLE_ADDR)
196 printk(KERN_ERR PREFIX
197 "System description tables not found\n");
201 return acpi_find_rsdp();
204 void __iomem *acpi_os_map_memory(acpi_physical_address phys, acpi_size size)
206 if (phys > ULONG_MAX) {
207 printk(KERN_ERR PREFIX "Cannot map memory that high\n");
210 if (acpi_gbl_permanent_mmap)
212 * ioremap checks to ensure this is in reserved space
214 return ioremap((unsigned long)phys, size);
216 return __acpi_map_table((unsigned long)phys, size);
218 EXPORT_SYMBOL_GPL(acpi_os_map_memory);
220 void acpi_os_unmap_memory(void __iomem * virt, acpi_size size)
222 if (acpi_gbl_permanent_mmap) {
226 EXPORT_SYMBOL_GPL(acpi_os_unmap_memory);
228 #ifdef ACPI_FUTURE_USAGE
230 acpi_os_get_physical_address(void *virt, acpi_physical_address * phys)
233 return AE_BAD_PARAMETER;
235 *phys = virt_to_phys(virt);
241 #define ACPI_MAX_OVERRIDE_LEN 100
243 static char acpi_os_name[ACPI_MAX_OVERRIDE_LEN];
246 acpi_os_predefined_override(const struct acpi_predefined_names *init_val,
247 acpi_string * new_val)
249 if (!init_val || !new_val)
250 return AE_BAD_PARAMETER;
253 if (!memcmp(init_val->name, "_OS_", 4) && strlen(acpi_os_name)) {
254 printk(KERN_INFO PREFIX "Overriding _OS definition to '%s'\n",
256 *new_val = acpi_os_name;
263 acpi_os_table_override(struct acpi_table_header * existing_table,
264 struct acpi_table_header ** new_table)
266 if (!existing_table || !new_table)
267 return AE_BAD_PARAMETER;
269 #ifdef CONFIG_ACPI_CUSTOM_DSDT
270 if (strncmp(existing_table->signature, "DSDT", 4) == 0)
271 *new_table = (struct acpi_table_header *)AmlCode;
280 static irqreturn_t acpi_irq(int irq, void *dev_id)
282 return (*acpi_irq_handler) (acpi_irq_context) ? IRQ_HANDLED : IRQ_NONE;
286 acpi_os_install_interrupt_handler(u32 gsi, acpi_osd_handler handler,
292 * Ignore the GSI from the core, and use the value in our copy of the
293 * FADT. It may not be the same if an interrupt source override exists
296 gsi = acpi_gbl_FADT.sci_interrupt;
297 if (acpi_gsi_to_irq(gsi, &irq) < 0) {
298 printk(KERN_ERR PREFIX "SCI (ACPI GSI %d) not registered\n",
303 acpi_irq_handler = handler;
304 acpi_irq_context = context;
305 if (request_irq(irq, acpi_irq, IRQF_SHARED, "acpi", acpi_irq)) {
306 printk(KERN_ERR PREFIX "SCI (IRQ%d) allocation failed\n", irq);
307 return AE_NOT_ACQUIRED;
314 acpi_status acpi_os_remove_interrupt_handler(u32 irq, acpi_osd_handler handler)
317 free_irq(irq, acpi_irq);
318 acpi_irq_handler = NULL;
326 * Running in interpreter thread context, safe to sleep
329 void acpi_os_sleep(acpi_integer ms)
331 schedule_timeout_interruptible(msecs_to_jiffies(ms));
334 EXPORT_SYMBOL(acpi_os_sleep);
336 void acpi_os_stall(u32 us)
344 touch_nmi_watchdog();
349 EXPORT_SYMBOL(acpi_os_stall);
352 * Support ACPI 3.0 AML Timer operand
353 * Returns 64-bit free-running, monotonically increasing timer
354 * with 100ns granularity
356 u64 acpi_os_get_timer(void)
361 /* TBD: use HPET if available */
364 #ifdef CONFIG_X86_PM_TIMER
365 /* TBD: default to PM timer if HPET was not available */
368 printk(KERN_ERR PREFIX "acpi_os_get_timer() TBD\n");
373 acpi_status acpi_os_read_port(acpi_io_address port, u32 * value, u32 width)
382 *(u8 *) value = inb(port);
385 *(u16 *) value = inw(port);
388 *(u32 *) value = inl(port);
397 EXPORT_SYMBOL(acpi_os_read_port);
399 acpi_status acpi_os_write_port(acpi_io_address port, u32 value, u32 width)
418 EXPORT_SYMBOL(acpi_os_write_port);
421 acpi_os_read_memory(acpi_physical_address phys_addr, u32 * value, u32 width)
424 void __iomem *virt_addr;
426 virt_addr = ioremap(phys_addr, width);
432 *(u8 *) value = readb(virt_addr);
435 *(u16 *) value = readw(virt_addr);
438 *(u32 *) value = readl(virt_addr);
450 acpi_os_write_memory(acpi_physical_address phys_addr, u32 value, u32 width)
452 void __iomem *virt_addr;
454 virt_addr = ioremap(phys_addr, width);
458 writeb(value, virt_addr);
461 writew(value, virt_addr);
464 writel(value, virt_addr);
476 acpi_os_read_pci_configuration(struct acpi_pci_id * pci_id, u32 reg,
477 void *value, u32 width)
482 return AE_BAD_PARAMETER;
498 BUG_ON(!raw_pci_ops);
500 result = raw_pci_ops->read(pci_id->segment, pci_id->bus,
501 PCI_DEVFN(pci_id->device, pci_id->function),
504 return (result ? AE_ERROR : AE_OK);
507 EXPORT_SYMBOL(acpi_os_read_pci_configuration);
510 acpi_os_write_pci_configuration(struct acpi_pci_id * pci_id, u32 reg,
511 acpi_integer value, u32 width)
529 BUG_ON(!raw_pci_ops);
531 result = raw_pci_ops->write(pci_id->segment, pci_id->bus,
532 PCI_DEVFN(pci_id->device, pci_id->function),
535 return (result ? AE_ERROR : AE_OK);
538 /* TODO: Change code to take advantage of driver model more */
539 static void acpi_os_derive_pci_id_2(acpi_handle rhandle, /* upper bound */
540 acpi_handle chandle, /* current node */
541 struct acpi_pci_id **id,
542 int *is_bridge, u8 * bus_number)
545 struct acpi_pci_id *pci_id = *id;
548 acpi_object_type type;
551 acpi_get_parent(chandle, &handle);
552 if (handle != rhandle) {
553 acpi_os_derive_pci_id_2(rhandle, handle, &pci_id, is_bridge,
556 status = acpi_get_type(handle, &type);
557 if ((ACPI_FAILURE(status)) || (type != ACPI_TYPE_DEVICE))
561 acpi_evaluate_integer(handle, METHOD_NAME__ADR, NULL,
563 if (ACPI_SUCCESS(status)) {
564 pci_id->device = ACPI_HIWORD(ACPI_LODWORD(temp));
565 pci_id->function = ACPI_LOWORD(ACPI_LODWORD(temp));
568 pci_id->bus = *bus_number;
570 /* any nicer way to get bus number of bridge ? */
572 acpi_os_read_pci_configuration(pci_id, 0x0e, &tu8,
574 if (ACPI_SUCCESS(status)
575 && ((tu8 & 0x7f) == 1 || (tu8 & 0x7f) == 2)) {
577 acpi_os_read_pci_configuration(pci_id, 0x18,
579 if (!ACPI_SUCCESS(status)) {
580 /* Certainly broken... FIX ME */
586 acpi_os_read_pci_configuration(pci_id, 0x19,
588 if (ACPI_SUCCESS(status)) {
597 void acpi_os_derive_pci_id(acpi_handle rhandle, /* upper bound */
598 acpi_handle chandle, /* current node */
599 struct acpi_pci_id **id)
602 u8 bus_number = (*id)->bus;
604 acpi_os_derive_pci_id_2(rhandle, chandle, id, &is_bridge, &bus_number);
607 static void acpi_os_execute_deferred(struct work_struct *work)
609 struct acpi_os_dpc *dpc = container_of(work, struct acpi_os_dpc, work);
612 printk(KERN_ERR PREFIX "Invalid (NULL) context\n");
616 dpc->function(dpc->context);
623 /*******************************************************************************
625 * FUNCTION: acpi_os_execute
627 * PARAMETERS: Type - Type of the callback
628 * Function - Function to be executed
629 * Context - Function parameters
633 * DESCRIPTION: Depending on type, either queues function for deferred execution or
634 * immediately executes function on a separate thread.
636 ******************************************************************************/
638 acpi_status acpi_os_execute(acpi_execute_type type,
639 acpi_osd_exec_callback function, void *context)
641 acpi_status status = AE_OK;
642 struct acpi_os_dpc *dpc;
644 ACPI_FUNCTION_TRACE("os_queue_for_execution");
646 ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
647 "Scheduling function [%p(%p)] for deferred execution.\n",
651 return_ACPI_STATUS(AE_BAD_PARAMETER);
654 * Allocate/initialize DPC structure. Note that this memory will be
655 * freed by the callee. The kernel handles the work_struct list in a
656 * way that allows us to also free its memory inside the callee.
657 * Because we may want to schedule several tasks with different
658 * parameters we can't use the approach some kernel code uses of
659 * having a static work_struct.
662 dpc = kmalloc(sizeof(struct acpi_os_dpc), GFP_ATOMIC);
664 return_ACPI_STATUS(AE_NO_MEMORY);
666 dpc->function = function;
667 dpc->context = context;
669 INIT_WORK(&dpc->work, acpi_os_execute_deferred);
670 if (!queue_work(kacpid_wq, &dpc->work)) {
671 ACPI_DEBUG_PRINT((ACPI_DB_ERROR,
672 "Call to queue_work() failed.\n"));
677 return_ACPI_STATUS(status);
680 EXPORT_SYMBOL(acpi_os_execute);
682 void acpi_os_wait_events_complete(void *context)
684 flush_workqueue(kacpid_wq);
687 EXPORT_SYMBOL(acpi_os_wait_events_complete);
690 * Allocate the memory for a spinlock and initialize it.
692 acpi_status acpi_os_create_lock(acpi_spinlock * handle)
694 spin_lock_init(*handle);
700 * Deallocate the memory for a spinlock.
702 void acpi_os_delete_lock(acpi_spinlock handle)
708 acpi_os_create_semaphore(u32 max_units, u32 initial_units, acpi_handle * handle)
710 struct semaphore *sem = NULL;
713 sem = acpi_os_allocate(sizeof(struct semaphore));
716 memset(sem, 0, sizeof(struct semaphore));
718 sema_init(sem, initial_units);
720 *handle = (acpi_handle *) sem;
722 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Creating semaphore[%p|%d].\n",
723 *handle, initial_units));
728 EXPORT_SYMBOL(acpi_os_create_semaphore);
731 * TODO: A better way to delete semaphores? Linux doesn't have a
732 * 'delete_semaphore()' function -- may result in an invalid
733 * pointer dereference for non-synchronized consumers. Should
734 * we at least check for blocked threads and signal/cancel them?
737 acpi_status acpi_os_delete_semaphore(acpi_handle handle)
739 struct semaphore *sem = (struct semaphore *)handle;
743 return AE_BAD_PARAMETER;
745 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Deleting semaphore[%p].\n", handle));
753 EXPORT_SYMBOL(acpi_os_delete_semaphore);
756 * TODO: The kernel doesn't have a 'down_timeout' function -- had to
757 * improvise. The process is to sleep for one scheduler quantum
758 * until the semaphore becomes available. Downside is that this
759 * may result in starvation for timeout-based waits when there's
760 * lots of semaphore activity.
762 * TODO: Support for units > 1?
764 acpi_status acpi_os_wait_semaphore(acpi_handle handle, u32 units, u16 timeout)
766 acpi_status status = AE_OK;
767 struct semaphore *sem = (struct semaphore *)handle;
771 if (!sem || (units < 1))
772 return AE_BAD_PARAMETER;
777 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Waiting for semaphore[%p|%d|%d]\n",
778 handle, units, timeout));
781 * This can be called during resume with interrupts off.
782 * Like boot-time, we should be single threaded and will
783 * always get the lock if we try -- timeout or not.
784 * If this doesn't succeed, then we will oops courtesy of
785 * might_sleep() in down().
787 if (!down_trylock(sem))
794 * A zero timeout value indicates that we shouldn't wait - just
795 * acquire the semaphore if available otherwise return AE_TIME
796 * (a.k.a. 'would block').
799 if (down_trylock(sem))
807 case ACPI_WAIT_FOREVER:
816 // TODO: A better timeout algorithm?
819 static const int quantum_ms = 1000 / HZ;
821 ret = down_trylock(sem);
822 for (i = timeout; (i > 0 && ret != 0); i -= quantum_ms) {
823 schedule_timeout_interruptible(1);
824 ret = down_trylock(sem);
833 if (ACPI_FAILURE(status)) {
834 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX,
835 "Failed to acquire semaphore[%p|%d|%d], %s",
836 handle, units, timeout,
837 acpi_format_exception(status)));
839 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX,
840 "Acquired semaphore[%p|%d|%d]", handle,
847 EXPORT_SYMBOL(acpi_os_wait_semaphore);
850 * TODO: Support for units > 1?
852 acpi_status acpi_os_signal_semaphore(acpi_handle handle, u32 units)
854 struct semaphore *sem = (struct semaphore *)handle;
857 if (!sem || (units < 1))
858 return AE_BAD_PARAMETER;
863 ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Signaling semaphore[%p|%d]\n", handle,
871 EXPORT_SYMBOL(acpi_os_signal_semaphore);
873 #ifdef ACPI_FUTURE_USAGE
874 u32 acpi_os_get_line(char *buffer)
877 #ifdef ENABLE_DEBUGGER
878 if (acpi_in_debugger) {
881 kdb_read(buffer, sizeof(line_buf));
883 /* remove the CR kdb includes */
884 chars = strlen(buffer) - 1;
885 buffer[chars] = '\0';
891 #endif /* ACPI_FUTURE_USAGE */
893 /* Assumes no unreadable holes inbetween */
894 u8 acpi_os_readable(void *ptr, acpi_size len)
896 #if defined(__i386__) || defined(__x86_64__)
898 return !__get_user(tmp, (char __user *)ptr)
899 && !__get_user(tmp, (char __user *)ptr + len - 1);
904 #ifdef ACPI_FUTURE_USAGE
905 u8 acpi_os_writable(void *ptr, acpi_size len)
907 /* could do dummy write (racy) or a kernel page table lookup.
908 The later may be difficult at early boot when kmap doesn't work yet. */
913 acpi_status acpi_os_signal(u32 function, void *info)
916 case ACPI_SIGNAL_FATAL:
917 printk(KERN_ERR PREFIX "Fatal opcode executed\n");
919 case ACPI_SIGNAL_BREAKPOINT:
922 * ACPI spec. says to treat it as a NOP unless
923 * you are debugging. So if/when we integrate
924 * AML debugger into the kernel debugger its
925 * hook will go here. But until then it is
926 * not useful to print anything on breakpoints.
936 EXPORT_SYMBOL(acpi_os_signal);
938 static int __init acpi_os_name_setup(char *str)
940 char *p = acpi_os_name;
941 int count = ACPI_MAX_OVERRIDE_LEN - 1;
946 for (; count-- && str && *str; str++) {
947 if (isalnum(*str) || *str == ' ' || *str == ':')
949 else if (*str == '\'' || *str == '"')
960 __setup("acpi_os_name=", acpi_os_name_setup);
964 * empty string disables _OSI
965 * TBD additional string adds to _OSI
967 static int __init acpi_osi_setup(char *str)
969 if (str == NULL || *str == '\0') {
970 printk(KERN_INFO PREFIX "_OSI method disabled\n");
971 acpi_gbl_create_osi_method = FALSE;
974 printk(KERN_ERR PREFIX "_OSI additional string ignored -- %s\n",
981 __setup("acpi_osi=", acpi_osi_setup);
983 /* enable serialization to combat AE_ALREADY_EXISTS errors */
984 static int __init acpi_serialize_setup(char *str)
986 printk(KERN_INFO PREFIX "serialize enabled\n");
988 acpi_gbl_all_methods_serialized = TRUE;
993 __setup("acpi_serialize", acpi_serialize_setup);
996 * Wake and Run-Time GPES are expected to be separate.
997 * We disable wake-GPEs at run-time to prevent spurious
1000 * However, if a system exists that shares Wake and
1001 * Run-time events on the same GPE this flag is available
1002 * to tell Linux to keep the wake-time GPEs enabled at run-time.
1004 static int __init acpi_wake_gpes_always_on_setup(char *str)
1006 printk(KERN_INFO PREFIX "wake GPEs not disabled\n");
1008 acpi_gbl_leave_wake_gpes_disabled = FALSE;
1013 __setup("acpi_wake_gpes_always_on", acpi_wake_gpes_always_on_setup);
1015 static int __init acpi_hotkey_setup(char *str)
1017 acpi_specific_hotkey_enabled = FALSE;
1021 __setup("acpi_generic_hotkey", acpi_hotkey_setup);
1024 * max_cstate is defined in the base kernel so modules can
1025 * change it w/o depending on the state of the processor module.
1027 unsigned int max_cstate = ACPI_PROCESSOR_MAX_POWER;
1029 EXPORT_SYMBOL(max_cstate);
1032 * Acquire a spinlock.
1034 * handle is a pointer to the spinlock_t.
1037 acpi_cpu_flags acpi_os_acquire_lock(acpi_spinlock lockp)
1039 acpi_cpu_flags flags;
1040 spin_lock_irqsave(lockp, flags);
1045 * Release a spinlock. See above.
1048 void acpi_os_release_lock(acpi_spinlock lockp, acpi_cpu_flags flags)
1050 spin_unlock_irqrestore(lockp, flags);
1053 #ifndef ACPI_USE_LOCAL_CACHE
1055 /*******************************************************************************
1057 * FUNCTION: acpi_os_create_cache
1059 * PARAMETERS: name - Ascii name for the cache
1060 * size - Size of each cached object
1061 * depth - Maximum depth of the cache (in objects) <ignored>
1062 * cache - Where the new cache object is returned
1066 * DESCRIPTION: Create a cache object
1068 ******************************************************************************/
1071 acpi_os_create_cache(char *name, u16 size, u16 depth, acpi_cache_t ** cache)
1073 *cache = kmem_cache_create(name, size, 0, 0, NULL, NULL);
1080 /*******************************************************************************
1082 * FUNCTION: acpi_os_purge_cache
1084 * PARAMETERS: Cache - Handle to cache object
1088 * DESCRIPTION: Free all objects within the requested cache.
1090 ******************************************************************************/
1092 acpi_status acpi_os_purge_cache(acpi_cache_t * cache)
1094 kmem_cache_shrink(cache);
1098 /*******************************************************************************
1100 * FUNCTION: acpi_os_delete_cache
1102 * PARAMETERS: Cache - Handle to cache object
1106 * DESCRIPTION: Free all objects within the requested cache and delete the
1109 ******************************************************************************/
1111 acpi_status acpi_os_delete_cache(acpi_cache_t * cache)
1113 kmem_cache_destroy(cache);
1117 /*******************************************************************************
1119 * FUNCTION: acpi_os_release_object
1121 * PARAMETERS: Cache - Handle to cache object
1122 * Object - The object to be released
1126 * DESCRIPTION: Release an object to the specified cache. If cache is full,
1127 * the object is deleted.
1129 ******************************************************************************/
1131 acpi_status acpi_os_release_object(acpi_cache_t * cache, void *object)
1133 kmem_cache_free(cache, object);
1137 /******************************************************************************
1139 * FUNCTION: acpi_os_validate_interface
1141 * PARAMETERS: interface - Requested interface to be validated
1143 * RETURN: AE_OK if interface is supported, AE_SUPPORT otherwise
1145 * DESCRIPTION: Match an interface string to the interfaces supported by the
1146 * host. Strings originate from an AML call to the _OSI method.
1148 *****************************************************************************/
1151 acpi_os_validate_interface (char *interface)
1158 /******************************************************************************
1160 * FUNCTION: acpi_os_validate_address
1162 * PARAMETERS: space_id - ACPI space ID
1163 * address - Physical address
1164 * length - Address length
1166 * RETURN: AE_OK if address/length is valid for the space_id. Otherwise,
1167 * should return AE_AML_ILLEGAL_ADDRESS.
1169 * DESCRIPTION: Validate a system address via the host OS. Used to validate
1170 * the addresses accessed by AML operation regions.
1172 *****************************************************************************/
1175 acpi_os_validate_address (
1177 acpi_physical_address address,