Linux Audio

Check our new training course

Loading...
v5.9
   1// SPDX-License-Identifier: GPL-2.0-or-later
   2/*
   3 *  acpi_osl.c - OS-dependent functions ($Revision: 83 $)
   4 *
   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>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  10 */
  11
  12#include <linux/module.h>
  13#include <linux/kernel.h>
  14#include <linux/slab.h>
  15#include <linux/mm.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>
  30#include <linux/security.h>
  31
  32#include <asm/io.h>
  33#include <linux/uaccess.h>
  34#include <linux/io-64-nonatomic-lo-hi.h>
  35
  36#include "acpica/accommon.h"
  37#include "acpica/acnamesp.h"
  38#include "internal.h"
  39
  40#define _COMPONENT		ACPI_OS_SERVICES
  41ACPI_MODULE_NAME("osl");
  42
  43struct acpi_os_dpc {
  44	acpi_osd_exec_callback function;
  45	void *context;
  46	struct work_struct work;
 
  47};
  48
 
 
 
 
  49#ifdef ENABLE_DEBUGGER
  50#include <linux/kdb.h>
  51
  52/* stuff for debugger support */
  53int acpi_in_debugger;
  54EXPORT_SYMBOL(acpi_in_debugger);
 
 
  55#endif				/*ENABLE_DEBUGGER */
  56
  57static int (*__acpi_os_prepare_sleep)(u8 sleep_state, u32 pm1a_ctrl,
  58				      u32 pm1b_ctrl);
  59static int (*__acpi_os_prepare_extended_sleep)(u8 sleep_state, u32 val_a,
  60				      u32 val_b);
  61
  62static acpi_osd_handler acpi_irq_handler;
  63static void *acpi_irq_context;
  64static struct workqueue_struct *kacpid_wq;
  65static struct workqueue_struct *kacpi_notify_wq;
  66static struct workqueue_struct *kacpi_hotplug_wq;
  67static bool acpi_os_initialized;
  68unsigned int acpi_sci_irq = INVALID_ACPI_IRQ;
  69bool acpi_permanent_mmap = false;
  70
  71/*
  72 * This list of permanent mappings is for memory that may be accessed from
  73 * interrupt context, where we can't do the ioremap().
  74 */
  75struct acpi_ioremap {
  76	struct list_head list;
  77	void __iomem *virt;
  78	acpi_physical_address phys;
  79	acpi_size size;
  80	union {
  81		unsigned long refcount;
  82		struct rcu_work rwork;
  83	} track;
  84};
  85
  86static LIST_HEAD(acpi_ioremaps);
  87static DEFINE_MUTEX(acpi_ioremap_lock);
  88#define acpi_ioremap_lock_held() lock_is_held(&acpi_ioremap_lock.dep_map)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
  89
  90static void __init acpi_request_region (struct acpi_generic_address *gas,
  91	unsigned int length, char *desc)
  92{
  93	u64 addr;
  94
  95	/* Handle possible alignment issues */
  96	memcpy(&addr, &gas->address, sizeof(addr));
  97	if (!addr || !length)
  98		return;
  99
 100	/* Resources are never freed */
 101	if (gas->space_id == ACPI_ADR_SPACE_SYSTEM_IO)
 102		request_region(addr, length, desc);
 103	else if (gas->space_id == ACPI_ADR_SPACE_SYSTEM_MEMORY)
 104		request_mem_region(addr, length, desc);
 105}
 106
 107static int __init acpi_reserve_resources(void)
 108{
 109	acpi_request_region(&acpi_gbl_FADT.xpm1a_event_block, acpi_gbl_FADT.pm1_event_length,
 110		"ACPI PM1a_EVT_BLK");
 111
 112	acpi_request_region(&acpi_gbl_FADT.xpm1b_event_block, acpi_gbl_FADT.pm1_event_length,
 113		"ACPI PM1b_EVT_BLK");
 114
 115	acpi_request_region(&acpi_gbl_FADT.xpm1a_control_block, acpi_gbl_FADT.pm1_control_length,
 116		"ACPI PM1a_CNT_BLK");
 117
 118	acpi_request_region(&acpi_gbl_FADT.xpm1b_control_block, acpi_gbl_FADT.pm1_control_length,
 119		"ACPI PM1b_CNT_BLK");
 120
 121	if (acpi_gbl_FADT.pm_timer_length == 4)
 122		acpi_request_region(&acpi_gbl_FADT.xpm_timer_block, 4, "ACPI PM_TMR");
 123
 124	acpi_request_region(&acpi_gbl_FADT.xpm2_control_block, acpi_gbl_FADT.pm2_control_length,
 125		"ACPI PM2_CNT_BLK");
 126
 127	/* Length of GPE blocks must be a non-negative multiple of 2 */
 128
 129	if (!(acpi_gbl_FADT.gpe0_block_length & 0x1))
 130		acpi_request_region(&acpi_gbl_FADT.xgpe0_block,
 131			       acpi_gbl_FADT.gpe0_block_length, "ACPI GPE0_BLK");
 132
 133	if (!(acpi_gbl_FADT.gpe1_block_length & 0x1))
 134		acpi_request_region(&acpi_gbl_FADT.xgpe1_block,
 135			       acpi_gbl_FADT.gpe1_block_length, "ACPI GPE1_BLK");
 136
 137	return 0;
 138}
 139fs_initcall_sync(acpi_reserve_resources);
 140
 141void acpi_os_printf(const char *fmt, ...)
 142{
 143	va_list args;
 144	va_start(args, fmt);
 145	acpi_os_vprintf(fmt, args);
 146	va_end(args);
 147}
 148EXPORT_SYMBOL(acpi_os_printf);
 149
 150void acpi_os_vprintf(const char *fmt, va_list args)
 151{
 152	static char buffer[512];
 153
 154	vsprintf(buffer, fmt, args);
 155
 156#ifdef ENABLE_DEBUGGER
 157	if (acpi_in_debugger) {
 158		kdb_printf("%s", buffer);
 159	} else {
 160		if (printk_get_level(buffer))
 161			printk("%s", buffer);
 162		else
 163			printk(KERN_CONT "%s", buffer);
 164	}
 165#else
 166	if (acpi_debugger_write_log(buffer) < 0) {
 167		if (printk_get_level(buffer))
 168			printk("%s", buffer);
 169		else
 170			printk(KERN_CONT "%s", buffer);
 171	}
 172#endif
 173}
 174
 175#ifdef CONFIG_KEXEC
 176static unsigned long acpi_rsdp;
 177static int __init setup_acpi_rsdp(char *arg)
 178{
 179	return kstrtoul(arg, 16, &acpi_rsdp);
 
 180}
 181early_param("acpi_rsdp", setup_acpi_rsdp);
 182#endif
 183
 184acpi_physical_address __init acpi_os_get_root_pointer(void)
 185{
 186	acpi_physical_address pa;
 187
 188#ifdef CONFIG_KEXEC
 189	/*
 190	 * We may have been provided with an RSDP on the command line,
 191	 * but if a malicious user has done so they may be pointing us
 192	 * at modified ACPI tables that could alter kernel behaviour -
 193	 * so, we check the lockdown status before making use of
 194	 * it. If we trust it then also stash it in an architecture
 195	 * specific location (if appropriate) so it can be carried
 196	 * over further kexec()s.
 197	 */
 198	if (acpi_rsdp && !security_locked_down(LOCKDOWN_ACPI_TABLES)) {
 199		acpi_arch_set_root_pointer(acpi_rsdp);
 200		return acpi_rsdp;
 201	}
 202#endif
 203	pa = acpi_arch_get_root_pointer();
 204	if (pa)
 205		return pa;
 206
 207	if (efi_enabled(EFI_CONFIG_TABLES)) {
 208		if (efi.acpi20 != EFI_INVALID_TABLE_ADDR)
 209			return efi.acpi20;
 210		if (efi.acpi != EFI_INVALID_TABLE_ADDR)
 211			return efi.acpi;
 212		pr_err(PREFIX "System description tables not found\n");
 213	} else if (IS_ENABLED(CONFIG_ACPI_LEGACY_TABLES_LOOKUP)) {
 
 
 
 
 
 
 214		acpi_find_root_pointer(&pa);
 
 215	}
 216
 217	return pa;
 218}
 219
 220/* Must be called with 'acpi_ioremap_lock' or RCU read lock held. */
 221static struct acpi_ioremap *
 222acpi_map_lookup(acpi_physical_address phys, acpi_size size)
 223{
 224	struct acpi_ioremap *map;
 225
 226	list_for_each_entry_rcu(map, &acpi_ioremaps, list, acpi_ioremap_lock_held())
 227		if (map->phys <= phys &&
 228		    phys + size <= map->phys + map->size)
 229			return map;
 230
 231	return NULL;
 232}
 233
 234/* Must be called with 'acpi_ioremap_lock' or RCU read lock held. */
 235static void __iomem *
 236acpi_map_vaddr_lookup(acpi_physical_address phys, unsigned int size)
 237{
 238	struct acpi_ioremap *map;
 239
 240	map = acpi_map_lookup(phys, size);
 241	if (map)
 242		return map->virt + (phys - map->phys);
 243
 244	return NULL;
 245}
 246
 247void __iomem *acpi_os_get_iomem(acpi_physical_address phys, unsigned int size)
 248{
 249	struct acpi_ioremap *map;
 250	void __iomem *virt = NULL;
 251
 252	mutex_lock(&acpi_ioremap_lock);
 253	map = acpi_map_lookup(phys, size);
 254	if (map) {
 255		virt = map->virt + (phys - map->phys);
 256		map->track.refcount++;
 257	}
 258	mutex_unlock(&acpi_ioremap_lock);
 259	return virt;
 260}
 261EXPORT_SYMBOL_GPL(acpi_os_get_iomem);
 262
 263/* Must be called with 'acpi_ioremap_lock' or RCU read lock held. */
 264static struct acpi_ioremap *
 265acpi_map_lookup_virt(void __iomem *virt, acpi_size size)
 266{
 267	struct acpi_ioremap *map;
 268
 269	list_for_each_entry_rcu(map, &acpi_ioremaps, list, acpi_ioremap_lock_held())
 270		if (map->virt <= virt &&
 271		    virt + size <= map->virt + map->size)
 272			return map;
 273
 274	return NULL;
 275}
 276
 277#if defined(CONFIG_IA64) || defined(CONFIG_ARM64)
 
 
 278/* ioremap will take care of cache attributes */
 279#define should_use_kmap(pfn)   0
 280#else
 281#define should_use_kmap(pfn)   page_is_ram(pfn)
 282#endif
 283
 284static void __iomem *acpi_map(acpi_physical_address pg_off, unsigned long pg_sz)
 285{
 286	unsigned long pfn;
 287
 288	pfn = pg_off >> PAGE_SHIFT;
 289	if (should_use_kmap(pfn)) {
 290		if (pg_sz > PAGE_SIZE)
 291			return NULL;
 292		return (void __iomem __force *)kmap(pfn_to_page(pfn));
 293	} else
 294		return acpi_os_ioremap(pg_off, pg_sz);
 295}
 296
 297static void acpi_unmap(acpi_physical_address pg_off, void __iomem *vaddr)
 298{
 299	unsigned long pfn;
 300
 301	pfn = pg_off >> PAGE_SHIFT;
 302	if (should_use_kmap(pfn))
 303		kunmap(pfn_to_page(pfn));
 304	else
 305		iounmap(vaddr);
 306}
 307
 308/**
 309 * acpi_os_map_iomem - Get a virtual address for a given physical address range.
 310 * @phys: Start of the physical address range to map.
 311 * @size: Size of the physical address range to map.
 312 *
 313 * Look up the given physical address range in the list of existing ACPI memory
 314 * mappings.  If found, get a reference to it and return a pointer to it (its
 315 * virtual address).  If not found, map it, add it to that list and return a
 316 * pointer to it.
 317 *
 318 * During early init (when acpi_permanent_mmap has not been set yet) this
 319 * routine simply calls __acpi_map_table() to get the job done.
 320 */
 321void __iomem __ref
 322*acpi_os_map_iomem(acpi_physical_address phys, acpi_size size)
 323{
 324	struct acpi_ioremap *map;
 325	void __iomem *virt;
 326	acpi_physical_address pg_off;
 327	acpi_size pg_sz;
 328
 329	if (phys > ULONG_MAX) {
 330		printk(KERN_ERR PREFIX "Cannot map memory that high\n");
 331		return NULL;
 332	}
 333
 334	if (!acpi_permanent_mmap)
 335		return __acpi_map_table((unsigned long)phys, size);
 336
 337	mutex_lock(&acpi_ioremap_lock);
 338	/* Check if there's a suitable mapping already. */
 339	map = acpi_map_lookup(phys, size);
 340	if (map) {
 341		map->track.refcount++;
 342		goto out;
 343	}
 344
 345	map = kzalloc(sizeof(*map), GFP_KERNEL);
 346	if (!map) {
 347		mutex_unlock(&acpi_ioremap_lock);
 348		return NULL;
 349	}
 350
 351	pg_off = round_down(phys, PAGE_SIZE);
 352	pg_sz = round_up(phys + size, PAGE_SIZE) - pg_off;
 353	virt = acpi_map(phys, size);
 354	if (!virt) {
 355		mutex_unlock(&acpi_ioremap_lock);
 356		kfree(map);
 357		return NULL;
 358	}
 359
 360	INIT_LIST_HEAD(&map->list);
 361	map->virt = (void __iomem __force *)((unsigned long)virt & PAGE_MASK);
 362	map->phys = pg_off;
 363	map->size = pg_sz;
 364	map->track.refcount = 1;
 365
 366	list_add_tail_rcu(&map->list, &acpi_ioremaps);
 367
 368out:
 369	mutex_unlock(&acpi_ioremap_lock);
 370	return map->virt + (phys - map->phys);
 371}
 372EXPORT_SYMBOL_GPL(acpi_os_map_iomem);
 373
 374void *__ref acpi_os_map_memory(acpi_physical_address phys, acpi_size size)
 375{
 376	return (void *)acpi_os_map_iomem(phys, size);
 377}
 378EXPORT_SYMBOL_GPL(acpi_os_map_memory);
 379
 380static void acpi_os_map_remove(struct work_struct *work)
 381{
 382	struct acpi_ioremap *map = container_of(to_rcu_work(work),
 383						struct acpi_ioremap,
 384						track.rwork);
 385
 386	acpi_unmap(map->phys, map->virt);
 387	kfree(map);
 388}
 389
 390/* Must be called with mutex_lock(&acpi_ioremap_lock) */
 391static void acpi_os_drop_map_ref(struct acpi_ioremap *map)
 392{
 393	if (--map->track.refcount)
 394		return;
 395
 396	list_del_rcu(&map->list);
 397
 398	INIT_RCU_WORK(&map->track.rwork, acpi_os_map_remove);
 399	queue_rcu_work(system_wq, &map->track.rwork);
 400}
 401
 402/**
 403 * acpi_os_unmap_iomem - Drop a memory mapping reference.
 404 * @virt: Start of the address range to drop a reference to.
 405 * @size: Size of the address range to drop a reference to.
 406 *
 407 * Look up the given virtual address range in the list of existing ACPI memory
 408 * mappings, drop a reference to it and if there are no more active references
 409 * to it, queue it up for later removal.
 410 *
 411 * During early init (when acpi_permanent_mmap has not been set yet) this
 412 * routine simply calls __acpi_unmap_table() to get the job done.  Since
 413 * __acpi_unmap_table() is an __init function, the __ref annotation is needed
 414 * here.
 415 */
 416void __ref acpi_os_unmap_iomem(void __iomem *virt, acpi_size size)
 417{
 418	struct acpi_ioremap *map;
 419
 420	if (!acpi_permanent_mmap) {
 421		__acpi_unmap_table(virt, size);
 422		return;
 423	}
 424
 425	mutex_lock(&acpi_ioremap_lock);
 426
 427	map = acpi_map_lookup_virt(virt, size);
 428	if (!map) {
 429		mutex_unlock(&acpi_ioremap_lock);
 430		WARN(true, PREFIX "%s: bad address %p\n", __func__, virt);
 431		return;
 432	}
 433	acpi_os_drop_map_ref(map);
 434
 435	mutex_unlock(&acpi_ioremap_lock);
 
 
 436}
 437EXPORT_SYMBOL_GPL(acpi_os_unmap_iomem);
 438
 439/**
 440 * acpi_os_unmap_memory - Drop a memory mapping reference.
 441 * @virt: Start of the address range to drop a reference to.
 442 * @size: Size of the address range to drop a reference to.
 443 */
 444void __ref acpi_os_unmap_memory(void *virt, acpi_size size)
 445{
 446	acpi_os_unmap_iomem((void __iomem *)virt, size);
 
 447}
 448EXPORT_SYMBOL_GPL(acpi_os_unmap_memory);
 449
 450int acpi_os_map_generic_address(struct acpi_generic_address *gas)
 451{
 452	u64 addr;
 453	void __iomem *virt;
 454
 455	if (gas->space_id != ACPI_ADR_SPACE_SYSTEM_MEMORY)
 456		return 0;
 457
 458	/* Handle possible alignment issues */
 459	memcpy(&addr, &gas->address, sizeof(addr));
 460	if (!addr || !gas->bit_width)
 461		return -EINVAL;
 462
 463	virt = acpi_os_map_iomem(addr, gas->bit_width / 8);
 464	if (!virt)
 465		return -EIO;
 466
 467	return 0;
 468}
 469EXPORT_SYMBOL(acpi_os_map_generic_address);
 470
 471void acpi_os_unmap_generic_address(struct acpi_generic_address *gas)
 472{
 473	u64 addr;
 474	struct acpi_ioremap *map;
 475
 476	if (gas->space_id != ACPI_ADR_SPACE_SYSTEM_MEMORY)
 477		return;
 478
 479	/* Handle possible alignment issues */
 480	memcpy(&addr, &gas->address, sizeof(addr));
 481	if (!addr || !gas->bit_width)
 482		return;
 483
 484	mutex_lock(&acpi_ioremap_lock);
 485
 486	map = acpi_map_lookup(addr, gas->bit_width / 8);
 487	if (!map) {
 488		mutex_unlock(&acpi_ioremap_lock);
 489		return;
 490	}
 491	acpi_os_drop_map_ref(map);
 492
 493	mutex_unlock(&acpi_ioremap_lock);
 
 
 494}
 495EXPORT_SYMBOL(acpi_os_unmap_generic_address);
 496
 497#ifdef ACPI_FUTURE_USAGE
 498acpi_status
 499acpi_os_get_physical_address(void *virt, acpi_physical_address * phys)
 500{
 501	if (!phys || !virt)
 502		return AE_BAD_PARAMETER;
 503
 504	*phys = virt_to_phys(virt);
 505
 506	return AE_OK;
 507}
 508#endif
 509
 510#ifdef CONFIG_ACPI_REV_OVERRIDE_POSSIBLE
 511static bool acpi_rev_override;
 512
 513int __init acpi_rev_override_setup(char *str)
 514{
 515	acpi_rev_override = true;
 516	return 1;
 517}
 518__setup("acpi_rev_override", acpi_rev_override_setup);
 519#else
 520#define acpi_rev_override	false
 521#endif
 522
 523#define ACPI_MAX_OVERRIDE_LEN 100
 524
 525static char acpi_os_name[ACPI_MAX_OVERRIDE_LEN];
 526
 527acpi_status
 528acpi_os_predefined_override(const struct acpi_predefined_names *init_val,
 529			    acpi_string *new_val)
 530{
 531	if (!init_val || !new_val)
 532		return AE_BAD_PARAMETER;
 533
 534	*new_val = NULL;
 535	if (!memcmp(init_val->name, "_OS_", 4) && strlen(acpi_os_name)) {
 536		printk(KERN_INFO PREFIX "Overriding _OS definition to '%s'\n",
 537		       acpi_os_name);
 538		*new_val = acpi_os_name;
 539	}
 540
 541	if (!memcmp(init_val->name, "_REV", 4) && acpi_rev_override) {
 542		printk(KERN_INFO PREFIX "Overriding _REV return value to 5\n");
 543		*new_val = (char *)5;
 544	}
 545
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 546	return AE_OK;
 547}
 548
 
 
 
 
 
 
 
 
 
 549static irqreturn_t acpi_irq(int irq, void *dev_id)
 550{
 551	u32 handled;
 552
 553	handled = (*acpi_irq_handler) (acpi_irq_context);
 554
 555	if (handled) {
 556		acpi_irq_handled++;
 557		return IRQ_HANDLED;
 558	} else {
 559		acpi_irq_not_handled++;
 560		return IRQ_NONE;
 561	}
 562}
 563
 564acpi_status
 565acpi_os_install_interrupt_handler(u32 gsi, acpi_osd_handler handler,
 566				  void *context)
 567{
 568	unsigned int irq;
 569
 570	acpi_irq_stats_init();
 571
 572	/*
 573	 * ACPI interrupts different from the SCI in our copy of the FADT are
 574	 * not supported.
 575	 */
 576	if (gsi != acpi_gbl_FADT.sci_interrupt)
 577		return AE_BAD_PARAMETER;
 578
 579	if (acpi_irq_handler)
 580		return AE_ALREADY_ACQUIRED;
 581
 582	if (acpi_gsi_to_irq(gsi, &irq) < 0) {
 583		printk(KERN_ERR PREFIX "SCI (ACPI GSI %d) not registered\n",
 584		       gsi);
 585		return AE_OK;
 586	}
 587
 588	acpi_irq_handler = handler;
 589	acpi_irq_context = context;
 590	if (request_irq(irq, acpi_irq, IRQF_SHARED, "acpi", acpi_irq)) {
 591		printk(KERN_ERR PREFIX "SCI (IRQ%d) allocation failed\n", irq);
 592		acpi_irq_handler = NULL;
 593		return AE_NOT_ACQUIRED;
 594	}
 595	acpi_sci_irq = irq;
 596
 597	return AE_OK;
 598}
 599
 600acpi_status acpi_os_remove_interrupt_handler(u32 gsi, acpi_osd_handler handler)
 601{
 602	if (gsi != acpi_gbl_FADT.sci_interrupt || !acpi_sci_irq_valid())
 603		return AE_BAD_PARAMETER;
 604
 605	free_irq(acpi_sci_irq, acpi_irq);
 606	acpi_irq_handler = NULL;
 607	acpi_sci_irq = INVALID_ACPI_IRQ;
 608
 609	return AE_OK;
 610}
 611
 612/*
 613 * Running in interpreter thread context, safe to sleep
 614 */
 615
 616void acpi_os_sleep(u64 ms)
 617{
 618	msleep(ms);
 619}
 620
 621void acpi_os_stall(u32 us)
 622{
 623	while (us) {
 624		u32 delay = 1000;
 625
 626		if (delay > us)
 627			delay = us;
 628		udelay(delay);
 629		touch_nmi_watchdog();
 630		us -= delay;
 631	}
 632}
 633
 634/*
 635 * Support ACPI 3.0 AML Timer operand. Returns a 64-bit free-running,
 636 * monotonically increasing timer with 100ns granularity. Do not use
 637 * ktime_get() to implement this function because this function may get
 638 * called after timekeeping has been suspended. Note: calling this function
 639 * after timekeeping has been suspended may lead to unexpected results
 640 * because when timekeeping is suspended the jiffies counter is not
 641 * incremented. See also timekeeping_suspend().
 642 */
 643u64 acpi_os_get_timer(void)
 644{
 645	return (get_jiffies_64() - INITIAL_JIFFIES) *
 646		(ACPI_100NSEC_PER_SEC / HZ);
 
 
 
 
 
 
 
 
 
 
 
 647}
 648
 649acpi_status acpi_os_read_port(acpi_io_address port, u32 * value, u32 width)
 650{
 651	u32 dummy;
 652
 653	if (!value)
 654		value = &dummy;
 655
 656	*value = 0;
 657	if (width <= 8) {
 658		*(u8 *) value = inb(port);
 659	} else if (width <= 16) {
 660		*(u16 *) value = inw(port);
 661	} else if (width <= 32) {
 662		*(u32 *) value = inl(port);
 663	} else {
 664		BUG();
 665	}
 666
 667	return AE_OK;
 668}
 669
 670EXPORT_SYMBOL(acpi_os_read_port);
 671
 672acpi_status acpi_os_write_port(acpi_io_address port, u32 value, u32 width)
 673{
 674	if (width <= 8) {
 675		outb(value, port);
 676	} else if (width <= 16) {
 677		outw(value, port);
 678	} else if (width <= 32) {
 679		outl(value, port);
 680	} else {
 681		BUG();
 682	}
 683
 684	return AE_OK;
 685}
 686
 687EXPORT_SYMBOL(acpi_os_write_port);
 688
 689int acpi_os_read_iomem(void __iomem *virt_addr, u64 *value, u32 width)
 
 690{
 691
 692	switch (width) {
 693	case 8:
 694		*(u8 *) value = readb(virt_addr);
 695		break;
 696	case 16:
 697		*(u16 *) value = readw(virt_addr);
 698		break;
 699	case 32:
 700		*(u32 *) value = readl(virt_addr);
 701		break;
 702	case 64:
 703		*(u64 *) value = readq(virt_addr);
 704		break;
 705	default:
 706		return -EINVAL;
 707	}
 708
 709	return 0;
 710}
 
 
 
 
 
 
 
 
 
 711
 712acpi_status
 713acpi_os_read_memory(acpi_physical_address phys_addr, u64 *value, u32 width)
 714{
 715	void __iomem *virt_addr;
 716	unsigned int size = width / 8;
 717	bool unmap = false;
 718	u64 dummy;
 719	int error;
 720
 721	rcu_read_lock();
 722	virt_addr = acpi_map_vaddr_lookup(phys_addr, size);
 723	if (!virt_addr) {
 724		rcu_read_unlock();
 725		virt_addr = acpi_os_ioremap(phys_addr, size);
 726		if (!virt_addr)
 727			return AE_BAD_ADDRESS;
 728		unmap = true;
 729	}
 730
 731	if (!value)
 732		value = &dummy;
 733
 734	error = acpi_os_read_iomem(virt_addr, value, width);
 735	BUG_ON(error);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 736
 737	if (unmap)
 738		iounmap(virt_addr);
 739	else
 740		rcu_read_unlock();
 741
 742	return AE_OK;
 743}
 744
 
 
 
 
 
 
 
 
 
 
 
 
 
 745acpi_status
 746acpi_os_write_memory(acpi_physical_address phys_addr, u64 value, u32 width)
 747{
 748	void __iomem *virt_addr;
 749	unsigned int size = width / 8;
 750	bool unmap = false;
 751
 752	rcu_read_lock();
 753	virt_addr = acpi_map_vaddr_lookup(phys_addr, size);
 754	if (!virt_addr) {
 755		rcu_read_unlock();
 756		virt_addr = acpi_os_ioremap(phys_addr, size);
 757		if (!virt_addr)
 758			return AE_BAD_ADDRESS;
 759		unmap = true;
 760	}
 761
 762	switch (width) {
 763	case 8:
 764		writeb(value, virt_addr);
 765		break;
 766	case 16:
 767		writew(value, virt_addr);
 768		break;
 769	case 32:
 770		writel(value, virt_addr);
 771		break;
 772	case 64:
 773		writeq(value, virt_addr);
 774		break;
 775	default:
 776		BUG();
 777	}
 778
 779	if (unmap)
 780		iounmap(virt_addr);
 781	else
 782		rcu_read_unlock();
 783
 784	return AE_OK;
 785}
 786
 787#ifdef CONFIG_PCI
 788acpi_status
 789acpi_os_read_pci_configuration(struct acpi_pci_id * pci_id, u32 reg,
 790			       u64 *value, u32 width)
 791{
 792	int result, size;
 793	u32 value32;
 794
 795	if (!value)
 796		return AE_BAD_PARAMETER;
 797
 798	switch (width) {
 799	case 8:
 800		size = 1;
 801		break;
 802	case 16:
 803		size = 2;
 804		break;
 805	case 32:
 806		size = 4;
 807		break;
 808	default:
 809		return AE_ERROR;
 810	}
 811
 812	result = raw_pci_read(pci_id->segment, pci_id->bus,
 813				PCI_DEVFN(pci_id->device, pci_id->function),
 814				reg, size, &value32);
 815	*value = value32;
 816
 817	return (result ? AE_ERROR : AE_OK);
 818}
 819
 820acpi_status
 821acpi_os_write_pci_configuration(struct acpi_pci_id * pci_id, u32 reg,
 822				u64 value, u32 width)
 823{
 824	int result, size;
 825
 826	switch (width) {
 827	case 8:
 828		size = 1;
 829		break;
 830	case 16:
 831		size = 2;
 832		break;
 833	case 32:
 834		size = 4;
 835		break;
 836	default:
 837		return AE_ERROR;
 838	}
 839
 840	result = raw_pci_write(pci_id->segment, pci_id->bus,
 841				PCI_DEVFN(pci_id->device, pci_id->function),
 842				reg, size, value);
 843
 844	return (result ? AE_ERROR : AE_OK);
 845}
 846#endif
 847
 848static void acpi_os_execute_deferred(struct work_struct *work)
 849{
 850	struct acpi_os_dpc *dpc = container_of(work, struct acpi_os_dpc, work);
 851
 
 
 
 852	dpc->function(dpc->context);
 853	kfree(dpc);
 854}
 855
 856#ifdef CONFIG_ACPI_DEBUGGER
 857static struct acpi_debugger acpi_debugger;
 858static bool acpi_debugger_initialized;
 859
 860int acpi_register_debugger(struct module *owner,
 861			   const struct acpi_debugger_ops *ops)
 862{
 863	int ret = 0;
 864
 865	mutex_lock(&acpi_debugger.lock);
 866	if (acpi_debugger.ops) {
 867		ret = -EBUSY;
 868		goto err_lock;
 869	}
 870
 871	acpi_debugger.owner = owner;
 872	acpi_debugger.ops = ops;
 873
 874err_lock:
 875	mutex_unlock(&acpi_debugger.lock);
 876	return ret;
 877}
 878EXPORT_SYMBOL(acpi_register_debugger);
 879
 880void acpi_unregister_debugger(const struct acpi_debugger_ops *ops)
 881{
 882	mutex_lock(&acpi_debugger.lock);
 883	if (ops == acpi_debugger.ops) {
 884		acpi_debugger.ops = NULL;
 885		acpi_debugger.owner = NULL;
 886	}
 887	mutex_unlock(&acpi_debugger.lock);
 888}
 889EXPORT_SYMBOL(acpi_unregister_debugger);
 890
 891int acpi_debugger_create_thread(acpi_osd_exec_callback function, void *context)
 892{
 893	int ret;
 894	int (*func)(acpi_osd_exec_callback, void *);
 895	struct module *owner;
 896
 897	if (!acpi_debugger_initialized)
 898		return -ENODEV;
 899	mutex_lock(&acpi_debugger.lock);
 900	if (!acpi_debugger.ops) {
 901		ret = -ENODEV;
 902		goto err_lock;
 903	}
 904	if (!try_module_get(acpi_debugger.owner)) {
 905		ret = -ENODEV;
 906		goto err_lock;
 907	}
 908	func = acpi_debugger.ops->create_thread;
 909	owner = acpi_debugger.owner;
 910	mutex_unlock(&acpi_debugger.lock);
 911
 912	ret = func(function, context);
 913
 914	mutex_lock(&acpi_debugger.lock);
 915	module_put(owner);
 916err_lock:
 917	mutex_unlock(&acpi_debugger.lock);
 918	return ret;
 919}
 920
 921ssize_t acpi_debugger_write_log(const char *msg)
 922{
 923	ssize_t ret;
 924	ssize_t (*func)(const char *);
 925	struct module *owner;
 926
 927	if (!acpi_debugger_initialized)
 928		return -ENODEV;
 929	mutex_lock(&acpi_debugger.lock);
 930	if (!acpi_debugger.ops) {
 931		ret = -ENODEV;
 932		goto err_lock;
 933	}
 934	if (!try_module_get(acpi_debugger.owner)) {
 935		ret = -ENODEV;
 936		goto err_lock;
 937	}
 938	func = acpi_debugger.ops->write_log;
 939	owner = acpi_debugger.owner;
 940	mutex_unlock(&acpi_debugger.lock);
 941
 942	ret = func(msg);
 943
 944	mutex_lock(&acpi_debugger.lock);
 945	module_put(owner);
 946err_lock:
 947	mutex_unlock(&acpi_debugger.lock);
 948	return ret;
 949}
 950
 951ssize_t acpi_debugger_read_cmd(char *buffer, size_t buffer_length)
 952{
 953	ssize_t ret;
 954	ssize_t (*func)(char *, size_t);
 955	struct module *owner;
 956
 957	if (!acpi_debugger_initialized)
 958		return -ENODEV;
 959	mutex_lock(&acpi_debugger.lock);
 960	if (!acpi_debugger.ops) {
 961		ret = -ENODEV;
 962		goto err_lock;
 963	}
 964	if (!try_module_get(acpi_debugger.owner)) {
 965		ret = -ENODEV;
 966		goto err_lock;
 967	}
 968	func = acpi_debugger.ops->read_cmd;
 969	owner = acpi_debugger.owner;
 970	mutex_unlock(&acpi_debugger.lock);
 971
 972	ret = func(buffer, buffer_length);
 973
 974	mutex_lock(&acpi_debugger.lock);
 975	module_put(owner);
 976err_lock:
 977	mutex_unlock(&acpi_debugger.lock);
 978	return ret;
 979}
 980
 981int acpi_debugger_wait_command_ready(void)
 982{
 983	int ret;
 984	int (*func)(bool, char *, size_t);
 985	struct module *owner;
 986
 987	if (!acpi_debugger_initialized)
 988		return -ENODEV;
 989	mutex_lock(&acpi_debugger.lock);
 990	if (!acpi_debugger.ops) {
 991		ret = -ENODEV;
 992		goto err_lock;
 993	}
 994	if (!try_module_get(acpi_debugger.owner)) {
 995		ret = -ENODEV;
 996		goto err_lock;
 997	}
 998	func = acpi_debugger.ops->wait_command_ready;
 999	owner = acpi_debugger.owner;
1000	mutex_unlock(&acpi_debugger.lock);
1001
1002	ret = func(acpi_gbl_method_executing,
1003		   acpi_gbl_db_line_buf, ACPI_DB_LINE_BUFFER_SIZE);
1004
1005	mutex_lock(&acpi_debugger.lock);
1006	module_put(owner);
1007err_lock:
1008	mutex_unlock(&acpi_debugger.lock);
1009	return ret;
1010}
1011
1012int acpi_debugger_notify_command_complete(void)
1013{
1014	int ret;
1015	int (*func)(void);
1016	struct module *owner;
1017
1018	if (!acpi_debugger_initialized)
1019		return -ENODEV;
1020	mutex_lock(&acpi_debugger.lock);
1021	if (!acpi_debugger.ops) {
1022		ret = -ENODEV;
1023		goto err_lock;
1024	}
1025	if (!try_module_get(acpi_debugger.owner)) {
1026		ret = -ENODEV;
1027		goto err_lock;
1028	}
1029	func = acpi_debugger.ops->notify_command_complete;
1030	owner = acpi_debugger.owner;
1031	mutex_unlock(&acpi_debugger.lock);
1032
1033	ret = func();
1034
1035	mutex_lock(&acpi_debugger.lock);
1036	module_put(owner);
1037err_lock:
1038	mutex_unlock(&acpi_debugger.lock);
1039	return ret;
1040}
1041
1042int __init acpi_debugger_init(void)
1043{
1044	mutex_init(&acpi_debugger.lock);
1045	acpi_debugger_initialized = true;
1046	return 0;
1047}
1048#endif
1049
1050/*******************************************************************************
1051 *
1052 * FUNCTION:    acpi_os_execute
1053 *
1054 * PARAMETERS:  Type               - Type of the callback
1055 *              Function           - Function to be executed
1056 *              Context            - Function parameters
1057 *
1058 * RETURN:      Status
1059 *
1060 * DESCRIPTION: Depending on type, either queues function for deferred execution or
1061 *              immediately executes function on a separate thread.
1062 *
1063 ******************************************************************************/
1064
1065acpi_status acpi_os_execute(acpi_execute_type type,
1066			    acpi_osd_exec_callback function, void *context)
1067{
1068	acpi_status status = AE_OK;
1069	struct acpi_os_dpc *dpc;
1070	struct workqueue_struct *queue;
1071	int ret;
1072	ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
1073			  "Scheduling function [%p(%p)] for deferred execution.\n",
1074			  function, context));
1075
1076	if (type == OSL_DEBUGGER_MAIN_THREAD) {
1077		ret = acpi_debugger_create_thread(function, context);
1078		if (ret) {
1079			pr_err("Call to kthread_create() failed.\n");
1080			status = AE_ERROR;
1081		}
1082		goto out_thread;
1083	}
1084
1085	/*
1086	 * Allocate/initialize DPC structure.  Note that this memory will be
1087	 * freed by the callee.  The kernel handles the work_struct list  in a
1088	 * way that allows us to also free its memory inside the callee.
1089	 * Because we may want to schedule several tasks with different
1090	 * parameters we can't use the approach some kernel code uses of
1091	 * having a static work_struct.
1092	 */
1093
1094	dpc = kzalloc(sizeof(struct acpi_os_dpc), GFP_ATOMIC);
1095	if (!dpc)
1096		return AE_NO_MEMORY;
1097
1098	dpc->function = function;
1099	dpc->context = context;
1100
1101	/*
1102	 * To prevent lockdep from complaining unnecessarily, make sure that
1103	 * there is a different static lockdep key for each workqueue by using
1104	 * INIT_WORK() for each of them separately.
 
1105	 */
1106	if (type == OSL_NOTIFY_HANDLER) {
1107		queue = kacpi_notify_wq;
 
 
 
1108		INIT_WORK(&dpc->work, acpi_os_execute_deferred);
1109	} else if (type == OSL_GPE_HANDLER) {
1110		queue = kacpid_wq;
 
1111		INIT_WORK(&dpc->work, acpi_os_execute_deferred);
1112	} else {
1113		pr_err("Unsupported os_execute type %d.\n", type);
1114		status = AE_ERROR;
1115	}
1116
1117	if (ACPI_FAILURE(status))
1118		goto err_workqueue;
1119
1120	/*
1121	 * On some machines, a software-initiated SMI causes corruption unless
1122	 * the SMI runs on CPU 0.  An SMI can be initiated by any AML, but
1123	 * typically it's done in GPE-related methods that are run via
1124	 * workqueues, so we can avoid the known corruption cases by always
1125	 * queueing on CPU 0.
1126	 */
1127	ret = queue_work_on(0, queue, &dpc->work);
 
