2 * boot.c - Architecture-Specific Low-Level ACPI Boot Support
4 * Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
5 * Copyright (C) 2001 Jun Nakajima <jun.nakajima@intel.com>
7 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
26 #include <linux/init.h>
27 #include <linux/acpi.h>
28 #include <linux/acpi_pmtmr.h>
29 #include <linux/efi.h>
30 #include <linux/cpumask.h>
31 #include <linux/module.h>
32 #include <linux/dmi.h>
33 #include <linux/irq.h>
34 #include <linux/slab.h>
35 #include <linux/bootmem.h>
36 #include <linux/ioport.h>
37 #include <linux/pci.h>
39 #include <asm/pci_x86.h>
40 #include <asm/pgtable.h>
41 #include <asm/io_apic.h>
44 #include <asm/mpspec.h>
47 static int __initdata acpi_force
= 0;
50 EXPORT_SYMBOL(acpi_disabled
);
53 # include <asm/proto.h>
54 # include <asm/numa_64.h>
57 #define BAD_MADT_ENTRY(entry, end) ( \
58 (!entry) || (unsigned long)entry + sizeof(*entry) > end || \
59 ((struct acpi_subtable_header *)entry)->length < sizeof(*entry))
61 #define PREFIX "ACPI: "
63 int acpi_noirq
; /* skip ACPI IRQ initialization */
64 int acpi_pci_disabled
; /* skip ACPI PCI scan and IRQ initialization */
65 EXPORT_SYMBOL(acpi_pci_disabled
);
66 int acpi_ht __initdata
= 1; /* enable HT */
72 u8 acpi_sci_flags __initdata
;
73 int acpi_sci_override_gsi __initdata
;
74 int acpi_skip_timer_override __initdata
;
75 int acpi_use_timer_override __initdata
;
77 #ifdef CONFIG_X86_LOCAL_APIC
78 static u64 acpi_lapic_addr __initdata
= APIC_DEFAULT_PHYS_BASE
;
81 #ifndef __HAVE_ARCH_CMPXCHG
82 #warning ACPI uses CMPXCHG, i486 and later hardware
85 /* --------------------------------------------------------------------------
86 Boot-time Configuration
87 -------------------------------------------------------------------------- */
90 * The default interrupt routing model is PIC (8259). This gets
91 * overridden if IOAPICs are enumerated (below).
93 enum acpi_irq_model_id acpi_irq_model
= ACPI_IRQ_MODEL_PIC
;
97 * Temporarily use the virtual area starting from FIX_IO_APIC_BASE_END,
98 * to map the target physical address. The problem is that set_fixmap()
99 * provides a single page, and it is possible that the page is not
101 * By using this area, we can map up to MAX_IO_APICS pages temporarily,
102 * i.e. until the next __va_range() call.
104 * Important Safety Note: The fixed I/O APIC page numbers are *subtracted*
105 * from the fixed base. That's why we start at FIX_IO_APIC_BASE_END and
106 * count idx down while incrementing the phys address.
108 char *__init
__acpi_map_table(unsigned long phys
, unsigned long size
)
114 return early_ioremap(phys
, size
);
116 void __init
__acpi_unmap_table(char *map
, unsigned long size
)
121 early_iounmap(map
, size
);
124 #ifdef CONFIG_X86_LOCAL_APIC
125 static int __init
acpi_parse_madt(struct acpi_table_header
*table
)
127 struct acpi_table_madt
*madt
= NULL
;
132 madt
= (struct acpi_table_madt
*)table
;
134 printk(KERN_WARNING PREFIX
"Unable to map MADT\n");
139 acpi_lapic_addr
= (u64
) madt
->address
;
141 printk(KERN_DEBUG PREFIX
"Local APIC address 0x%08x\n",
145 default_acpi_madt_oem_check(madt
->header
.oem_id
,
146 madt
->header
.oem_table_id
);
151 static void __cpuinit
acpi_register_lapic(int id
, u8 enabled
)
153 unsigned int ver
= 0;
160 if (boot_cpu_physical_apicid
!= -1U)
161 ver
= apic_version
[boot_cpu_physical_apicid
];
163 generic_processor_info(id
, ver
);
167 acpi_parse_x2apic(struct acpi_subtable_header
*header
, const unsigned long end
)
169 struct acpi_madt_local_x2apic
*processor
= NULL
;
171 processor
= (struct acpi_madt_local_x2apic
*)header
;
173 if (BAD_MADT_ENTRY(processor
, end
))
176 acpi_table_print_madt_entry(header
);
178 #ifdef CONFIG_X86_X2APIC
180 * We need to register disabled CPU as well to permit
181 * counting disabled CPUs. This allows us to size
182 * cpus_possible_map more accurately, to permit
183 * to not preallocating memory for all NR_CPUS
184 * when we use CPU hotplug.
186 acpi_register_lapic(processor
->local_apic_id
, /* APIC ID */
187 processor
->lapic_flags
& ACPI_MADT_ENABLED
);
189 printk(KERN_WARNING PREFIX
"x2apic entry ignored\n");
196 acpi_parse_lapic(struct acpi_subtable_header
* header
, const unsigned long end
)
198 struct acpi_madt_local_apic
*processor
= NULL
;
200 processor
= (struct acpi_madt_local_apic
*)header
;
202 if (BAD_MADT_ENTRY(processor
, end
))
205 acpi_table_print_madt_entry(header
);
208 * We need to register disabled CPU as well to permit
209 * counting disabled CPUs. This allows us to size
210 * cpus_possible_map more accurately, to permit
211 * to not preallocating memory for all NR_CPUS
212 * when we use CPU hotplug.
214 acpi_register_lapic(processor
->id
, /* APIC ID */
215 processor
->lapic_flags
& ACPI_MADT_ENABLED
);
221 acpi_parse_sapic(struct acpi_subtable_header
*header
, const unsigned long end
)
223 struct acpi_madt_local_sapic
*processor
= NULL
;
225 processor
= (struct acpi_madt_local_sapic
*)header
;
227 if (BAD_MADT_ENTRY(processor
, end
))
230 acpi_table_print_madt_entry(header
);
232 acpi_register_lapic((processor
->id
<< 8) | processor
->eid
,/* APIC ID */
233 processor
->lapic_flags
& ACPI_MADT_ENABLED
);
239 acpi_parse_lapic_addr_ovr(struct acpi_subtable_header
* header
,
240 const unsigned long end
)
242 struct acpi_madt_local_apic_override
*lapic_addr_ovr
= NULL
;
244 lapic_addr_ovr
= (struct acpi_madt_local_apic_override
*)header
;
246 if (BAD_MADT_ENTRY(lapic_addr_ovr
, end
))
249 acpi_lapic_addr
= lapic_addr_ovr
->address
;
255 acpi_parse_x2apic_nmi(struct acpi_subtable_header
*header
,
256 const unsigned long end
)
258 struct acpi_madt_local_x2apic_nmi
*x2apic_nmi
= NULL
;
260 x2apic_nmi
= (struct acpi_madt_local_x2apic_nmi
*)header
;
262 if (BAD_MADT_ENTRY(x2apic_nmi
, end
))
265 acpi_table_print_madt_entry(header
);
267 if (x2apic_nmi
->lint
!= 1)
268 printk(KERN_WARNING PREFIX
"NMI not connected to LINT 1!\n");
274 acpi_parse_lapic_nmi(struct acpi_subtable_header
* header
, const unsigned long end
)
276 struct acpi_madt_local_apic_nmi
*lapic_nmi
= NULL
;
278 lapic_nmi
= (struct acpi_madt_local_apic_nmi
*)header
;
280 if (BAD_MADT_ENTRY(lapic_nmi
, end
))
283 acpi_table_print_madt_entry(header
);
285 if (lapic_nmi
->lint
!= 1)
286 printk(KERN_WARNING PREFIX
"NMI not connected to LINT 1!\n");
291 #endif /*CONFIG_X86_LOCAL_APIC */
293 #ifdef CONFIG_X86_IO_APIC
296 acpi_parse_ioapic(struct acpi_subtable_header
* header
, const unsigned long end
)
298 struct acpi_madt_io_apic
*ioapic
= NULL
;
300 ioapic
= (struct acpi_madt_io_apic
*)header
;
302 if (BAD_MADT_ENTRY(ioapic
, end
))
305 acpi_table_print_madt_entry(header
);
307 mp_register_ioapic(ioapic
->id
,
308 ioapic
->address
, ioapic
->global_irq_base
);
314 * Parse Interrupt Source Override for the ACPI SCI
316 static void __init
acpi_sci_ioapic_setup(u8 bus_irq
, u16 polarity
, u16 trigger
, u32 gsi
)
318 if (trigger
== 0) /* compatible SCI trigger is level */
321 if (polarity
== 0) /* compatible SCI polarity is low */
324 /* Command-line over-ride via acpi_sci= */
325 if (acpi_sci_flags
& ACPI_MADT_TRIGGER_MASK
)
326 trigger
= (acpi_sci_flags
& ACPI_MADT_TRIGGER_MASK
) >> 2;
328 if (acpi_sci_flags
& ACPI_MADT_POLARITY_MASK
)
329 polarity
= acpi_sci_flags
& ACPI_MADT_POLARITY_MASK
;
332 * mp_config_acpi_legacy_irqs() already setup IRQs < 16
333 * If GSI is < 16, this will update its flags,
334 * else it will create a new mp_irqs[] entry.
336 mp_override_legacy_irq(bus_irq
, polarity
, trigger
, gsi
);
339 * stash over-ride to indicate we've been here
340 * and for later update of acpi_gbl_FADT
342 acpi_sci_override_gsi
= gsi
;
347 acpi_parse_int_src_ovr(struct acpi_subtable_header
* header
,
348 const unsigned long end
)
350 struct acpi_madt_interrupt_override
*intsrc
= NULL
;
352 intsrc
= (struct acpi_madt_interrupt_override
*)header
;
354 if (BAD_MADT_ENTRY(intsrc
, end
))
357 acpi_table_print_madt_entry(header
);
359 if (intsrc
->source_irq
== acpi_gbl_FADT
.sci_interrupt
) {
360 acpi_sci_ioapic_setup(intsrc
->source_irq
,
361 intsrc
->inti_flags
& ACPI_MADT_POLARITY_MASK
,
362 (intsrc
->inti_flags
& ACPI_MADT_TRIGGER_MASK
) >> 2,
367 if (acpi_skip_timer_override
&&
368 intsrc
->source_irq
== 0 && intsrc
->global_irq
== 2) {
369 printk(PREFIX
"BIOS IRQ0 pin2 override ignored.\n");
373 mp_override_legacy_irq(intsrc
->source_irq
,
374 intsrc
->inti_flags
& ACPI_MADT_POLARITY_MASK
,
375 (intsrc
->inti_flags
& ACPI_MADT_TRIGGER_MASK
) >> 2,
382 acpi_parse_nmi_src(struct acpi_subtable_header
* header
, const unsigned long end
)
384 struct acpi_madt_nmi_source
*nmi_src
= NULL
;
386 nmi_src
= (struct acpi_madt_nmi_source
*)header
;
388 if (BAD_MADT_ENTRY(nmi_src
, end
))
391 acpi_table_print_madt_entry(header
);
393 /* TBD: Support nimsrc entries? */
398 #endif /* CONFIG_X86_IO_APIC */
401 * acpi_pic_sci_set_trigger()
403 * use ELCR to set PIC-mode trigger type for SCI
405 * If a PIC-mode SCI is not recognized or gives spurious IRQ7's
406 * it may require Edge Trigger -- use "acpi_sci=edge"
408 * Port 0x4d0-4d1 are ECLR1 and ECLR2, the Edge/Level Control Registers
409 * for the 8259 PIC. bit[n] = 1 means irq[n] is Level, otherwise Edge.
410 * ECLR1 is IRQs 0-7 (IRQ 0, 1, 2 must be 0)
411 * ECLR2 is IRQs 8-15 (IRQ 8, 13 must be 0)
414 void __init
acpi_pic_sci_set_trigger(unsigned int irq
, u16 trigger
)
416 unsigned int mask
= 1 << irq
;
417 unsigned int old
, new;
419 /* Real old ELCR mask */
420 old
= inb(0x4d0) | (inb(0x4d1) << 8);
423 * If we use ACPI to set PCI IRQs, then we should clear ELCR
424 * since we will set it correctly as we enable the PCI irq
427 new = acpi_noirq
? old
: 0;
430 * Update SCI information in the ELCR, it isn't in the PCI
434 case 1: /* Edge - clear */
437 case 3: /* Level - set */
445 printk(PREFIX
"setting ELCR to %04x (from %04x)\n", new, old
);
447 outb(new >> 8, 0x4d1);
450 int acpi_gsi_to_irq(u32 gsi
, unsigned int *irq
)
454 #ifdef CONFIG_X86_IO_APIC
455 if (acpi_irq_model
== ACPI_IRQ_MODEL_IOAPIC
)
456 setup_IO_APIC_irq_extra(gsi
);
462 int acpi_isa_irq_to_gsi(unsigned isa_irq
, u32
*gsi
)
471 * success: return IRQ number (>=0)
472 * failure: return < 0
474 int acpi_register_gsi(struct device
*dev
, u32 gsi
, int trigger
, int polarity
)
477 unsigned int plat_gsi
= gsi
;
481 * Make sure all (legacy) PCI IRQs are set as level-triggered.
483 if (acpi_irq_model
== ACPI_IRQ_MODEL_PIC
) {
484 if (trigger
== ACPI_LEVEL_SENSITIVE
)
485 eisa_set_level_irq(gsi
);
489 #ifdef CONFIG_X86_IO_APIC
490 if (acpi_irq_model
== ACPI_IRQ_MODEL_IOAPIC
) {
491 plat_gsi
= mp_register_gsi(dev
, gsi
, trigger
, polarity
);
500 * ACPI based hotplug support for CPU
502 #ifdef CONFIG_ACPI_HOTPLUG_CPU
503 #include <acpi/processor.h>
505 static void acpi_map_cpu2node(acpi_handle handle
, int cpu
, int physid
)
507 #ifdef CONFIG_ACPI_NUMA
510 nid
= acpi_get_node(handle
);
511 if (nid
== -1 || !node_online(nid
))
514 apicid_to_node
[physid
] = nid
;
515 numa_set_node(cpu
, nid
);
516 #else /* CONFIG_X86_32 */
517 apicid_2_node
[physid
] = nid
;
518 cpu_to_node_map
[cpu
] = nid
;
524 static int __cpuinit
_acpi_map_lsapic(acpi_handle handle
, int *pcpu
)
526 struct acpi_buffer buffer
= { ACPI_ALLOCATE_BUFFER
, NULL
};
527 union acpi_object
*obj
;
528 struct acpi_madt_local_apic
*lapic
;
529 cpumask_var_t tmp_map
, new_map
;
532 int retval
= -ENOMEM
;
534 if (ACPI_FAILURE(acpi_evaluate_object(handle
, "_MAT", NULL
, &buffer
)))
537 if (!buffer
.length
|| !buffer
.pointer
)
540 obj
= buffer
.pointer
;
541 if (obj
->type
!= ACPI_TYPE_BUFFER
||
542 obj
->buffer
.length
< sizeof(*lapic
)) {
543 kfree(buffer
.pointer
);
547 lapic
= (struct acpi_madt_local_apic
*)obj
->buffer
.pointer
;
549 if (lapic
->header
.type
!= ACPI_MADT_TYPE_LOCAL_APIC
||
550 !(lapic
->lapic_flags
& ACPI_MADT_ENABLED
)) {
551 kfree(buffer
.pointer
);
557 kfree(buffer
.pointer
);
558 buffer
.length
= ACPI_ALLOCATE_BUFFER
;
559 buffer
.pointer
= NULL
;
561 if (!alloc_cpumask_var(&tmp_map
, GFP_KERNEL
))
564 if (!alloc_cpumask_var(&new_map
, GFP_KERNEL
))
567 cpumask_copy(tmp_map
, cpu_present_mask
);
568 acpi_register_lapic(physid
, lapic
->lapic_flags
& ACPI_MADT_ENABLED
);
571 * If mp_register_lapic successfully generates a new logical cpu
572 * number, then the following will get us exactly what was mapped
574 cpumask_andnot(new_map
, cpu_present_mask
, tmp_map
);
575 if (cpumask_empty(new_map
)) {
576 printk ("Unable to map lapic to logical cpu number\n");
581 acpi_processor_set_pdc(handle
);
583 cpu
= cpumask_first(new_map
);
584 acpi_map_cpu2node(handle
, cpu
, physid
);
590 free_cpumask_var(new_map
);
592 free_cpumask_var(tmp_map
);
597 /* wrapper to silence section mismatch warning */
598 int __ref
acpi_map_lsapic(acpi_handle handle
, int *pcpu
)
600 return _acpi_map_lsapic(handle
, pcpu
);
602 EXPORT_SYMBOL(acpi_map_lsapic
);
604 int acpi_unmap_lsapic(int cpu
)
606 per_cpu(x86_cpu_to_apicid
, cpu
) = -1;
607 set_cpu_present(cpu
, false);
613 EXPORT_SYMBOL(acpi_unmap_lsapic
);
614 #endif /* CONFIG_ACPI_HOTPLUG_CPU */
616 int acpi_register_ioapic(acpi_handle handle
, u64 phys_addr
, u32 gsi_base
)
622 EXPORT_SYMBOL(acpi_register_ioapic
);
624 int acpi_unregister_ioapic(acpi_handle handle
, u32 gsi_base
)
630 EXPORT_SYMBOL(acpi_unregister_ioapic
);
632 static int __init
acpi_parse_sbf(struct acpi_table_header
*table
)
634 struct acpi_table_boot
*sb
;
636 sb
= (struct acpi_table_boot
*)table
;
638 printk(KERN_WARNING PREFIX
"Unable to map SBF\n");
642 sbf_port
= sb
->cmos_index
; /* Save CMOS port */
647 #ifdef CONFIG_HPET_TIMER
648 #include <asm/hpet.h>
650 static struct __initdata resource
*hpet_res
;
652 static int __init
acpi_parse_hpet(struct acpi_table_header
*table
)
654 struct acpi_table_hpet
*hpet_tbl
;
656 hpet_tbl
= (struct acpi_table_hpet
*)table
;
658 printk(KERN_WARNING PREFIX
"Unable to map HPET\n");
662 if (hpet_tbl
->address
.space_id
!= ACPI_SPACE_MEM
) {
663 printk(KERN_WARNING PREFIX
"HPET timers must be located in "
668 hpet_address
= hpet_tbl
->address
.address
;
669 hpet_blockid
= hpet_tbl
->sequence
;
672 * Some broken BIOSes advertise HPET at 0x0. We really do not
673 * want to allocate a resource there.
676 printk(KERN_WARNING PREFIX
677 "HPET id: %#x base: %#lx is invalid\n",
678 hpet_tbl
->id
, hpet_address
);
683 * Some even more broken BIOSes advertise HPET at
684 * 0xfed0000000000000 instead of 0xfed00000. Fix it up and add
687 if (hpet_address
== 0xfed0000000000000UL
) {
688 if (!hpet_force_user
) {
689 printk(KERN_WARNING PREFIX
"HPET id: %#x "
690 "base: 0xfed0000000000000 is bogus\n "
691 "try hpet=force on the kernel command line to "
692 "fix it up to 0xfed00000.\n", hpet_tbl
->id
);
696 printk(KERN_WARNING PREFIX
697 "HPET id: %#x base: 0xfed0000000000000 fixed up "
698 "to 0xfed00000.\n", hpet_tbl
->id
);
702 printk(KERN_INFO PREFIX
"HPET id: %#x base: %#lx\n",
703 hpet_tbl
->id
, hpet_address
);
706 * Allocate and initialize the HPET firmware resource for adding into
707 * the resource tree during the lateinit timeframe.
709 #define HPET_RESOURCE_NAME_SIZE 9
710 hpet_res
= alloc_bootmem(sizeof(*hpet_res
) + HPET_RESOURCE_NAME_SIZE
);
712 hpet_res
->name
= (void *)&hpet_res
[1];
713 hpet_res
->flags
= IORESOURCE_MEM
;
714 snprintf((char *)hpet_res
->name
, HPET_RESOURCE_NAME_SIZE
, "HPET %u",
717 hpet_res
->start
= hpet_address
;
718 hpet_res
->end
= hpet_address
+ (1 * 1024) - 1;
724 * hpet_insert_resource inserts the HPET resources used into the resource
727 static __init
int hpet_insert_resource(void)
732 return insert_resource(&iomem_resource
, hpet_res
);
735 late_initcall(hpet_insert_resource
);
738 #define acpi_parse_hpet NULL
741 static int __init
acpi_parse_fadt(struct acpi_table_header
*table
)
744 #ifdef CONFIG_X86_PM_TIMER
745 /* detect the location of the ACPI PM Timer */
746 if (acpi_gbl_FADT
.header
.revision
>= FADT2_REVISION_ID
) {
748 if (acpi_gbl_FADT
.xpm_timer_block
.space_id
!=
749 ACPI_ADR_SPACE_SYSTEM_IO
)
752 pmtmr_ioport
= acpi_gbl_FADT
.xpm_timer_block
.address
;
754 * "X" fields are optional extensions to the original V1.0
755 * fields, so we must selectively expand V1.0 fields if the
756 * corresponding X field is zero.
759 pmtmr_ioport
= acpi_gbl_FADT
.pm_timer_block
;
762 pmtmr_ioport
= acpi_gbl_FADT
.pm_timer_block
;
765 printk(KERN_INFO PREFIX
"PM-Timer IO Port: %#x\n",
771 #ifdef CONFIG_X86_LOCAL_APIC
773 * Parse LAPIC entries in MADT
774 * returns 0 on success, < 0 on error
777 static void __init
acpi_register_lapic_address(unsigned long address
)
779 mp_lapic_addr
= address
;
781 set_fixmap_nocache(FIX_APIC_BASE
, address
);
782 if (boot_cpu_physical_apicid
== -1U) {
783 boot_cpu_physical_apicid
= read_apic_id();
784 apic_version
[boot_cpu_physical_apicid
] =
785 GET_APIC_VERSION(apic_read(APIC_LVR
));
789 static int __init
early_acpi_parse_madt_lapic_addr_ovr(void)
797 * Note that the LAPIC address is obtained from the MADT (32-bit value)
798 * and (optionally) overriden by a LAPIC_ADDR_OVR entry (64-bit value).
802 acpi_table_parse_madt(ACPI_MADT_TYPE_LOCAL_APIC_OVERRIDE
,
803 acpi_parse_lapic_addr_ovr
, 0);
805 printk(KERN_ERR PREFIX
806 "Error parsing LAPIC address override entry\n");
810 acpi_register_lapic_address(acpi_lapic_addr
);
815 static int __init
acpi_parse_madt_lapic_entries(void)
824 * Note that the LAPIC address is obtained from the MADT (32-bit value)
825 * and (optionally) overriden by a LAPIC_ADDR_OVR entry (64-bit value).
829 acpi_table_parse_madt(ACPI_MADT_TYPE_LOCAL_APIC_OVERRIDE
,
830 acpi_parse_lapic_addr_ovr
, 0);
832 printk(KERN_ERR PREFIX
833 "Error parsing LAPIC address override entry\n");
837 acpi_register_lapic_address(acpi_lapic_addr
);
839 count
= acpi_table_parse_madt(ACPI_MADT_TYPE_LOCAL_SAPIC
,
840 acpi_parse_sapic
, MAX_APICS
);
843 x2count
= acpi_table_parse_madt(ACPI_MADT_TYPE_LOCAL_X2APIC
,
844 acpi_parse_x2apic
, MAX_APICS
);
845 count
= acpi_table_parse_madt(ACPI_MADT_TYPE_LOCAL_APIC
,
846 acpi_parse_lapic
, MAX_APICS
);
848 if (!count
&& !x2count
) {
849 printk(KERN_ERR PREFIX
"No LAPIC entries present\n");
850 /* TBD: Cleanup to allow fallback to MPS */
852 } else if (count
< 0 || x2count
< 0) {
853 printk(KERN_ERR PREFIX
"Error parsing LAPIC entry\n");
854 /* TBD: Cleanup to allow fallback to MPS */
859 acpi_table_parse_madt(ACPI_MADT_TYPE_LOCAL_X2APIC_NMI
,
860 acpi_parse_x2apic_nmi
, 0);
862 acpi_table_parse_madt(ACPI_MADT_TYPE_LOCAL_APIC_NMI
, acpi_parse_lapic_nmi
, 0);
863 if (count
< 0 || x2count
< 0) {
864 printk(KERN_ERR PREFIX
"Error parsing LAPIC NMI entry\n");
865 /* TBD: Cleanup to allow fallback to MPS */
870 #endif /* CONFIG_X86_LOCAL_APIC */
872 #ifdef CONFIG_X86_IO_APIC
875 #ifdef CONFIG_X86_ES7000
876 extern int es7000_plat
;
879 int __init
acpi_probe_gsi(void)
892 for (idx
= 0; idx
< nr_ioapics
; idx
++) {
893 gsi
= mp_gsi_routing
[idx
].gsi_end
;
902 static void assign_to_mp_irq(struct mpc_intsrc
*m
,
903 struct mpc_intsrc
*mp_irq
)
905 memcpy(mp_irq
, m
, sizeof(struct mpc_intsrc
));
908 static int mp_irq_cmp(struct mpc_intsrc
*mp_irq
,
909 struct mpc_intsrc
*m
)
911 return memcmp(mp_irq
, m
, sizeof(struct mpc_intsrc
));
914 static void save_mp_irq(struct mpc_intsrc
*m
)
918 for (i
= 0; i
< mp_irq_entries
; i
++) {
919 if (!mp_irq_cmp(&mp_irqs
[i
], m
))
923 assign_to_mp_irq(m
, &mp_irqs
[mp_irq_entries
]);
924 if (++mp_irq_entries
== MAX_IRQ_SOURCES
)
925 panic("Max # of irq sources exceeded!!\n");
928 void __init
mp_override_legacy_irq(u8 bus_irq
, u8 polarity
, u8 trigger
, u32 gsi
)
932 struct mpc_intsrc mp_irq
;
935 * Convert 'gsi' to 'ioapic.pin'.
937 ioapic
= mp_find_ioapic(gsi
);
940 pin
= mp_find_ioapic_pin(ioapic
, gsi
);
943 * TBD: This check is for faulty timer entries, where the override
944 * erroneously sets the trigger to level, resulting in a HUGE
945 * increase of timer interrupts!
947 if ((bus_irq
== 0) && (trigger
== 3))
950 mp_irq
.type
= MP_INTSRC
;
951 mp_irq
.irqtype
= mp_INT
;
952 mp_irq
.irqflag
= (trigger
<< 2) | polarity
;
953 mp_irq
.srcbus
= MP_ISA_BUS
;
954 mp_irq
.srcbusirq
= bus_irq
; /* IRQ */
955 mp_irq
.dstapic
= mp_ioapics
[ioapic
].apicid
; /* APIC ID */
956 mp_irq
.dstirq
= pin
; /* INTIN# */
958 save_mp_irq(&mp_irq
);
961 void __init
mp_config_acpi_legacy_irqs(void)
965 unsigned int dstapic
;
966 struct mpc_intsrc mp_irq
;
968 #if defined (CONFIG_MCA) || defined (CONFIG_EISA)
970 * Fabricate the legacy ISA bus (bus #31).
972 mp_bus_id_to_type
[MP_ISA_BUS
] = MP_BUS_ISA
;
974 set_bit(MP_ISA_BUS
, mp_bus_not_pci
);
975 pr_debug("Bus #%d is ISA\n", MP_ISA_BUS
);
977 #ifdef CONFIG_X86_ES7000
979 * Older generations of ES7000 have no legacy identity mappings
981 if (es7000_plat
== 1)
986 * Locate the IOAPIC that manages the ISA IRQs (0-15).
988 ioapic
= mp_find_ioapic(0);
991 dstapic
= mp_ioapics
[ioapic
].apicid
;
994 * Use the default configuration for the IRQs 0-15. Unless
995 * overridden by (MADT) interrupt source override entries.
997 for (i
= 0; i
< 16; i
++) {
1000 for (idx
= 0; idx
< mp_irq_entries
; idx
++) {
1001 struct mpc_intsrc
*irq
= mp_irqs
+ idx
;
1003 /* Do we already have a mapping for this ISA IRQ? */
1004 if (irq
->srcbus
== MP_ISA_BUS
&& irq
->srcbusirq
== i
)
1007 /* Do we already have a mapping for this IOAPIC pin */
1008 if (irq
->dstapic
== dstapic
&& irq
->dstirq
== i
)
1012 if (idx
!= mp_irq_entries
) {
1013 printk(KERN_DEBUG
"ACPI: IRQ%d used by override.\n", i
);
1014 continue; /* IRQ already used */
1017 mp_irq
.type
= MP_INTSRC
;
1018 mp_irq
.irqflag
= 0; /* Conforming */
1019 mp_irq
.srcbus
= MP_ISA_BUS
;
1020 mp_irq
.dstapic
= dstapic
;
1021 mp_irq
.irqtype
= mp_INT
;
1022 mp_irq
.srcbusirq
= i
; /* Identity mapped */
1025 save_mp_irq(&mp_irq
);
1029 static int mp_config_acpi_gsi(struct device
*dev
, u32 gsi
, int trigger
,
1032 #ifdef CONFIG_X86_MPPARSE
1033 struct mpc_intsrc mp_irq
;
1034 struct pci_dev
*pdev
;
1035 unsigned char number
;
1044 if (dev
->bus
!= &pci_bus_type
)
1047 pdev
= to_pci_dev(dev
);
1048 number
= pdev
->bus
->number
;
1049 devfn
= pdev
->devfn
;
1051 /* print the entry should happen on mptable identically */
1052 mp_irq
.type
= MP_INTSRC
;
1053 mp_irq
.irqtype
= mp_INT
;
1054 mp_irq
.irqflag
= (trigger
== ACPI_EDGE_SENSITIVE
? 4 : 0x0c) |
1055 (polarity
== ACPI_ACTIVE_HIGH
? 1 : 3);
1056 mp_irq
.srcbus
= number
;
1057 mp_irq
.srcbusirq
= (((devfn
>> 3) & 0x1f) << 2) | ((pin
- 1) & 3);
1058 ioapic
= mp_find_ioapic(gsi
);
1059 mp_irq
.dstapic
= mp_ioapics
[ioapic
].apicid
;
1060 mp_irq
.dstirq
= mp_find_ioapic_pin(ioapic
, gsi
);
1062 save_mp_irq(&mp_irq
);
1067 int mp_register_gsi(struct device
*dev
, u32 gsi
, int trigger
, int polarity
)
1071 struct io_apic_irq_attr irq_attr
;
1073 if (acpi_irq_model
!= ACPI_IRQ_MODEL_IOAPIC
)
1076 /* Don't set up the ACPI SCI because it's already set up */
1077 if (acpi_gbl_FADT
.sci_interrupt
== gsi
)
1080 ioapic
= mp_find_ioapic(gsi
);
1082 printk(KERN_WARNING
"No IOAPIC for GSI %u\n", gsi
);
1086 ioapic_pin
= mp_find_ioapic_pin(ioapic
, gsi
);
1088 #ifdef CONFIG_X86_32
1089 if (ioapic_renumber_irq
)
1090 gsi
= ioapic_renumber_irq(ioapic
, gsi
);
1093 if (ioapic_pin
> MP_MAX_IOAPIC_PIN
) {
1094 printk(KERN_ERR
"Invalid reference to IOAPIC pin "
1095 "%d-%d\n", mp_ioapics
[ioapic
].apicid
,
1100 if (enable_update_mptable
)
1101 mp_config_acpi_gsi(dev
, gsi
, trigger
, polarity
);
1103 set_io_apic_irq_attr(&irq_attr
, ioapic
, ioapic_pin
,
1104 trigger
== ACPI_EDGE_SENSITIVE
? 0 : 1,
1105 polarity
== ACPI_ACTIVE_HIGH
? 0 : 1);
1106 io_apic_set_pci_routing(dev
, gsi
, &irq_attr
);
1112 * Parse IOAPIC related entries in MADT
1113 * returns 0 on success, < 0 on error
1115 static int __init
acpi_parse_madt_ioapic_entries(void)
1120 * ACPI interpreter is required to complete interrupt setup,
1121 * so if it is off, don't enumerate the io-apics with ACPI.
1122 * If MPS is present, it will handle them,
1123 * otherwise the system will stay in PIC mode
1125 if (acpi_disabled
|| acpi_noirq
)
1132 * if "noapic" boot option, don't look for IO-APICs
1134 if (skip_ioapic_setup
) {
1135 printk(KERN_INFO PREFIX
"Skipping IOAPIC probe "
1136 "due to 'noapic' option.\n");
1141 acpi_table_parse_madt(ACPI_MADT_TYPE_IO_APIC
, acpi_parse_ioapic
,
1144 printk(KERN_ERR PREFIX
"No IOAPIC entries present\n");
1146 } else if (count
< 0) {
1147 printk(KERN_ERR PREFIX
"Error parsing IOAPIC entry\n");
1152 acpi_table_parse_madt(ACPI_MADT_TYPE_INTERRUPT_OVERRIDE
, acpi_parse_int_src_ovr
,
1155 printk(KERN_ERR PREFIX
1156 "Error parsing interrupt source overrides entry\n");
1157 /* TBD: Cleanup to allow fallback to MPS */
1162 * If BIOS did not supply an INT_SRC_OVR for the SCI
1163 * pretend we got one so we can set the SCI flags.
1165 if (!acpi_sci_override_gsi
)
1166 acpi_sci_ioapic_setup(acpi_gbl_FADT
.sci_interrupt
, 0, 0,
1167 acpi_gbl_FADT
.sci_interrupt
);
1169 /* Fill in identity legacy mappings where no override */
1170 mp_config_acpi_legacy_irqs();
1173 acpi_table_parse_madt(ACPI_MADT_TYPE_NMI_SOURCE
, acpi_parse_nmi_src
,
1176 printk(KERN_ERR PREFIX
"Error parsing NMI SRC entry\n");
1177 /* TBD: Cleanup to allow fallback to MPS */
1184 static inline int acpi_parse_madt_ioapic_entries(void)
1188 #endif /* !CONFIG_X86_IO_APIC */
1190 static void __init
early_acpi_process_madt(void)
1192 #ifdef CONFIG_X86_LOCAL_APIC
1195 if (!acpi_table_parse(ACPI_SIG_MADT
, acpi_parse_madt
)) {
1198 * Parse MADT LAPIC entries
1200 error
= early_acpi_parse_madt_lapic_addr_ovr();
1203 smp_found_config
= 1;
1205 if (error
== -EINVAL
) {
1207 * Dell Precision Workstation 410, 610 come here.
1209 printk(KERN_ERR PREFIX
1210 "Invalid BIOS MADT, disabling ACPI\n");
1217 static void __init
acpi_process_madt(void)
1219 #ifdef CONFIG_X86_LOCAL_APIC
1222 if (!acpi_table_parse(ACPI_SIG_MADT
, acpi_parse_madt
)) {
1225 * Parse MADT LAPIC entries
1227 error
= acpi_parse_madt_lapic_entries();
1232 * Parse MADT IO-APIC entries
1234 error
= acpi_parse_madt_ioapic_entries();
1236 acpi_irq_model
= ACPI_IRQ_MODEL_IOAPIC
;
1239 smp_found_config
= 1;
1242 if (error
== -EINVAL
) {
1244 * Dell Precision Workstation 410, 610 come here.
1246 printk(KERN_ERR PREFIX
1247 "Invalid BIOS MADT, disabling ACPI\n");
1252 * ACPI found no MADT, and so ACPI wants UP PIC mode.
1253 * In the event an MPS table was found, forget it.
1254 * Boot with "acpi=off" to use MPS on such a system.
1256 if (smp_found_config
) {
1257 printk(KERN_WARNING PREFIX
1258 "No APIC-table, disabling MPS\n");
1259 smp_found_config
= 0;
1264 * ACPI supports both logical (e.g. Hyper-Threading) and physical
1265 * processors, where MPS only supports physical.
1267 if (acpi_lapic
&& acpi_ioapic
)
1268 printk(KERN_INFO
"Using ACPI (MADT) for SMP configuration "
1270 else if (acpi_lapic
)
1271 printk(KERN_INFO
"Using ACPI for processor (LAPIC) "
1272 "configuration information\n");
1277 static int __init
disable_acpi_irq(const struct dmi_system_id
*d
)
1280 printk(KERN_NOTICE
"%s detected: force use of acpi=noirq\n",
1287 static int __init
disable_acpi_pci(const struct dmi_system_id
*d
)
1290 printk(KERN_NOTICE
"%s detected: force use of pci=noacpi\n",
1297 static int __init
dmi_disable_acpi(const struct dmi_system_id
*d
)
1300 printk(KERN_NOTICE
"%s detected: acpi off\n", d
->ident
);
1304 "Warning: DMI blacklist says broken, but acpi forced\n");
1310 * Force ignoring BIOS IRQ0 pin2 override
1312 static int __init
dmi_ignore_irq0_timer_override(const struct dmi_system_id
*d
)
1315 * The ati_ixp4x0_rev() early PCI quirk should have set
1316 * the acpi_skip_timer_override flag already:
1318 if (!acpi_skip_timer_override
) {
1319 WARN(1, KERN_ERR
"ati_ixp4x0 quirk not complete.\n");
1320 pr_notice("%s detected: Ignoring BIOS IRQ0 pin2 override\n",
1322 acpi_skip_timer_override
= 1;
1328 * If your system is blacklisted here, but you find that acpi=force
1329 * works for you, please contact linux-acpi@vger.kernel.org
1331 static struct dmi_system_id __initdata acpi_dmi_table
[] = {
1333 * Boxes that need ACPI disabled
1336 .callback
= dmi_disable_acpi
,
1337 .ident
= "IBM Thinkpad",
1339 DMI_MATCH(DMI_BOARD_VENDOR
, "IBM"),
1340 DMI_MATCH(DMI_BOARD_NAME
, "2629H1G"),
1345 * Boxes that need ACPI PCI IRQ routing disabled
1348 .callback
= disable_acpi_irq
,
1349 .ident
= "ASUS A7V",
1351 DMI_MATCH(DMI_BOARD_VENDOR
, "ASUSTeK Computer INC"),
1352 DMI_MATCH(DMI_BOARD_NAME
, "<A7V>"),
1353 /* newer BIOS, Revision 1011, does work */
1354 DMI_MATCH(DMI_BIOS_VERSION
,
1355 "ASUS A7V ACPI BIOS Revision 1007"),
1360 * Latest BIOS for IBM 600E (1.16) has bad pcinum
1361 * for LPC bridge, which is needed for the PCI
1362 * interrupt links to work. DSDT fix is in bug 5966.
1363 * 2645, 2646 model numbers are shared with 600/600E/600X
1365 .callback
= disable_acpi_irq
,
1366 .ident
= "IBM Thinkpad 600 Series 2645",
1368 DMI_MATCH(DMI_BOARD_VENDOR
, "IBM"),
1369 DMI_MATCH(DMI_BOARD_NAME
, "2645"),
1373 .callback
= disable_acpi_irq
,
1374 .ident
= "IBM Thinkpad 600 Series 2646",
1376 DMI_MATCH(DMI_BOARD_VENDOR
, "IBM"),
1377 DMI_MATCH(DMI_BOARD_NAME
, "2646"),
1381 * Boxes that need ACPI PCI IRQ routing and PCI scan disabled
1384 .callback
= disable_acpi_pci
,
1385 .ident
= "ASUS PR-DLS",
1387 DMI_MATCH(DMI_BOARD_VENDOR
, "ASUSTeK Computer INC."),
1388 DMI_MATCH(DMI_BOARD_NAME
, "PR-DLS"),
1389 DMI_MATCH(DMI_BIOS_VERSION
,
1390 "ASUS PR-DLS ACPI BIOS Revision 1010"),
1391 DMI_MATCH(DMI_BIOS_DATE
, "03/21/2003")
1395 .callback
= disable_acpi_pci
,
1396 .ident
= "Acer TravelMate 36x Laptop",
1398 DMI_MATCH(DMI_SYS_VENDOR
, "Acer"),
1399 DMI_MATCH(DMI_PRODUCT_NAME
, "TravelMate 360"),
1405 /* second table for DMI checks that should run after early-quirks */
1406 static struct dmi_system_id __initdata acpi_dmi_table_late
[] = {
1408 * HP laptops which use a DSDT reporting as HP/SB400/10000,
1409 * which includes some code which overrides all temperature
1410 * trip points to 16C if the INTIN2 input of the I/O APIC
1411 * is enabled. This input is incorrectly designated the
1412 * ISA IRQ 0 via an interrupt source override even though
1413 * it is wired to the output of the master 8259A and INTIN0
1414 * is not connected at all. Force ignoring BIOS IRQ0 pin2
1415 * override in that cases.
1418 .callback
= dmi_ignore_irq0_timer_override
,
1419 .ident
= "HP nx6115 laptop",
1421 DMI_MATCH(DMI_SYS_VENDOR
, "Hewlett-Packard"),
1422 DMI_MATCH(DMI_PRODUCT_NAME
, "HP Compaq nx6115"),
1426 .callback
= dmi_ignore_irq0_timer_override
,
1427 .ident
= "HP NX6125 laptop",
1429 DMI_MATCH(DMI_SYS_VENDOR
, "Hewlett-Packard"),
1430 DMI_MATCH(DMI_PRODUCT_NAME
, "HP Compaq nx6125"),
1434 .callback
= dmi_ignore_irq0_timer_override
,
1435 .ident
= "HP NX6325 laptop",
1437 DMI_MATCH(DMI_SYS_VENDOR
, "Hewlett-Packard"),
1438 DMI_MATCH(DMI_PRODUCT_NAME
, "HP Compaq nx6325"),
1442 .callback
= dmi_ignore_irq0_timer_override
,
1443 .ident
= "HP 6715b laptop",
1445 DMI_MATCH(DMI_SYS_VENDOR
, "Hewlett-Packard"),
1446 DMI_MATCH(DMI_PRODUCT_NAME
, "HP Compaq 6715b"),
1453 * acpi_boot_table_init() and acpi_boot_init()
1454 * called from setup_arch(), always.
1455 * 1. checksums all tables
1456 * 2. enumerates lapics
1457 * 3. enumerates io-apics
1459 * acpi_table_init() is separate to allow reading SRAT without
1460 * other side effects.
1462 * side effects of acpi_boot_init:
1463 * acpi_lapic = 1 if LAPIC found
1464 * acpi_ioapic = 1 if IOAPIC found
1465 * if (acpi_lapic && acpi_ioapic) smp_found_config = 1;
1466 * if acpi_blacklisted() acpi_disabled = 1;
1467 * acpi_irq_model=...
1471 void __init
acpi_boot_table_init(void)
1473 dmi_check_system(acpi_dmi_table
);
1476 * If acpi_disabled, bail out
1477 * One exception: acpi=ht continues far enough to enumerate LAPICs
1479 if (acpi_disabled
&& !acpi_ht
)
1483 * Initialize the ACPI boot-time table parser.
1485 if (acpi_table_init()) {
1490 acpi_table_parse(ACPI_SIG_BOOT
, acpi_parse_sbf
);
1493 * blacklist may disable ACPI entirely
1495 if (acpi_blacklisted()) {
1497 printk(KERN_WARNING PREFIX
"acpi=force override\n");
1499 printk(KERN_WARNING PREFIX
"Disabling ACPI support\n");
1506 int __init
early_acpi_boot_init(void)
1509 * If acpi_disabled, bail out
1510 * One exception: acpi=ht continues far enough to enumerate LAPICs
1512 if (acpi_disabled
&& !acpi_ht
)
1516 * Process the Multiple APIC Description Table (MADT), if present
1518 early_acpi_process_madt();
1523 int __init
acpi_boot_init(void)
1525 /* those are executed after early-quirks are executed */
1526 dmi_check_system(acpi_dmi_table_late
);
1529 * If acpi_disabled, bail out
1530 * One exception: acpi=ht continues far enough to enumerate LAPICs
1532 if (acpi_disabled
&& !acpi_ht
)
1535 acpi_table_parse(ACPI_SIG_BOOT
, acpi_parse_sbf
);
1538 * set sci_int and PM timer address
1540 acpi_table_parse(ACPI_SIG_FADT
, acpi_parse_fadt
);
1543 * Process the Multiple APIC Description Table (MADT), if present
1545 acpi_process_madt();
1547 acpi_table_parse(ACPI_SIG_HPET
, acpi_parse_hpet
);
1550 x86_init
.pci
.init
= pci_acpi_init
;
1555 static int __init
parse_acpi(char *arg
)
1560 /* "acpi=off" disables both ACPI table parsing and interpreter */
1561 if (strcmp(arg
, "off") == 0) {
1564 /* acpi=force to over-ride black-list */
1565 else if (strcmp(arg
, "force") == 0) {
1570 /* acpi=strict disables out-of-spec workarounds */
1571 else if (strcmp(arg
, "strict") == 0) {
1574 /* Limit ACPI just to boot-time to enable HT */
1575 else if (strcmp(arg
, "ht") == 0) {
1577 printk(KERN_WARNING
"acpi=ht will be removed in Linux-2.6.35\n");
1582 /* acpi=rsdt use RSDT instead of XSDT */
1583 else if (strcmp(arg
, "rsdt") == 0) {
1584 acpi_rsdt_forced
= 1;
1586 /* "acpi=noirq" disables ACPI interrupt routing */
1587 else if (strcmp(arg
, "noirq") == 0) {
1590 /* Core will printk when we return error. */
1595 early_param("acpi", parse_acpi
);
1597 /* FIXME: Using pci= for an ACPI parameter is a travesty. */
1598 static int __init
parse_pci(char *arg
)
1600 if (arg
&& strcmp(arg
, "noacpi") == 0)
1604 early_param("pci", parse_pci
);
1606 int __init
acpi_mps_check(void)
1608 #if defined(CONFIG_X86_LOCAL_APIC) && !defined(CONFIG_X86_MPPARSE)
1609 /* mptable code is not built-in*/
1610 if (acpi_disabled
|| acpi_noirq
) {
1611 printk(KERN_WARNING
"MPS support code is not built-in.\n"
1612 "Using acpi=off or acpi=noirq or pci=noacpi "
1613 "may have problem\n");
1620 #ifdef CONFIG_X86_IO_APIC
1621 static int __init
parse_acpi_skip_timer_override(char *arg
)
1623 acpi_skip_timer_override
= 1;
1626 early_param("acpi_skip_timer_override", parse_acpi_skip_timer_override
);
1628 static int __init
parse_acpi_use_timer_override(char *arg
)
1630 acpi_use_timer_override
= 1;
1633 early_param("acpi_use_timer_override", parse_acpi_use_timer_override
);
1634 #endif /* CONFIG_X86_IO_APIC */
1636 static int __init
setup_acpi_sci(char *s
)
1640 if (!strcmp(s
, "edge"))
1641 acpi_sci_flags
= ACPI_MADT_TRIGGER_EDGE
|
1642 (acpi_sci_flags
& ~ACPI_MADT_TRIGGER_MASK
);
1643 else if (!strcmp(s
, "level"))
1644 acpi_sci_flags
= ACPI_MADT_TRIGGER_LEVEL
|
1645 (acpi_sci_flags
& ~ACPI_MADT_TRIGGER_MASK
);
1646 else if (!strcmp(s
, "high"))
1647 acpi_sci_flags
= ACPI_MADT_POLARITY_ACTIVE_HIGH
|
1648 (acpi_sci_flags
& ~ACPI_MADT_POLARITY_MASK
);
1649 else if (!strcmp(s
, "low"))
1650 acpi_sci_flags
= ACPI_MADT_POLARITY_ACTIVE_LOW
|
1651 (acpi_sci_flags
& ~ACPI_MADT_POLARITY_MASK
);
1656 early_param("acpi_sci", setup_acpi_sci
);
1658 int __acpi_acquire_global_lock(unsigned int *lock
)
1660 unsigned int old
, new, val
;
1663 new = (((old
& ~0x3) + 2) + ((old
>> 1) & 0x1));
1664 val
= cmpxchg(lock
, old
, new);
1665 } while (unlikely (val
!= old
));
1666 return (new < 3) ? -1 : 0;
1669 int __acpi_release_global_lock(unsigned int *lock
)
1671 unsigned int old
, new, val
;
1675 val
= cmpxchg(lock
, old
, new);
1676 } while (unlikely (val
!= old
));