1128	if (!ret) {
1129		printk(KERN_ERR PREFIX
1130			  "Call to queue_work() failed.\n");
1131		status = AE_ERROR;
1132	}
1133err_workqueue:
1134	if (ACPI_FAILURE(status))
1135		kfree(dpc);
1136out_thread:
1137	return status;
1138}
1139EXPORT_SYMBOL(acpi_os_execute);
1140
1141void acpi_os_wait_events_complete(void)
 
1142{
1143	/*
1144	 * Make sure the GPE handler or the fixed event handler is not used
1145	 * on another CPU after removal.
1146	 */
1147	if (acpi_sci_irq_valid())
1148		synchronize_hardirq(acpi_sci_irq);
1149	flush_workqueue(kacpid_wq);
1150	flush_workqueue(kacpi_notify_wq);
1151}
1152EXPORT_SYMBOL(acpi_os_wait_events_complete);
1153
1154struct acpi_hp_work {
1155	struct work_struct work;
1156	struct acpi_device *adev;
1157	u32 src;
1158};
1159
1160static void acpi_hotplug_work_fn(struct work_struct *work)
 
1161{
1162	struct acpi_hp_work *hpw = container_of(work, struct acpi_hp_work, work);
1163
1164	acpi_os_wait_events_complete();
1165	acpi_device_hotplug(hpw->adev, hpw->src);
1166	kfree(hpw);
1167}
1168
1169acpi_status acpi_hotplug_schedule(struct acpi_device *adev, u32 src)
1170{
1171	struct acpi_hp_work *hpw;
1172
1173	ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
1174		  "Scheduling hotplug event (%p, %u) for deferred execution.\n",
1175		  adev, src));
1176
1177	hpw = kmalloc(sizeof(*hpw), GFP_KERNEL);
1178	if (!hpw)
1179		return AE_NO_MEMORY;
1180
1181	INIT_WORK(&hpw->work, acpi_hotplug_work_fn);
1182	hpw->adev = adev;
1183	hpw->src = src;
1184	/*
1185	 * We can't run hotplug code in kacpid_wq/kacpid_notify_wq etc., because
1186	 * the hotplug code may call driver .remove() functions, which may
1187	 * invoke flush_scheduled_work()/acpi_os_wait_events_complete() to flush
1188	 * these workqueues.
1189	 */
1190	if (!queue_work(kacpi_hotplug_wq, &hpw->work)) {
1191		kfree(hpw);
1192		return AE_ERROR;
1193	}
1194	return AE_OK;
1195}
1196
1197bool acpi_queue_hotplug_work(struct work_struct *work)
1198{
1199	return queue_work(kacpi_hotplug_wq, work);
1200}
1201
1202acpi_status
1203acpi_os_create_semaphore(u32 max_units, u32 initial_units, acpi_handle * handle)
1204{
1205	struct semaphore *sem = NULL;
1206
1207	sem = acpi_os_allocate_zeroed(sizeof(struct semaphore));
1208	if (!sem)
1209		return AE_NO_MEMORY;
 
1210
1211	sema_init(sem, initial_units);
1212
1213	*handle = (acpi_handle *) sem;
1214
1215	ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Creating semaphore[%p|%d].\n",
1216			  *handle, initial_units));
1217
1218	return AE_OK;
1219}
1220
1221/*
1222 * TODO: A better way to delete semaphores?  Linux doesn't have a
1223 * 'delete_semaphore()' function -- may result in an invalid
1224 * pointer dereference for non-synchronized consumers.	Should
1225 * we at least check for blocked threads and signal/cancel them?
1226 */
1227
1228acpi_status acpi_os_delete_semaphore(acpi_handle handle)
1229{
1230	struct semaphore *sem = (struct semaphore *)handle;
1231
1232	if (!sem)
1233		return AE_BAD_PARAMETER;
1234
1235	ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Deleting semaphore[%p].\n", handle));
1236
1237	BUG_ON(!list_empty(&sem->wait_list));
1238	kfree(sem);
1239	sem = NULL;
1240
1241	return AE_OK;
1242}
1243
1244/*
1245 * TODO: Support for units > 1?
1246 */
1247acpi_status acpi_os_wait_semaphore(acpi_handle handle, u32 units, u16 timeout)
1248{
1249	acpi_status status = AE_OK;
1250	struct semaphore *sem = (struct semaphore *)handle;
1251	long jiffies;
1252	int ret = 0;
1253
1254	if (!acpi_os_initialized)
1255		return AE_OK;
1256
1257	if (!sem || (units < 1))
1258		return AE_BAD_PARAMETER;
1259
1260	if (units > 1)
1261		return AE_SUPPORT;
1262
1263	ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Waiting for semaphore[%p|%d|%d]\n",
1264			  handle, units, timeout));
1265
1266	if (timeout == ACPI_WAIT_FOREVER)
1267		jiffies = MAX_SCHEDULE_TIMEOUT;
1268	else
1269		jiffies = msecs_to_jiffies(timeout);
1270
1271	ret = down_timeout(sem, jiffies);
1272	if (ret)
1273		status = AE_TIME;
1274
1275	if (ACPI_FAILURE(status)) {
1276		ACPI_DEBUG_PRINT((ACPI_DB_MUTEX,
1277				  "Failed to acquire semaphore[%p|%d|%d], %s",
1278				  handle, units, timeout,
1279				  acpi_format_exception(status)));
1280	} else {
1281		ACPI_DEBUG_PRINT((ACPI_DB_MUTEX,
1282				  "Acquired semaphore[%p|%d|%d]", handle,
1283				  units, timeout));
1284	}
1285
1286	return status;
1287}
1288
1289/*
1290 * TODO: Support for units > 1?
1291 */
1292acpi_status acpi_os_signal_semaphore(acpi_handle handle, u32 units)
1293{
1294	struct semaphore *sem = (struct semaphore *)handle;
1295
1296	if (!acpi_os_initialized)
1297		return AE_OK;
1298
1299	if (!sem || (units < 1))
1300		return AE_BAD_PARAMETER;
1301
1302	if (units > 1)
1303		return AE_SUPPORT;
1304
1305	ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Signaling semaphore[%p|%d]\n", handle,
1306			  units));
1307
1308	up(sem);
1309
1310	return AE_OK;
1311}
1312
1313acpi_status acpi_os_get_line(char *buffer, u32 buffer_length, u32 *bytes_read)
 
1314{
 
1315#ifdef ENABLE_DEBUGGER
1316	if (acpi_in_debugger) {
1317		u32 chars;
1318
1319		kdb_read(buffer, buffer_length);
1320
1321		/* remove the CR kdb includes */
1322		chars = strlen(buffer) - 1;
1323		buffer[chars] = '\0';
1324	}
1325#else
1326	int ret;
1327
1328	ret = acpi_debugger_read_cmd(buffer, buffer_length);
1329	if (ret < 0)
1330		return AE_ERROR;
1331	if (bytes_read)
1332		*bytes_read = ret;
1333#endif
1334
1335	return AE_OK;
1336}
1337EXPORT_SYMBOL(acpi_os_get_line);
1338
1339acpi_status acpi_os_wait_command_ready(void)
1340{
1341	int ret;
1342
1343	ret = acpi_debugger_wait_command_ready();
1344	if (ret < 0)
1345		return AE_ERROR;
1346	return AE_OK;
1347}
1348
1349acpi_status acpi_os_notify_command_complete(void)
1350{
1351	int ret;
1352
1353	ret = acpi_debugger_notify_command_complete();
1354	if (ret < 0)
1355		return AE_ERROR;
1356	return AE_OK;
1357}
 
1358
1359acpi_status acpi_os_signal(u32 function, void *info)
1360{
1361	switch (function) {
1362	case ACPI_SIGNAL_FATAL:
1363		printk(KERN_ERR PREFIX "Fatal opcode executed\n");
1364		break;
1365	case ACPI_SIGNAL_BREAKPOINT:
1366		/*
1367		 * AML Breakpoint
1368		 * ACPI spec. says to treat it as a NOP unless
1369		 * you are debugging.  So if/when we integrate
1370		 * AML debugger into the kernel debugger its
1371		 * hook will go here.  But until then it is
1372		 * not useful to print anything on breakpoints.
1373		 */
1374		break;
1375	default:
1376		break;
1377	}
1378
1379	return AE_OK;
1380}
1381
1382static int __init acpi_os_name_setup(char *str)
1383{
1384	char *p = acpi_os_name;
1385	int count = ACPI_MAX_OVERRIDE_LEN - 1;
1386
1387	if (!str || !*str)
1388		return 0;
1389
1390	for (; count-- && *str; str++) {
1391		if (isalnum(*str) || *str == ' ' || *str == ':')
1392			*p++ = *str;
1393		else if (*str == '\'' || *str == '"')
1394			continue;
1395		else
1396			break;
1397	}
1398	*p = 0;
1399
1400	return 1;
1401
1402}
1403
1404__setup("acpi_os_name=", acpi_os_name_setup);
1405
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1406/*
1407 * Disable the auto-serialization of named objects creation methods.
1408 *
1409 * This feature is enabled by default.  It marks the AML control methods
1410 * that contain the opcodes to create named objects as "Serialized".
 
1411 */
1412static int __init acpi_no_auto_serialize_setup(char *str)
1413{
1414	acpi_gbl_auto_serialize_methods = FALSE;
1415	pr_info("ACPI: auto-serialization disabled\n");
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1416
1417	return 1;
1418}
1419
1420__setup("acpi_no_auto_serialize", acpi_no_auto_serialize_setup);
1421
1422/* Check of resource interference between native drivers and ACPI
1423 * OperationRegions (SystemIO and System Memory only).
1424 * IO ports and memory declared in ACPI might be used by the ACPI subsystem
1425 * in arbitrary AML code and can interfere with legacy drivers.
1426 * acpi_enforce_resources= can be set to:
1427 *
1428 *   - strict (default) (2)
1429 *     -> further driver trying to access the resources will not load
1430 *   - lax              (1)
1431 *     -> further driver trying to access the resources will load, but you
1432 *     get a system message that something might go wrong...
1433 *
1434 *   - no               (0)
1435 *     -> ACPI Operation Region resources will not be registered
1436 *
1437 */
1438#define ENFORCE_RESOURCES_STRICT 2
1439#define ENFORCE_RESOURCES_LAX    1
1440#define ENFORCE_RESOURCES_NO     0
1441
1442static unsigned int acpi_enforce_resources = ENFORCE_RESOURCES_STRICT;
1443
1444static int __init acpi_enforce_resources_setup(char *str)
1445{
1446	if (str == NULL || *str == '\0')
1447		return 0;
1448
1449	if (!strcmp("strict", str))
1450		acpi_enforce_resources = ENFORCE_RESOURCES_STRICT;
1451	else if (!strcmp("lax", str))
1452		acpi_enforce_resources = ENFORCE_RESOURCES_LAX;
1453	else if (!strcmp("no", str))
1454		acpi_enforce_resources = ENFORCE_RESOURCES_NO;
1455
1456	return 1;
1457}
1458
1459__setup("acpi_enforce_resources=", acpi_enforce_resources_setup);
1460
1461/* Check for resource conflicts between ACPI OperationRegions and native
1462 * drivers */
1463int acpi_check_resource_conflict(const struct resource *res)
1464{
1465	acpi_adr_space_type space_id;
1466	acpi_size length;
1467	u8 warn = 0;
1468	int clash = 0;
1469
1470	if (acpi_enforce_resources == ENFORCE_RESOURCES_NO)
1471		return 0;
1472	if (!(res->flags & IORESOURCE_IO) && !(res->flags & IORESOURCE_MEM))
1473		return 0;
1474
1475	if (res->flags & IORESOURCE_IO)
1476		space_id = ACPI_ADR_SPACE_SYSTEM_IO;
1477	else
1478		space_id = ACPI_ADR_SPACE_SYSTEM_MEMORY;
1479
1480	length = resource_size(res);
1481	if (acpi_enforce_resources != ENFORCE_RESOURCES_NO)
1482		warn = 1;
1483	clash = acpi_check_address_range(space_id, res->start, length, warn);
1484
1485	if (clash) {
1486		if (acpi_enforce_resources != ENFORCE_RESOURCES_NO) {
1487			if (acpi_enforce_resources == ENFORCE_RESOURCES_LAX)
1488				printk(KERN_NOTICE "ACPI: This conflict may"
1489				       " cause random problems and system"
1490				       " instability\n");
1491			printk(KERN_INFO "ACPI: If an ACPI driver is available"
1492			       " for this device, you should use it instead of"
1493			       " the native driver\n");
1494		}
1495		if (acpi_enforce_resources == ENFORCE_RESOURCES_STRICT)
1496			return -EBUSY;
1497	}
1498	return 0;
1499}
1500EXPORT_SYMBOL(acpi_check_resource_conflict);
1501
1502int acpi_check_region(resource_size_t start, resource_size_t n,
1503		      const char *name)
1504{
1505	struct resource res = {
1506		.start = start,
1507		.end   = start + n - 1,
1508		.name  = name,
1509		.flags = IORESOURCE_IO,
1510	};
1511
1512	return acpi_check_resource_conflict(&res);
1513}
1514EXPORT_SYMBOL(acpi_check_region);
1515
1516static acpi_status acpi_deactivate_mem_region(acpi_handle handle, u32 level,
1517					      void *_res, void **return_value)
1518{
1519	struct acpi_mem_space_context **mem_ctx;
1520	union acpi_operand_object *handler_obj;
1521	union acpi_operand_object *region_obj2;
1522	union acpi_operand_object *region_obj;
1523	struct resource *res = _res;
1524	acpi_status status;
1525
1526	region_obj = acpi_ns_get_attached_object(handle);
1527	if (!region_obj)
1528		return AE_OK;
1529
1530	handler_obj = region_obj->region.handler;
1531	if (!handler_obj)
1532		return AE_OK;
1533
1534	if (region_obj->region.space_id != ACPI_ADR_SPACE_SYSTEM_MEMORY)
1535		return AE_OK;
1536
1537	if (!(region_obj->region.flags & AOPOBJ_SETUP_COMPLETE))
1538		return AE_OK;
1539
1540	region_obj2 = acpi_ns_get_secondary_object(region_obj);
1541	if (!region_obj2)
1542		return AE_OK;
1543
1544	mem_ctx = (void *)&region_obj2->extra.region_context;
1545
1546	if (!(mem_ctx[0]->address >= res->start &&
1547	      mem_ctx[0]->address < res->end))
1548		return AE_OK;
1549
1550	status = handler_obj->address_space.setup(region_obj,
1551						  ACPI_REGION_DEACTIVATE,
1552						  NULL, (void **)mem_ctx);
1553	if (ACPI_SUCCESS(status))
1554		region_obj->region.flags &= ~(AOPOBJ_SETUP_COMPLETE);
1555
1556	return status;
1557}
1558
1559/**
1560 * acpi_release_memory - Release any mappings done to a memory region
1561 * @handle: Handle to namespace node
1562 * @res: Memory resource
1563 * @level: A level that terminates the search
1564 *
1565 * Walks through @handle and unmaps all SystemMemory Operation Regions that
1566 * overlap with @res and that have already been activated (mapped).
1567 *
1568 * This is a helper that allows drivers to place special requirements on memory
1569 * region that may overlap with operation regions, primarily allowing them to
1570 * safely map the region as non-cached memory.
1571 *
1572 * The unmapped Operation Regions will be automatically remapped next time they
1573 * are called, so the drivers do not need to do anything else.
1574 */
1575acpi_status acpi_release_memory(acpi_handle handle, struct resource *res,
1576				u32 level)
1577{
1578	acpi_status status;
1579
1580	if (!(res->flags & IORESOURCE_MEM))
1581		return AE_TYPE;
1582
1583	status = acpi_walk_namespace(ACPI_TYPE_REGION, handle, level,
1584				     acpi_deactivate_mem_region, NULL,
1585				     res, NULL);
1586	if (ACPI_FAILURE(status))
1587		return status;
1588
1589	/*
1590	 * Wait for all of the mappings queued up for removal by
1591	 * acpi_deactivate_mem_region() to actually go away.
1592	 */
1593	synchronize_rcu();
1594	rcu_barrier();
1595	flush_scheduled_work();
1596
1597	return AE_OK;
1598}
1599EXPORT_SYMBOL_GPL(acpi_release_memory);
1600
1601/*
1602 * Let drivers know whether the resource checks are effective
1603 */
1604int acpi_resources_are_enforced(void)
1605{
1606	return acpi_enforce_resources == ENFORCE_RESOURCES_STRICT;
1607}
1608EXPORT_SYMBOL(acpi_resources_are_enforced);
1609
1610/*
1611 * Deallocate the memory for a spinlock.
1612 */
1613void acpi_os_delete_lock(acpi_spinlock handle)
1614{
1615	ACPI_FREE(handle);
1616}
1617
1618/*
1619 * Acquire a spinlock.
1620 *
1621 * handle is a pointer to the spinlock_t.
1622 */
1623
1624acpi_cpu_flags acpi_os_acquire_lock(acpi_spinlock lockp)
1625	__acquires(lockp)
1626{
1627	acpi_cpu_flags flags;
1628	spin_lock_irqsave(lockp, flags);
1629	return flags;
1630}
1631
1632/*
1633 * Release a spinlock. See above.
1634 */
1635
1636void acpi_os_release_lock(acpi_spinlock lockp, acpi_cpu_flags flags)
1637	__releases(lockp)
1638{
1639	spin_unlock_irqrestore(lockp, flags);
1640}
1641
1642#ifndef ACPI_USE_LOCAL_CACHE
1643
1644/*******************************************************************************
1645 *
1646 * FUNCTION:    acpi_os_create_cache
1647 *
1648 * PARAMETERS:  name      - Ascii name for the cache
1649 *              size      - Size of each cached object
1650 *              depth     - Maximum depth of the cache (in objects) <ignored>
1651 *              cache     - Where the new cache object is returned
1652 *
1653 * RETURN:      status
1654 *
1655 * DESCRIPTION: Create a cache object
1656 *
1657 ******************************************************************************/
1658
1659acpi_status
1660acpi_os_create_cache(char *name, u16 size, u16 depth, acpi_cache_t ** cache)
1661{
1662	*cache = kmem_cache_create(name, size, 0, 0, NULL);
1663	if (*cache == NULL)
1664		return AE_ERROR;
1665	else
1666		return AE_OK;
1667}
1668
1669/*******************************************************************************
1670 *
1671 * FUNCTION:    acpi_os_purge_cache
1672 *
1673 * PARAMETERS:  Cache           - Handle to cache object
1674 *
1675 * RETURN:      Status
1676 *
1677 * DESCRIPTION: Free all objects within the requested cache.
1678 *
1679 ******************************************************************************/
1680
1681acpi_status acpi_os_purge_cache(acpi_cache_t * cache)
1682{
1683	kmem_cache_shrink(cache);
1684	return (AE_OK);
1685}
1686
1687/*******************************************************************************
1688 *
1689 * FUNCTION:    acpi_os_delete_cache
1690 *
1691 * PARAMETERS:  Cache           - Handle to cache object
1692 *
1693 * RETURN:      Status
1694 *
1695 * DESCRIPTION: Free all objects within the requested cache and delete the
1696 *              cache object.
1697 *
1698 ******************************************************************************/
1699
1700acpi_status acpi_os_delete_cache(acpi_cache_t * cache)
1701{
1702	kmem_cache_destroy(cache);
1703	return (AE_OK);
1704}
1705
1706/*******************************************************************************
1707 *
1708 * FUNCTION:    acpi_os_release_object
1709 *
1710 * PARAMETERS:  Cache       - Handle to cache object
1711 *              Object      - The object to be released
1712 *
1713 * RETURN:      None
1714 *
1715 * DESCRIPTION: Release an object to the specified cache.  If cache is full,
1716 *              the object is deleted.
1717 *
1718 ******************************************************************************/
1719
1720acpi_status acpi_os_release_object(acpi_cache_t * cache, void *object)
1721{
1722	kmem_cache_free(cache, object);
1723	return (AE_OK);
1724}
1725#endif
1726
1727static int __init acpi_no_static_ssdt_setup(char *s)
1728{
1729	acpi_gbl_disable_ssdt_table_install = TRUE;
1730	pr_info("ACPI: static SSDT installation disabled\n");
1731
1732	return 0;
1733}
1734
1735early_param("acpi_no_static_ssdt", acpi_no_static_ssdt_setup);
1736
1737static int __init acpi_disable_return_repair(char *s)
1738{
1739	printk(KERN_NOTICE PREFIX
1740	       "ACPI: Predefined validation mechanism disabled\n");
1741	acpi_gbl_disable_auto_repair = TRUE;
1742
1743	return 1;
1744}
1745
1746__setup("acpica_no_return_repair", acpi_disable_return_repair);
1747
1748acpi_status __init acpi_os_initialize(void)
1749{
1750	acpi_os_map_generic_address(&acpi_gbl_FADT.xpm1a_event_block);
1751	acpi_os_map_generic_address(&acpi_gbl_FADT.xpm1b_event_block);
1752	acpi_os_map_generic_address(&acpi_gbl_FADT.xgpe0_block);
1753	acpi_os_map_generic_address(&acpi_gbl_FADT.xgpe1_block);
1754	if (acpi_gbl_FADT.flags & ACPI_FADT_RESET_REGISTER) {
1755		/*
1756		 * Use acpi_os_map_generic_address to pre-map the reset
1757		 * register if it's in system memory.
1758		 */
1759		int rv;
1760
1761		rv = acpi_os_map_generic_address(&acpi_gbl_FADT.reset_register);
1762		pr_debug(PREFIX "%s: map reset_reg status %d\n", __func__, rv);
1763	}
1764	acpi_os_initialized = true;
1765
1766	return AE_OK;
1767}
1768
1769acpi_status __init acpi_os_initialize1(void)
1770{
1771	kacpid_wq = alloc_workqueue("kacpid", 0, 1);
1772	kacpi_notify_wq = alloc_workqueue("kacpi_notify", 0, 1);
1773	kacpi_hotplug_wq = alloc_ordered_workqueue("kacpi_hotplug", 0);
1774	BUG_ON(!kacpid_wq);
1775	BUG_ON(!kacpi_notify_wq);
1776	BUG_ON(!kacpi_hotplug_wq);
1777	acpi_osi_init();
 
1778	return AE_OK;
1779}
1780
1781acpi_status acpi_os_terminate(void)
1782{
1783	if (acpi_irq_handler) {
1784		acpi_os_remove_interrupt_handler(acpi_gbl_FADT.sci_interrupt,
1785						 acpi_irq_handler);
1786	}
1787
1788	acpi_os_unmap_generic_address(&acpi_gbl_FADT.xgpe1_block);
1789	acpi_os_unmap_generic_address(&acpi_gbl_FADT.xgpe0_block);
1790	acpi_os_unmap_generic_address(&acpi_gbl_FADT.xpm1b_event_block);
1791	acpi_os_unmap_generic_address(&acpi_gbl_FADT.xpm1a_event_block);
1792	if (acpi_gbl_FADT.flags & ACPI_FADT_RESET_REGISTER)
1793		acpi_os_unmap_generic_address(&acpi_gbl_FADT.reset_register);
1794
1795	destroy_workqueue(kacpid_wq);
1796	destroy_workqueue(kacpi_notify_wq);
1797	destroy_workqueue(kacpi_hotplug_wq);
1798
1799	return AE_OK;
1800}
1801
1802acpi_status acpi_os_prepare_sleep(u8 sleep_state, u32 pm1a_control,
1803				  u32 pm1b_control)
1804{
1805	int rc = 0;
1806	if (__acpi_os_prepare_sleep)
1807		rc = __acpi_os_prepare_sleep(sleep_state,
1808					     pm1a_control, pm1b_control);
1809	if (rc < 0)
1810		return AE_ERROR;
1811	else if (rc > 0)
1812		return AE_CTRL_TERMINATE;
1813
1814	return AE_OK;
1815}
1816
1817void acpi_os_set_prepare_sleep(int (*func)(u8 sleep_state,
1818			       u32 pm1a_ctrl, u32 pm1b_ctrl))
1819{
1820	__acpi_os_prepare_sleep = func;
1821}
1822
1823#if (ACPI_REDUCED_HARDWARE)
1824acpi_status acpi_os_prepare_extended_sleep(u8 sleep_state, u32 val_a,
1825				  u32 val_b)
1826{
1827	int rc = 0;
1828	if (__acpi_os_prepare_extended_sleep)
1829		rc = __acpi_os_prepare_extended_sleep(sleep_state,
1830					     val_a, val_b);
1831	if (rc < 0)
1832		return AE_ERROR;
1833	else if (rc > 0)
1834		return AE_CTRL_TERMINATE;
1835
1836	return AE_OK;
1837}
1838#else
1839acpi_status acpi_os_prepare_extended_sleep(u8 sleep_state, u32 val_a,
1840				  u32 val_b)
1841{
1842	return AE_OK;
1843}
1844#endif
1845
1846void acpi_os_set_prepare_extended_sleep(int (*func)(u8 sleep_state,
1847			       u32 val_a, u32 val_b))
1848{
1849	__acpi_os_prepare_extended_sleep = func;
1850}
1851
1852acpi_status acpi_os_enter_sleep(u8 sleep_state,
1853				u32 reg_a_value, u32 reg_b_value)
1854{
1855	acpi_status status;
1856
1857	if (acpi_gbl_reduced_hardware)
1858		status = acpi_os_prepare_extended_sleep(sleep_state,
1859							reg_a_value,
1860							reg_b_value);
1861	else
1862		status = acpi_os_prepare_sleep(sleep_state,
1863					       reg_a_value, reg_b_value);
1864	return status;
1865}
v3.5.6
 
   1/*
   2 *  acpi_osl.c - OS-dependent functions ($Revision: 83 $)
   3 *
   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>
   7 *  Copyright (c) 2008 Intel Corporation
   8 *   Author: Matthew Wilcox <willy@linux.intel.com>
   9 *
  10 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  11 *
  12 *  This program is free software; you can redistribute it and/or modify
  13 *  it under the terms of the GNU General Public License as published by
  14 *  the Free Software Foundation; either version 2 of the License, or
  15 *  (at your option) any later version.
  16 *
  17 *  This program is distributed in the hope that it will be useful,
  18 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  19 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20 *  GNU General Public License for more details.
  21 *
  22 *  You should have received a copy of the GNU General Public License
  23 *  along with this program; if not, write to the Free Software
  24 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  25 *
  26 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  27 *
  28 */
  29
  30#include <linux/module.h>
  31#include <linux/kernel.h>
  32#include <linux/slab.h>
  33#include <linux/mm.h>
  34#include <linux/highmem.h>
 
  35#include <linux/pci.h>
  36#include <linux/interrupt.h>
  37#include <linux/kmod.h>
  38#include <linux/delay.h>
  39#include <linux/workqueue.h>
  40#include <linux/nmi.h>
  41#include <linux/acpi.h>
  42#include <linux/acpi_io.h>
  43#include <linux/efi.h>
  44#include <linux/ioport.h>
  45#include <linux/list.h>
  46#include <linux/jiffies.h>
  47#include <linux/semaphore.h>
 
  48
  49#include <asm/io.h>
  50#include <asm/uaccess.h>
 
  51
  52#include <acpi/acpi.h>
  53#include <acpi/acpi_bus.h>
  54#include <acpi/processor.h>
  55
  56#define _COMPONENT		ACPI_OS_SERVICES
  57ACPI_MODULE_NAME("osl");
  58#define PREFIX		"ACPI: "
  59struct acpi_os_dpc {
  60	acpi_osd_exec_callback function;
  61	void *context;
  62	struct work_struct work;
  63	int wait;
  64};
  65
  66#ifdef CONFIG_ACPI_CUSTOM_DSDT
  67#include CONFIG_ACPI_CUSTOM_DSDT_FILE
  68#endif
  69
  70#ifdef ENABLE_DEBUGGER
  71#include <linux/kdb.h>
  72
  73/* stuff for debugger support */
  74int acpi_in_debugger;
  75EXPORT_SYMBOL(acpi_in_debugger);
  76
  77extern char line_buf[80];
  78#endif				/*ENABLE_DEBUGGER */
  79
  80static int (*__acpi_os_prepare_sleep)(u8 sleep_state, u32 pm1a_ctrl,
  81				      u32 pm1b_ctrl);
 
 
  82
  83static acpi_osd_handler acpi_irq_handler;
  84static void *acpi_irq_context;
  85static struct workqueue_struct *kacpid_wq;
  86static struct workqueue_struct *kacpi_notify_wq;
  87struct workqueue_struct *kacpi_hotplug_wq;
  88EXPORT_SYMBOL(kacpi_hotplug_wq);
 
 
  89
  90/*
  91 * This list of permanent mappings is for memory that may be accessed from
  92 * interrupt context, where we can't do the ioremap().
  93 */
  94struct acpi_ioremap {
  95	struct list_head list;
  96	void __iomem *virt;
  97	acpi_physical_address phys;
  98	acpi_size size;
  99	unsigned long refcount;
 
 
 
 100};
 101
 102static LIST_HEAD(acpi_ioremaps);
 103static DEFINE_MUTEX(acpi_ioremap_lock);
 104
 105static void __init acpi_osi_setup_late(void);
 106
 107/*
 108 * The story of _OSI(Linux)
 109 *
 110 * From pre-history through Linux-2.6.22,
 111 * Linux responded TRUE upon a BIOS OSI(Linux) query.
 112 *
 113 * Unfortunately, reference BIOS writers got wind of this
 114 * and put OSI(Linux) in their example code, quickly exposing
 115 * this string as ill-conceived and opening the door to
 116 * an un-bounded number of BIOS incompatibilities.
 117 *
 118 * For example, OSI(Linux) was used on resume to re-POST a
 119 * video card on one system, because Linux at that time
 120 * could not do a speedy restore in its native driver.
 121 * But then upon gaining quick native restore capability,
 122 * Linux has no way to tell the BIOS to skip the time-consuming
 123 * POST -- putting Linux at a permanent performance disadvantage.
 124 * On another system, the BIOS writer used OSI(Linux)
 125 * to infer native OS support for IPMI!  On other systems,
 126 * OSI(Linux) simply got in the way of Linux claiming to
 127 * be compatible with other operating systems, exposing
 128 * BIOS issues such as skipped device initialization.
 129 *
 130 * So "Linux" turned out to be a really poor chose of
 131 * OSI string, and from Linux-2.6.23 onward we respond FALSE.
 132 *
 133 * BIOS writers should NOT query _OSI(Linux) on future systems.
 134 * Linux will complain on the console when it sees it, and return FALSE.
 135 * To get Linux to return TRUE for your system  will require
 136 * a kernel source update to add a DMI entry,
 137 * or boot with "acpi_osi=Linux"
 138 */
 139
 140static struct osi_linux {
 141	unsigned int	enable:1;
 142	unsigned int	dmi:1;
 143	unsigned int	cmdline:1;
 144} osi_linux = {0, 0, 0};
 145
 146static u32 acpi_osi_handler(acpi_string interface, u32 supported)
 147{
 148	if (!strcmp("Linux", interface)) {
 149
 150		printk_once(KERN_NOTICE FW_BUG PREFIX
 151			"BIOS _OSI(Linux) query %s%s\n",
 152			osi_linux.enable ? "honored" : "ignored",
 153			osi_linux.cmdline ? " via cmdline" :
 154			osi_linux.dmi ? " via DMI" : "");
 155	}
 156
 157	return supported;
 158}
 159
 160static void __init acpi_request_region (struct acpi_generic_address *gas,
 161	unsigned int length, char *desc)
 162{
 163	u64 addr;
 164
 165	/* Handle possible alignment issues */
 166	memcpy(&addr, &gas->address, sizeof(addr));
 167	if (!addr || !length)
 168		return;
 169
 170	/* Resources are never freed */
 171	if (gas->space_id == ACPI_ADR_SPACE_SYSTEM_IO)
 172		request_region(addr, length, desc);
 173	else if (gas->space_id == ACPI_ADR_SPACE_SYSTEM_MEMORY)
 174		request_mem_region(addr, length, desc);
 175}
 176
 177static int __init acpi_reserve_resources(void)
 178{
 179	acpi_request_region(&acpi_gbl_FADT.xpm1a_event_block, acpi_gbl_FADT.pm1_event_length,
 180		"ACPI PM1a_EVT_BLK");
 181
 182	acpi_request_region(&acpi_gbl_FADT.xpm1b_event_block, acpi_gbl_FADT.pm1_event_length,
 183		"ACPI PM1b_EVT_BLK");
 184
 185	acpi_request_region(&acpi_gbl_FADT.xpm1a_control_block, acpi_gbl_FADT.pm1_control_length,
 186		"ACPI PM1a_CNT_BLK");
 187
 188	acpi_request_region(&acpi_gbl_FADT.xpm1b_control_block, acpi_gbl_FADT.pm1_control_length,
 189		"ACPI PM1b_CNT_BLK");
 190
 191	if (acpi_gbl_FADT.pm_timer_length == 4)
 192		acpi_request_region(&acpi_gbl_FADT.xpm_timer_block, 4, "ACPI PM_TMR");
 193
 194	acpi_request_region(&acpi_gbl_FADT.xpm2_control_block, acpi_gbl_FADT.pm2_control_length,
 195		"ACPI PM2_CNT_BLK");
 196
 197	/* Length of GPE blocks must be a non-negative multiple of 2 */
 198
 199	if (!(acpi_gbl_FADT.gpe0_block_length & 0x1))
 200		acpi_request_region(&acpi_gbl_FADT.xgpe0_block,
 201			       acpi_gbl_FADT.gpe0_block_length, "ACPI GPE0_BLK");
 202
 203	if (!(acpi_gbl_FADT.gpe1_block_length & 0x1))
 204		acpi_request_region(&acpi_gbl_FADT.xgpe1_block,
 205			       acpi_gbl_FADT.gpe1_block_length, "ACPI GPE1_BLK");
 206
 207	return 0;
 208}
 209device_initcall(acpi_reserve_resources);
 210
 211void acpi_os_printf(const char *fmt, ...)
 212{
 213	va_list args;
 214	va_start(args, fmt);
 215	acpi_os_vprintf(fmt, args);
 216	va_end(args);
 217}
 
 218
 219void acpi_os_vprintf(const char *fmt, va_list args)
 220{
 221	static char buffer[512];
 222
 223	vsprintf(buffer, fmt, args);
 224
 225#ifdef ENABLE_DEBUGGER
 226	if (acpi_in_debugger) {
 227		kdb_printf("%s", buffer);
 228	} else {
 229		printk(KERN_CONT "%s", buffer);
 
 
 
 230	}
 231#else
 232	printk(KERN_CONT "%s", buffer);
 
 
 
 
 
 233#endif
 234}
 235
 236#ifdef CONFIG_KEXEC
 237static unsigned long acpi_rsdp;
 238static int __init setup_acpi_rsdp(char *arg)
 239{
 240	acpi_rsdp = simple_strtoul(arg, NULL, 16);
 241	return 0;
 242}
 243early_param("acpi_rsdp", setup_acpi_rsdp);
 244#endif
 245
 246acpi_physical_address __init acpi_os_get_root_pointer(void)
 247{
 
 
 248#ifdef CONFIG_KEXEC
 249	if (acpi_rsdp)
 
 
 
 
 
 
 
 
 
 
 250		return acpi_rsdp;
 
 251#endif
 
 
 
 252
 253	if (efi_enabled) {
 254		if (efi.acpi20 != EFI_INVALID_TABLE_ADDR)
 255			return efi.acpi20;
 256		else if (efi.acpi != EFI_INVALID_TABLE_ADDR)
 257			return efi.acpi;
 258		else {
 259			printk(KERN_ERR PREFIX
 260			       "System description tables not found\n");
 261			return 0;
 262		}
 263	} else {
 264		acpi_physical_address pa = 0;
 265
 266		acpi_find_root_pointer(&pa);
 267		return pa;
 268	}
 
 
 269}
 270
 271/* Must be called with 'acpi_ioremap_lock' or RCU read lock held. */
 272static struct acpi_ioremap *
 273acpi_map_lookup(acpi_physical_address phys, acpi_size size)
 274{
 275	struct acpi_ioremap *map;
 276
 277	list_for_each_entry_rcu(map, &acpi_ioremaps, list)
 278		if (map->phys <= phys &&
 279		    phys + size <= map->phys + map->size)
 280			return map;
 281
 282	return NULL;
 283}
 284
 285/* Must be called with 'acpi_ioremap_lock' or RCU read lock held. */
 286static void __iomem *
 287acpi_map_vaddr_lookup(acpi_physical_address phys, unsigned int size)
 288{
 289	struct acpi_ioremap *map;
 290
 291	map = acpi_map_lookup(phys, size);
 292	if (map)
 293		return map->virt + (phys - map->phys);
 294
 295	return NULL;
 296}
 297
 298void __iomem *acpi_os_get_iomem(acpi_physical_address phys, unsigned int size)
 299{
 300	struct acpi_ioremap *map;
 301	void __iomem *virt = NULL;
 302
 303	mutex_lock(&acpi_ioremap_lock);
 304	map = acpi_map_lookup(phys, size);
 305	if (map) {
 306		virt = map->virt + (phys - map->phys);
 307		map->refcount++;
 308	}
 309	mutex_unlock(&acpi_ioremap_lock);
 310	return virt;
 311}
 312EXPORT_SYMBOL_GPL(acpi_os_get_iomem);
 313
 314/* Must be called with 'acpi_ioremap_lock' or RCU read lock held. */
 315static struct acpi_ioremap *
 316acpi_map_lookup_virt(void __iomem *virt, acpi_size size)
 317{
 318	struct acpi_ioremap *map;
 319
 320	list_for_each_entry_rcu(map, &acpi_ioremaps, list)
 321		if (map->virt <= virt &&
 322		    virt + size <= map->virt + map->size)
 323			return map;
 324
 325	return NULL;
 326}
 327
 328#ifndef CONFIG_IA64
 329#define should_use_kmap(pfn)   page_is_ram(pfn)
 330#else
 331/* ioremap will take care of cache attributes */
 332#define should_use_kmap(pfn)   0
 
 
 333#endif
 334
 335static void __iomem *acpi_map(acpi_physical_address pg_off, unsigned long pg_sz)
 336{
 337	unsigned long pfn;
 338
 339	pfn = pg_off >> PAGE_SHIFT;
 340	if (should_use_kmap(pfn)) {
 341		if (pg_sz > PAGE_SIZE)
 342			return NULL;
 343		return (void __iomem __force *)kmap(pfn_to_page(pfn));
 344	} else
 345		return acpi_os_ioremap(pg_off, pg_sz);
 346}
 347
 348static void acpi_unmap(acpi_physical_address pg_off, void __iomem *vaddr)
 349{
 350	unsigned long pfn;
 351
 352	pfn = pg_off >> PAGE_SHIFT;
 353	if (should_use_kmap(pfn))
 354		kunmap(pfn_to_page(pfn));
 355	else
 356		iounmap(vaddr);
 357}
 358
 359void __iomem *__init_refok
 360acpi_os_map_memory(acpi_physical_address phys, acpi_size size)
 
 
 
 
 
 
 
 
 
 
 
 
 
 361{
 362	struct acpi_ioremap *map;
 363	void __iomem *virt;
 364	acpi_physical_address pg_off;
 365	acpi_size pg_sz;
 366
 367	if (phys > ULONG_MAX) {
 368		printk(KERN_ERR PREFIX "Cannot map memory that high\n");
 369		return NULL;
 370	}
 371
 372	if (!acpi_gbl_permanent_mmap)
 373		return __acpi_map_table((unsigned long)phys, size);
 374
 375	mutex_lock(&acpi_ioremap_lock);
 376	/* Check if there's a suitable mapping already. */
 377	map = acpi_map_lookup(phys, size);
 378	if (map) {
 379		map->refcount++;
 380		goto out;
 381	}
 382
 383	map = kzalloc(sizeof(*map), GFP_KERNEL);
 384	if (!map) {
 385		mutex_unlock(&acpi_ioremap_lock);
 386		return NULL;
 387	}
 388
 389	pg_off = round_down(phys, PAGE_SIZE);
 390	pg_sz = round_up(phys + size, PAGE_SIZE) - pg_off;
 391	virt = acpi_map(pg_off, pg_sz);
 392	if (!virt) {
 393		mutex_unlock(&acpi_ioremap_lock);
 394		kfree(map);
 395		return NULL;
 396	}
 397
 398	INIT_LIST_HEAD(&map->list);
 399	map->virt = virt;
 400	map->phys = pg_off;
 401	map->size = pg_sz;
 402	map->refcount = 1;
 403
 404	list_add_tail_rcu(&map->list, &acpi_ioremaps);
 405
 406 out:
 407	mutex_unlock(&acpi_ioremap_lock);
 408	return map->virt + (phys - map->phys);
 409}
 
 
 
 
 
 
 410EXPORT_SYMBOL_GPL(acpi_os_map_memory);
 411
 412static void acpi_os_drop_map_ref(struct acpi_ioremap *map)
 413{
 414	if (!--map->refcount)
 415		list_del_rcu(&map->list);
 
 
 
 
 416}
 417
 418static void acpi_os_map_cleanup(struct acpi_ioremap *map)
 
 419{
 420	if (!map->refcount) {
 421		synchronize_rcu();
 422		acpi_unmap(map->phys, map->virt);
 423		kfree(map);
 424	}
 
 
 425}
 426
 427void __ref acpi_os_unmap_memory(void __iomem *virt, acpi_size size)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 428{
 429	struct acpi_ioremap *map;
 430
 431	if (!acpi_gbl_permanent_mmap) {
 432		__acpi_unmap_table(virt, size);
 433		return;
 434	}
 435
 436	mutex_lock(&acpi_ioremap_lock);
 
 437	map = acpi_map_lookup_virt(virt, size);
 438	if (!map) {
 439		mutex_unlock(&acpi_ioremap_lock);
 440		WARN(true, PREFIX "%s: bad address %p\n", __func__, virt);
 441		return;
 442	}
 443	acpi_os_drop_map_ref(map);
 
 444	mutex_unlock(&acpi_ioremap_lock);
 445
 446	acpi_os_map_cleanup(map);
 447}
 448EXPORT_SYMBOL_GPL(acpi_os_unmap_memory);
 449
 450void __init early_acpi_os_unmap_memory(void __iomem *virt, acpi_size size)
 
 
 
 
 
 451{
 452	if (!acpi_gbl_permanent_mmap)
 453		__acpi_unmap_table(virt, size);
 454}
 
 455
 456int acpi_os_map_generic_address(struct acpi_generic_address *gas)
 457{
 458	u64 addr;
 459	void __iomem *virt;
 460
 461	if (gas->space_id != ACPI_ADR_SPACE_SYSTEM_MEMORY)
 462		return 0;
 463
 464	/* Handle possible alignment issues */
 465	memcpy(&addr, &gas->address, sizeof(addr));
 466	if (!addr || !gas->bit_width)
 467		return -EINVAL;
 468
 469	virt = acpi_os_map_memory(addr, gas->bit_width / 8);
 470	if (!virt)
 471		return -EIO;
 472
 473	return 0;
 474}
 475EXPORT_SYMBOL(acpi_os_map_generic_address);
 476
 477void acpi_os_unmap_generic_address(struct acpi_generic_address *gas)
 478{
 479	u64 addr;
 480	struct acpi_ioremap *map;
 481
 482	if (gas->space_id != ACPI_ADR_SPACE_SYSTEM_MEMORY)
 483		return;
 484
 485	/* Handle possible alignment issues */
 486	memcpy(&addr, &gas->address, sizeof(addr));
 487	if (!addr || !gas->bit_width)
 488		return;
 489
 490	mutex_lock(&acpi_ioremap_lock);
 
 491	map = acpi_map_lookup(addr, gas->bit_width / 8);
 492	if (!map) {
 493		mutex_unlock(&acpi_ioremap_lock);
 494		return;
 495	}
 496	acpi_os_drop_map_ref(map);
 
 497	mutex_unlock(&acpi_ioremap_lock);
 498
 499	acpi_os_map_cleanup(map);
 500}
 501EXPORT_SYMBOL(acpi_os_unmap_generic_address);
 502
 503#ifdef ACPI_FUTURE_USAGE
 504acpi_status
 505acpi_os_get_physical_address(void *virt, acpi_physical_address * phys)
 506{
 507	if (!phys || !virt)
 508		return AE_BAD_PARAMETER;
 509
 510	*phys = virt_to_phys(virt);
 511
 512	return AE_OK;
 513}
 514#endif
 515
 
 
 
 
 
 
 
 
 
 
 
 
 
 516#define ACPI_MAX_OVERRIDE_LEN 100
 517
 518static char acpi_os_name[ACPI_MAX_OVERRIDE_LEN];
 519
 520acpi_status
 521acpi_os_predefined_override(const struct acpi_predefined_names *init_val,
 522			    acpi_string * new_val)
 523{
 524	if (!init_val || !new_val)
 525		return AE_BAD_PARAMETER;
 526
 527	*new_val = NULL;
 528	if (!memcmp(init_val->name, "_OS_", 4) && strlen(acpi_os_name)) {
 529		printk(KERN_INFO PREFIX "Overriding _OS definition to '%s'\n",
 530		       acpi_os_name);
 531		*new_val = acpi_os_name;
 532	}
 533
 534	return AE_OK;
 535}
 
 
 536
 537acpi_status
 538acpi_os_table_override(struct acpi_table_header * existing_table,
 539		       struct acpi_table_header ** new_table)
 540{
 541	if (!existing_table || !new_table)
 542		return AE_BAD_PARAMETER;
 543
 544	*new_table = NULL;
 545
 546#ifdef CONFIG_ACPI_CUSTOM_DSDT
 547	if (strncmp(existing_table->signature, "DSDT", 4) == 0)
 548		*new_table = (struct acpi_table_header *)AmlCode;
 549#endif
 550	if (*new_table != NULL) {
 551		printk(KERN_WARNING PREFIX "Override [%4.4s-%8.8s], "
 552			   "this is unsafe: tainting kernel\n",
 553		       existing_table->signature,
 554		       existing_table->oem_table_id);
 555		add_taint(TAINT_OVERRIDDEN_ACPI_TABLE);
 556	}
 557	return AE_OK;
 558}
 559
 560acpi_status
 561acpi_os_physical_table_override(struct acpi_table_header *existing_table,
 562				acpi_physical_address * new_address,
 563				u32 *new_table_length)
 564{
 565	return AE_SUPPORT;
 566}
 567
 568
 569static irqreturn_t acpi_irq(int irq, void *dev_id)
 570{
 571	u32 handled;
 572
 573	handled = (*acpi_irq_handler) (acpi_irq_context);
 574
 575	if (handled) {
 576		acpi_irq_handled++;
 577		return IRQ_HANDLED;
 578	} else {
 579		acpi_irq_not_handled++;
 580		return IRQ_NONE;
 581	}
 582}
 583
 584acpi_status
 585acpi_os_install_interrupt_handler(u32 gsi, acpi_osd_handler handler,
 586				  void *context)
 587{
 588	unsigned int irq;
 589
 590	acpi_irq_stats_init();
 591
 592	/*
 593	 * ACPI interrupts different from the SCI in our copy of the FADT are
 594	 * not supported.
 595	 */
 596	if (gsi != acpi_gbl_FADT.sci_interrupt)
 597		return AE_BAD_PARAMETER;
 598
 599	if (acpi_irq_handler)
 600		return AE_ALREADY_ACQUIRED;
 601
 602	if (acpi_gsi_to_irq(gsi, &irq) < 0) {
 603		printk(KERN_ERR PREFIX "SCI (ACPI GSI %d) not registered\n",
 604		       gsi);
 605		return AE_OK;
 606	}
 607
 608	acpi_irq_handler = handler;
 609	acpi_irq_context = context;
 610	if (request_irq(irq, acpi_irq, IRQF_SHARED, "acpi", acpi_irq)) {
 611		printk(KERN_ERR PREFIX "SCI (IRQ%d) allocation failed\n", irq);
 612		acpi_irq_handler = NULL;
 613		return AE_NOT_ACQUIRED;
 614	}
 
 615
 616	return AE_OK;
 617}
 618
 619acpi_status acpi_os_remove_interrupt_handler(u32 irq, acpi_osd_handler handler)
 620{
 621	if (irq != acpi_gbl_FADT.sci_interrupt)
 622		return AE_BAD_PARAMETER;
 623
 624	free_irq(irq, acpi_irq);
 625	acpi_irq_handler = NULL;
 
 626
 627	return AE_OK;
 628}
 629
 630/*
 631 * Running in interpreter thread context, safe to sleep
 632 */
 633
 634void acpi_os_sleep(u64 ms)
 635{
 636	schedule_timeout_interruptible(msecs_to_jiffies(ms));
 637}
 638
 639void acpi_os_stall(u32 us)
 640{
 641	while (us) {
 642		u32 delay = 1000;
 643
 644		if (delay > us)
 645			delay = us;
 646		udelay(delay);
 647		touch_nmi_watchdog();
 648		us -= delay;
 649	}
 650}
 651
 652/*
 653 * Support ACPI 3.0 AML Timer operand
 654 * Returns 64-bit free-running, monotonically increasing timer
 655 * with 100ns granularity
 
 
 
 
 656 */
 657u64 acpi_os_get_timer(void)
 658{
 659	static u64 t;
 660
 661#ifdef	CONFIG_HPET
 662	/* TBD: use HPET if available */
 663#endif
 664
 665#ifdef	CONFIG_X86_PM_TIMER
 666	/* TBD: default to PM timer if HPET was not available */
 667#endif
 668	if (!t)
 669		printk(KERN_ERR PREFIX "acpi_os_get_timer() TBD\n");
 670
 671	return ++t;
 672}
 673
 674acpi_status acpi_os_read_port(acpi_io_address port, u32 * value, u32 width)
 675{
 676	u32 dummy;
 677
 678	if (!value)
 679		value = &dummy;
 680
 681	*value = 0;
 682	if (width <= 8) {
 683		*(u8 *) value = inb(port);
 684	} else if (width <= 16) {
 685		*(u16 *) value = inw(port);
 686	} else if (width <= 32) {
 687		*(u32 *) value = inl(port);
 688	} else {
 689		BUG();
 690	}
 691
 692	return AE_OK;
 693}
 694
 695EXPORT_SYMBOL(acpi_os_read_port);
 696
 697acpi_status acpi_os_write_port(acpi_io_address port, u32 value, u32 width)
 698{
 699	if (width <= 8) {
 700		outb(value, port);
 701	} else if (width <= 16) {
 702		outw(value, port);
 703	} else if (width <= 32) {
 704		outl(value, port);
 705	} else {
 706		BUG();
 707	}
 708
 709	return AE_OK;
 710}
 711
 712EXPORT_SYMBOL(acpi_os_write_port);
 713
 714#ifdef readq
 715static inline u64 read64(const volatile void __iomem *addr)
 716{
 717	return readq(addr);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 718}
 719#else
 720static inline u64 read64(const volatile void __iomem *addr)
 721{
 722	u64 l, h;
 723	l = readl(addr);
 724	h = readl(addr+4);
 725	return l | (h << 32);
 726}
 727#endif
 728
 729acpi_status
 730acpi_os_read_memory(acpi_physical_address phys_addr, u64 *value, u32 width)
 731{
 732	void __iomem *virt_addr;
 733	unsigned int size = width / 8;
 734	bool unmap = false;
 735	u64 dummy;
 
 736
 737	rcu_read_lock();
 738	virt_addr = acpi_map_vaddr_lookup(phys_addr, size);
 739	if (!virt_addr) {
 740		rcu_read_unlock();
 741		virt_addr = acpi_os_ioremap(phys_addr, size);
 742		if (!virt_addr)
 743			return AE_BAD_ADDRESS;
 744		unmap = true;
 745	}
 746
 747	if (!value)
 748		value = &dummy;
 749
 750	switch (width) {
 751	case 8:
 752		*(u8 *) value = readb(virt_addr);
 753		break;
 754	case 16:
 755		*(u16 *) value = readw(virt_addr);
 756		break;
 757	case 32:
 758		*(u32 *) value = readl(virt_addr);
 759		break;
 760	case 64:
 761		*(u64 *) value = read64(virt_addr);
 762		break;
 763	default:
 764		BUG();
 765	}
 766
 767	if (unmap)
 768		iounmap(virt_addr);
 769	else
 770		rcu_read_unlock();
 771
 772	return AE_OK;
 773}
 774
 775#ifdef writeq
 776static inline void write64(u64 val, volatile void __iomem *addr)
 777{
 778	writeq(val, addr);
 779}
 780#else
 781static inline void write64(u64 val, volatile void __iomem *addr)
 782{
 783	writel(val, addr);
 784	writel(val>>32, addr+4);
 785}
 786#endif
 787
 788acpi_status
 789acpi_os_write_memory(acpi_physical_address phys_addr, u64 value, u32 width)
 790{
 791	void __iomem *virt_addr;
 792	unsigned int size = width / 8;
 793	bool unmap = false;
 794
 795	rcu_read_lock();
 796	virt_addr = acpi_map_vaddr_lookup(phys_addr, size);
 797	if (!virt_addr) {
 798		rcu_read_unlock();
 799		virt_addr = acpi_os_ioremap(phys_addr, size);
 800		if (!virt_addr)
 801			return AE_BAD_ADDRESS;
 802		unmap = true;
 803	}
 804
 805	switch (width) {
 806	case 8:
 807		writeb(value, virt_addr);
 808		break;
 809	case 16:
 810		writew(value, virt_addr);
 811		break;
 812	case 32:
 813		writel(value, virt_addr);
 814		break;
 815	case 64:
 816		write64(value, virt_addr);
 817		break;
 818	default:
 819		BUG();
 820	}
 821
 822	if (unmap)
 823		iounmap(virt_addr);
 824	else
 825		rcu_read_unlock();
 826
 827	return AE_OK;
 828}
 829
 
 830acpi_status
 831acpi_os_read_pci_configuration(struct acpi_pci_id * pci_id, u32 reg,
 832			       u64 *value, u32 width)
 833{
 834	int result, size;
 835	u32 value32;
 836
 837	if (!value)
 838		return AE_BAD_PARAMETER;
 839
 840	switch (width) {
 841	case 8:
 842		size = 1;
 843		break;
 844	case 16:
 845		size = 2;
 846		break;
 847	case 32:
 848		size = 4;
 849		break;
 850	default:
 851		return AE_ERROR;
 852	}
 853
 854	result = raw_pci_read(pci_id->segment, pci_id->bus,
 855				PCI_DEVFN(pci_id->device, pci_id->function),
 856				reg, size, &value32);
 857	*value = value32;
 858
 859	return (result ? AE_ERROR : AE_OK);
 860}
 861
 862acpi_status
 863acpi_os_write_pci_configuration(struct acpi_pci_id * pci_id, u32 reg,
 864				u64 value, u32 width)
 865{
 866	int result, size;
 867
 868	switch (width) {
 869	case 8:
 870		size = 1;
 871		break;
 872	case 16:
 873		size = 2;
 874		break;
 875	case 32:
 876		size = 4;
 877		break;
 878	default:
 879		return AE_ERROR;
 880	}
 881
 882	result = raw_pci_write(pci_id->segment, pci_id->bus,
 883				PCI_DEVFN(pci_id->device, pci_id->function),
 884				reg, size, value);
 885
 886	return (result ? AE_ERROR : AE_OK);
 887}
 
 888
 889static void acpi_os_execute_deferred(struct work_struct *work)
 890{
 891	struct acpi_os_dpc *dpc = container_of(work, struct acpi_os_dpc, work);
 892
 893	if (dpc->wait)
 894		acpi_os_wait_events_complete(NULL);
 895
 896	dpc->function(dpc->context);
 897	kfree(dpc);
 898}
 899
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 900/*******************************************************************************
 901 *
 902 * FUNCTION:    acpi_os_execute
 903 *
 904 * PARAMETERS:  Type               - Type of the callback
 905 *              Function           - Function to be executed
 906 *              Context            - Function parameters
 907 *
 908 * RETURN:      Status
 909 *
 910 * DESCRIPTION: Depending on type, either queues function for deferred execution or
 911 *              immediately executes function on a separate thread.
 912 *
 913 ******************************************************************************/
 914
 915static acpi_status __acpi_os_execute(acpi_execute_type type,
 916	acpi_osd_exec_callback function, void *context, int hp)
 917{
 918	acpi_status status = AE_OK;
 919	struct acpi_os_dpc *dpc;
 920	struct workqueue_struct *queue;
 921	int ret;
 922	ACPI_DEBUG_PRINT((ACPI_DB_EXEC,
 923			  "Scheduling function [%p(%p)] for deferred execution.\n",
 924			  function, context));
 925
 
 
 
 
 
 
 
 
 
 926	/*
 927	 * Allocate/initialize DPC structure.  Note that this memory will be
 928	 * freed by the callee.  The kernel handles the work_struct list  in a
 929	 * way that allows us to also free its memory inside the callee.
 930	 * Because we may want to schedule several tasks with different
 931	 * parameters we can't use the approach some kernel code uses of
 932	 * having a static work_struct.
 933	 */
 934
 935	dpc = kmalloc(sizeof(struct acpi_os_dpc), GFP_ATOMIC);
 936	if (!dpc)
 937		return AE_NO_MEMORY;
 938
 939	dpc->function = function;
 940	dpc->context = context;
 941
 942	/*
 943	 * We can't run hotplug code in keventd_wq/kacpid_wq/kacpid_notify_wq
 944	 * because the hotplug code may call driver .remove() functions,
 945	 * which invoke flush_scheduled_work/acpi_os_wait_events_complete
 946	 * to flush these workqueues.
 947	 */
 948	queue = hp ? kacpi_hotplug_wq :
 949		(type == OSL_NOTIFY_HANDLER ? kacpi_notify_wq : kacpid_wq);
 950	dpc->wait = hp ? 1 : 0;
 951
 952	if (queue == kacpi_hotplug_wq)
 953		INIT_WORK(&dpc->work, acpi_os_execute_deferred);
 954	else if (queue == kacpi_notify_wq)
 955		INIT_WORK(&dpc->work, acpi_os_execute_deferred);
 956	else
 957		INIT_WORK(&dpc->work, acpi_os_execute_deferred);
 
 
 
 
 
 
 
 958
 959	/*
 960	 * On some machines, a software-initiated SMI causes corruption unless
 961	 * the SMI runs on CPU 0.  An SMI can be initiated by any AML, but
 962	 * typically it's done in GPE-related methods that are run via
 963	 * workqueues, so we can avoid the known corruption cases by always
 964	 * queueing on CPU 0.
 965	 */
 966	ret = queue_work_on(0, queue, &dpc->work);
 967
 968	if (!ret) {
 969		printk(KERN_ERR PREFIX
 970			  "Call to queue_work() failed.\n");
 971		status = AE_ERROR;
 
 
 
 972		kfree(dpc);
 973	}
 974	return status;
 975}
 
 976
 977acpi_status acpi_os_execute(acpi_execute_type type,
 978			    acpi_osd_exec_callback function, void *context)
 979{
 980	return __acpi_os_execute(type, function, context, 0);
 
 
 
 
 
 
 
 981}
 982EXPORT_SYMBOL(acpi_os_execute);
 
 
 
 
 
 
 983
 984acpi_status acpi_os_hotplug_execute(acpi_osd_exec_callback function,
 985	void *context)
 986{
 987	return __acpi_os_execute(0, function, context, 1);
 
 
 
 
 988}
 989
 990void acpi_os_wait_events_complete(void *context)
 991{
 992	flush_workqueue(kacpid_wq);
 993	flush_workqueue(kacpi_notify_wq);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 994}
 995
 996EXPORT_SYMBOL(acpi_os_wait_events_complete);
 
 
 
 997
 998acpi_status
 999acpi_os_create_semaphore(u32 max_units, u32 initial_units, acpi_handle * handle)
1000{
1001	struct semaphore *sem = NULL;
1002
1003	sem = acpi_os_allocate(sizeof(struct semaphore));
1004	if (!sem)
1005		return AE_NO_MEMORY;
1006	memset(sem, 0, sizeof(struct semaphore));
1007
1008	sema_init(sem, initial_units);
1009
1010	*handle = (acpi_handle *) sem;
1011
1012	ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Creating semaphore[%p|%d].\n",
1013			  *handle, initial_units));
1014
1015	return AE_OK;
1016}
1017
1018/*
1019 * TODO: A better way to delete semaphores?  Linux doesn't have a
1020 * 'delete_semaphore()' function -- may result in an invalid
1021 * pointer dereference for non-synchronized consumers.	Should
1022 * we at least check for blocked threads and signal/cancel them?
1023 */
1024
1025acpi_status acpi_os_delete_semaphore(acpi_handle handle)
1026{
1027	struct semaphore *sem = (struct semaphore *)handle;
1028
1029	if (!sem)
1030		return AE_BAD_PARAMETER;
1031
1032	ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Deleting semaphore[%p].\n", handle));
1033
1034	BUG_ON(!list_empty(&sem->wait_list));
1035	kfree(sem);
1036	sem = NULL;
1037
1038	return AE_OK;
1039}
1040
1041/*
1042 * TODO: Support for units > 1?
1043 */
1044acpi_status acpi_os_wait_semaphore(acpi_handle handle, u32 units, u16 timeout)
1045{
1046	acpi_status status = AE_OK;
1047	struct semaphore *sem = (struct semaphore *)handle;
1048	long jiffies;
1049	int ret = 0;
1050
 
 
 
1051	if (!sem || (units < 1))
1052		return AE_BAD_PARAMETER;
1053
1054	if (units > 1)
1055		return AE_SUPPORT;
1056
1057	ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Waiting for semaphore[%p|%d|%d]\n",
1058			  handle, units, timeout));
1059
1060	if (timeout == ACPI_WAIT_FOREVER)
1061		jiffies = MAX_SCHEDULE_TIMEOUT;
1062	else
1063		jiffies = msecs_to_jiffies(timeout);
1064	
1065	ret = down_timeout(sem, jiffies);
1066	if (ret)
1067		status = AE_TIME;
1068
1069	if (ACPI_FAILURE(status)) {
1070		ACPI_DEBUG_PRINT((ACPI_DB_MUTEX,
1071				  "Failed to acquire semaphore[%p|%d|%d], %s",
1072				  handle, units, timeout,
1073				  acpi_format_exception(status)));
1074	} else {
1075		ACPI_DEBUG_PRINT((ACPI_DB_MUTEX,
1076				  "Acquired semaphore[%p|%d|%d]", handle,
1077				  units, timeout));
1078	}
1079
1080	return status;
1081}
1082
1083/*
1084 * TODO: Support for units > 1?
1085 */
1086acpi_status acpi_os_signal_semaphore(acpi_handle handle, u32 units)
1087{
1088	struct semaphore *sem = (struct semaphore *)handle;
1089
 
 
 
1090	if (!sem || (units < 1))
1091		return AE_BAD_PARAMETER;
1092
1093	if (units > 1)
1094		return AE_SUPPORT;
1095
1096	ACPI_DEBUG_PRINT((ACPI_DB_MUTEX, "Signaling semaphore[%p|%d]\n", handle,
1097			  units));
1098
1099	up(sem);
1100
1101	return AE_OK;
1102}
1103
1104#ifdef ACPI_FUTURE_USAGE
1105u32 acpi_os_get_line(char *buffer)
1106{
1107
1108#ifdef ENABLE_DEBUGGER
1109	if (acpi_in_debugger) {
1110		u32 chars;
1111
1112		kdb_read(buffer, sizeof(line_buf));
1113
1114		/* remove the CR kdb includes */
1115		chars = strlen(buffer) - 1;
1116		buffer[chars] = '\0';
1117	}
 
 
 
 
 
 
 
 
1118#endif
1119
1120	return 0;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1121}
1122#endif				/*  ACPI_FUTURE_USAGE  */
1123
1124acpi_status acpi_os_signal(u32 function, void *info)
1125{
1126	switch (function) {
1127	case ACPI_SIGNAL_FATAL:
1128		printk(KERN_ERR PREFIX "Fatal opcode executed\n");
1129		break;
1130	case ACPI_SIGNAL_BREAKPOINT:
1131		/*
1132		 * AML Breakpoint
1133		 * ACPI spec. says to treat it as a NOP unless
1134		 * you are debugging.  So if/when we integrate
1135		 * AML debugger into the kernel debugger its
1136		 * hook will go here.  But until then it is
1137		 * not useful to print anything on breakpoints.
1138		 */
1139		break;
1140	default:
1141		break;
1142	}
1143
1144	return AE_OK;
1145}
1146
1147static int __init acpi_os_name_setup(char *str)
1148{
1149	char *p = acpi_os_name;
1150	int count = ACPI_MAX_OVERRIDE_LEN - 1;
1151
1152	if (!str || !*str)
1153		return 0;
1154
1155	for (; count-- && str && *str; str++) {
1156		if (isalnum(*str) || *str == ' ' || *str == ':')
1157			*p++ = *str;
1158		else if (*str == '\'' || *str == '"')
1159			continue;
1160		else
1161			break;
1162	}
1163	*p = 0;
1164
1165	return 1;
1166
1167}
1168
1169__setup("acpi_os_name=", acpi_os_name_setup);
1170
1171#define	OSI_STRING_LENGTH_MAX 64	/* arbitrary */
1172#define	OSI_STRING_ENTRIES_MAX 16	/* arbitrary */
1173
1174struct osi_setup_entry {
1175	char string[OSI_STRING_LENGTH_MAX];
1176	bool enable;
1177};
1178
1179static struct osi_setup_entry __initdata
1180		osi_setup_entries[OSI_STRING_ENTRIES_MAX] = {
1181	{"Module Device", true},
1182	{"Processor Device", true},
1183	{"3.0 _SCP Extensions", true},
1184	{"Processor Aggregator Device", true},
1185};
1186
1187void __init acpi_osi_setup(char *str)
1188{
1189	struct osi_setup_entry *osi;
1190	bool enable = true;
1191	int i;
1192
1193	if (!acpi_gbl_create_osi_method)
1194		return;
1195
1196	if (str == NULL || *str == '\0') {
1197		printk(KERN_INFO PREFIX "_OSI method disabled\n");
1198		acpi_gbl_create_osi_method = FALSE;
1199		return;
1200	}
1201
1202	if (*str == '!') {
1203		str++;
1204		enable = false;
1205	}
1206
1207	for (i = 0; i < OSI_STRING_ENTRIES_MAX; i++) {
1208		osi = &osi_setup_entries[i];
1209		if (!strcmp(osi->string, str)) {
1210			osi->enable = enable;
1211			break;
1212		} else if (osi->string[0] == '\0') {
1213			osi->enable = enable;
1214			strncpy(osi->string, str, OSI_STRING_LENGTH_MAX);
1215			break;
1216		}
1217	}
1218}
1219
1220static void __init set_osi_linux(unsigned int enable)
1221{
1222	if (osi_linux.enable != enable)
1223		osi_linux.enable = enable;
1224
1225	if (osi_linux.enable)
1226		acpi_osi_setup("Linux");
1227	else
1228		acpi_osi_setup("!Linux");
1229
1230	return;
1231}
1232
1233static void __init acpi_cmdline_osi_linux(unsigned int enable)
1234{
1235	osi_linux.cmdline = 1;	/* cmdline set the default and override DMI */
1236	osi_linux.dmi = 0;
1237	set_osi_linux(enable);
1238
1239	return;
1240}
1241
1242void __init acpi_dmi_osi_linux(int enable, const struct dmi_system_id *d)
1243{
1244	printk(KERN_NOTICE PREFIX "DMI detected: %s\n", d->ident);
1245
1246	if (enable == -1)
1247		return;
1248
1249	osi_linux.dmi = 1;	/* DMI knows that this box asks OSI(Linux) */
1250	set_osi_linux(enable);
1251
1252	return;
1253}
1254
1255/*
1256 * Modify the list of "OS Interfaces" reported to BIOS via _OSI
1257 *
1258 * empty string disables _OSI
1259 * string starting with '!' disables that string
1260 * otherwise string is added to list, augmenting built-in strings
1261 */
1262static void __init acpi_osi_setup_late(void)
1263{
1264	struct osi_setup_entry *osi;
1265	char *str;
1266	int i;
1267	acpi_status status;
1268
1269	for (i = 0; i < OSI_STRING_ENTRIES_MAX; i++) {
1270		osi = &osi_setup_entries[i];
1271		str = osi->string;
1272
1273		if (*str == '\0')
1274			break;
1275		if (osi->enable) {
1276			status = acpi_install_interface(str);
1277
1278			if (ACPI_SUCCESS(status))
1279				printk(KERN_INFO PREFIX "Added _OSI(%s)\n", str);
1280		} else {
1281			status = acpi_remove_interface(str);
1282
1283			if (ACPI_SUCCESS(status))
1284				printk(KERN_INFO PREFIX "Deleted _OSI(%s)\n", str);
1285		}
1286	}
1287}
1288
1289static int __init osi_setup(char *str)
1290{
1291	if (str && !strcmp("Linux", str))
1292		acpi_cmdline_osi_linux(1);
1293	else if (str && !strcmp("!Linux", str))
1294		acpi_cmdline_osi_linux(0);
1295	else
1296		acpi_osi_setup(str);
1297
1298	return 1;
1299}
1300
1301__setup("acpi_osi=", osi_setup);
1302
1303/* enable serialization to combat AE_ALREADY_EXISTS errors */
1304static int __init acpi_serialize_setup(char *str)
1305{
1306	printk(KERN_INFO PREFIX "serialize enabled\n");
1307
1308	acpi_gbl_all_methods_serialized = TRUE;
1309
1310	return 1;
1311}
1312
1313__setup("acpi_serialize", acpi_serialize_setup);
1314
1315/* Check of resource interference between native drivers and ACPI
1316 * OperationRegions (SystemIO and System Memory only).
1317 * IO ports and memory declared in ACPI might be used by the ACPI subsystem
1318 * in arbitrary AML code and can interfere with legacy drivers.
1319 * acpi_enforce_resources= can be set to:
1320 *
1321 *   - strict (default) (2)
1322 *     -> further driver trying to access the resources will not load
1323 *   - lax              (1)
1324 *     -> further driver trying to access the resources will load, but you
1325 *     get a system message that something might go wrong...
1326 *
1327 *   - no               (0)
1328 *     -> ACPI Operation Region resources will not be registered
1329 *
1330 */
1331#define ENFORCE_RESOURCES_STRICT 2
1332#define ENFORCE_RESOURCES_LAX    1
1333#define ENFORCE_RESOURCES_NO     0
1334
1335static unsigned int acpi_enforce_resources = ENFORCE_RESOURCES_STRICT;
1336
1337static int __init acpi_enforce_resources_setup(char *str)
1338{
1339	if (str == NULL || *str == '\0')
1340		return 0;
1341
1342	if (!strcmp("strict", str))
1343		acpi_enforce_resources = ENFORCE_RESOURCES_STRICT;
1344	else if (!strcmp("lax", str))
1345		acpi_enforce_resources = ENFORCE_RESOURCES_LAX;
1346	else if (!strcmp("no", str))
1347		acpi_enforce_resources = ENFORCE_RESOURCES_NO;
1348
1349	return 1;
1350}
1351
1352__setup("acpi_enforce_resources=", acpi_enforce_resources_setup);
1353
1354/* Check for resource conflicts between ACPI OperationRegions and native
1355 * drivers */
1356int acpi_check_resource_conflict(const struct resource *res)
1357{
1358	acpi_adr_space_type space_id;
1359	acpi_size length;
1360	u8 warn = 0;
1361	int clash = 0;
1362
1363	if (acpi_enforce_resources == ENFORCE_RESOURCES_NO)
1364		return 0;
1365	if (!(res->flags & IORESOURCE_IO) && !(res->flags & IORESOURCE_MEM))
1366		return 0;
1367
1368	if (res->flags & IORESOURCE_IO)
1369		space_id = ACPI_ADR_SPACE_SYSTEM_IO;
1370	else
1371		space_id = ACPI_ADR_SPACE_SYSTEM_MEMORY;
1372
1373	length = res->end - res->start + 1;
1374	if (acpi_enforce_resources != ENFORCE_RESOURCES_NO)
1375		warn = 1;
1376	clash = acpi_check_address_range(space_id, res->start, length, warn);
1377
1378	if (clash) {
1379		if (acpi_enforce_resources != ENFORCE_RESOURCES_NO) {
1380			if (acpi_enforce_resources == ENFORCE_RESOURCES_LAX)
1381				printk(KERN_NOTICE "ACPI: This conflict may"
1382				       " cause random problems and system"
1383				       " instability\n");
1384			printk(KERN_INFO "ACPI: If an ACPI driver is available"
1385			       " for this device, you should use it instead of"
1386			       " the native driver\n");
1387		}
1388		if (acpi_enforce_resources == ENFORCE_RESOURCES_STRICT)
1389			return -EBUSY;
1390	}
1391	return 0;
1392}
1393EXPORT_SYMBOL(acpi_check_resource_conflict);
1394
1395int acpi_check_region(resource_size_t start, resource_size_t n,
1396		      const char *name)
1397{
1398	struct resource res = {
1399		.start = start,
1400		.end   = start + n - 1,
1401		.name  = name,
1402		.flags = IORESOURCE_IO,
1403	};
1404
1405	return acpi_check_resource_conflict(&res);
1406}
1407EXPORT_SYMBOL(acpi_check_region);
1408
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1409/*
1410 * Let drivers know whether the resource checks are effective
1411 */
1412int acpi_resources_are_enforced(void)
1413{
1414	return acpi_enforce_resources == ENFORCE_RESOURCES_STRICT;
1415}
1416EXPORT_SYMBOL(acpi_resources_are_enforced);
1417
1418/*
1419 * Deallocate the memory for a spinlock.
1420 */
1421void acpi_os_delete_lock(acpi_spinlock handle)
1422{
1423	ACPI_FREE(handle);
1424}
1425
1426/*
1427 * Acquire a spinlock.
1428 *
1429 * handle is a pointer to the spinlock_t.
1430 */
1431
1432acpi_cpu_flags acpi_os_acquire_lock(acpi_spinlock lockp)
 
1433{
1434	acpi_cpu_flags flags;
1435	spin_lock_irqsave(lockp, flags);
1436	return flags;
1437}
1438
1439/*
1440 * Release a spinlock. See above.
1441 */
1442
1443void acpi_os_release_lock(acpi_spinlock lockp, acpi_cpu_flags flags)
 
1444{
1445	spin_unlock_irqrestore(lockp, flags);
1446}
1447
1448#ifndef ACPI_USE_LOCAL_CACHE
1449
1450/*******************************************************************************
1451 *
1452 * FUNCTION:    acpi_os_create_cache
1453 *
1454 * PARAMETERS:  name      - Ascii name for the cache
1455 *              size      - Size of each cached object
1456 *              depth     - Maximum depth of the cache (in objects) <ignored>
1457 *              cache     - Where the new cache object is returned
1458 *
1459 * RETURN:      status
1460 *
1461 * DESCRIPTION: Create a cache object
1462 *
1463 ******************************************************************************/
1464
1465acpi_status
1466acpi_os_create_cache(char *name, u16 size, u16 depth, acpi_cache_t ** cache)
1467{
1468	*cache = kmem_cache_create(name, size, 0, 0, NULL);
1469	if (*cache == NULL)
1470		return AE_ERROR;
1471	else
1472		return AE_OK;
1473}
1474
1475/*******************************************************************************
1476 *
1477 * FUNCTION:    acpi_os_purge_cache
1478 *
1479 * PARAMETERS:  Cache           - Handle to cache object
1480 *
1481 * RETURN:      Status
1482 *
1483 * DESCRIPTION: Free all objects within the requested cache.
1484 *
1485 ******************************************************************************/
1486
1487acpi_status acpi_os_purge_cache(acpi_cache_t * cache)
1488{
1489	kmem_cache_shrink(cache);
1490	return (AE_OK);
1491}
1492
1493/*******************************************************************************
1494 *
1495 * FUNCTION:    acpi_os_delete_cache
1496 *
1497 * PARAMETERS:  Cache           - Handle to cache object
1498 *
1499 * RETURN:      Status
1500 *
1501 * DESCRIPTION: Free all objects within the requested cache and delete the
1502 *              cache object.
1503 *
1504 ******************************************************************************/
1505
1506acpi_status acpi_os_delete_cache(acpi_cache_t * cache)
1507{
1508	kmem_cache_destroy(cache);
1509	return (AE_OK);
1510}
1511
1512/*******************************************************************************
1513 *
1514 * FUNCTION:    acpi_os_release_object
1515 *
1516 * PARAMETERS:  Cache       - Handle to cache object
1517 *              Object      - The object to be released
1518 *
1519 * RETURN:      None
1520 *
1521 * DESCRIPTION: Release an object to the specified cache.  If cache is full,
1522 *              the object is deleted.
1523 *
1524 ******************************************************************************/
1525
1526acpi_status acpi_os_release_object(acpi_cache_t * cache, void *object)
1527{
1528	kmem_cache_free(cache, object);
1529	return (AE_OK);
1530}
1531#endif
1532
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1533acpi_status __init acpi_os_initialize(void)
1534{
1535	acpi_os_map_generic_address(&acpi_gbl_FADT.xpm1a_event_block);
1536	acpi_os_map_generic_address(&acpi_gbl_FADT.xpm1b_event_block);
1537	acpi_os_map_generic_address(&acpi_gbl_FADT.xgpe0_block);
1538	acpi_os_map_generic_address(&acpi_gbl_FADT.xgpe1_block);
 
 
 
 
 
 
 
 
 
 
 
1539
1540	return AE_OK;
1541}
1542
1543acpi_status __init acpi_os_initialize1(void)
1544{
1545	kacpid_wq = alloc_workqueue("kacpid", 0, 1);
1546	kacpi_notify_wq = alloc_workqueue("kacpi_notify", 0, 1);
1547	kacpi_hotplug_wq = alloc_workqueue("kacpi_hotplug", 0, 1);
1548	BUG_ON(!kacpid_wq);
1549	BUG_ON(!kacpi_notify_wq);
1550	BUG_ON(!kacpi_hotplug_wq);
1551	acpi_install_interface_handler(acpi_osi_handler);
1552	acpi_osi_setup_late();
1553	return AE_OK;
1554}
1555
1556acpi_status acpi_os_terminate(void)
1557{
1558	if (acpi_irq_handler) {
1559		acpi_os_remove_interrupt_handler(acpi_gbl_FADT.sci_interrupt,
1560						 acpi_irq_handler);
1561	}
1562
1563	acpi_os_unmap_generic_address(&acpi_gbl_FADT.xgpe1_block);
1564	acpi_os_unmap_generic_address(&acpi_gbl_FADT.xgpe0_block);
1565	acpi_os_unmap_generic_address(&acpi_gbl_FADT.xpm1b_event_block);
1566	acpi_os_unmap_generic_address(&acpi_gbl_FADT.xpm1a_event_block);
 
 
1567
1568	destroy_workqueue(kacpid_wq);
1569	destroy_workqueue(kacpi_notify_wq);
1570	destroy_workqueue(kacpi_hotplug_wq);
1571
1572	return AE_OK;
1573}
1574
1575acpi_status acpi_os_prepare_sleep(u8 sleep_state, u32 pm1a_control,
1576				  u32 pm1b_control)
1577{
1578	int rc = 0;
1579	if (__acpi_os_prepare_sleep)
1580		rc = __acpi_os_prepare_sleep(sleep_state,
1581					     pm1a_control, pm1b_control);
1582	if (rc < 0)
1583		return AE_ERROR;
1584	else if (rc > 0)
1585		return AE_CTRL_SKIP;
1586
1587	return AE_OK;
1588}
1589
1590void acpi_os_set_prepare_sleep(int (*func)(u8 sleep_state,
1591			       u32 pm1a_ctrl, u32 pm1b_ctrl))
1592{
1593	__acpi_os_prepare_sleep = func;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1594}