xnu-1699.22.73.tar.gz

[apple/xnu.git] / osfmk / i386 / machine_routines.h

diff --git a/osfmk/i386/machine_routines.h b/osfmk/i386/machine_routines.h
index 4908a08f5a5244963c6dc1aef29f40a993e51fbc..42f77f6c42aa95b961c3960ec234989a8d525753 100644 (file)
--- a/osfmk/i386/machine_routines.h
+++ b/osfmk/i386/machine_routines.h
@@ -1,23 +1,29 @@
 /*
 /*

- * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
+ * Copyright (c) 2000-2009 Apple Inc. All rights reserved.

  *
  *

- * @APPLE_LICENSE_HEADER_START@
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_START@

  * 
  * 

- * The contents of this file constitute Original Code as defined in and
- * are subject to the Apple Public Source License Version 1.1 (the
- * "License").  You may not use this file except in compliance with the
- * License.  Please obtain a copy of the License at
- * http://www.apple.com/publicsource and read it before using this file.
+ * This file contains Original Code and/or Modifications of Original Code
+ * as defined in and that are subject to the Apple Public Source License
+ * Version 2.0 (the 'License'). You may not use this file except in
+ * compliance with the License. The rights granted to you under the License
+ * may not be used to create, or enable the creation or redistribution of,
+ * unlawful or unlicensed copies of an Apple operating system, or to
+ * circumvent, violate, or enable the circumvention or violation of, any
+ * terms of an Apple operating system software license agreement.

  * 
  * 

- * This Original Code and all software distributed under the License are
- * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
+ * Please obtain a copy of the License at
+ * http://www.opensource.apple.com/apsl/ and read it before using this file.
+ * 
+ * The Original Code and all software distributed under the License are
+ * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER

  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,

- * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
- * License for the specific language governing rights and limitations
- * under the License.
+ * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
+ * Please see the License for the specific language governing rights and
+ * limitations under the License.

  * 
  * 

- * @APPLE_LICENSE_HEADER_END@
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_END@

  */
 /*
  * @OSF_COPYRIGHT@
  */
 /*
  * @OSF_COPYRIGHT@


@@ -31,34 +37,38 @@
 #include <kern/kern_types.h>
 #include <pexpert/pexpert.h>
 
 #include <kern/kern_types.h>
 #include <pexpert/pexpert.h>
 

+#include <sys/cdefs.h>

 #include <sys/appleapiopts.h>
 
 #include <sys/appleapiopts.h>
 

-/* Interrupt handling */
+__BEGIN_DECLS

 
 

-/* Get Interrupts Enabled */
-boolean_t ml_get_interrupts_enabled(void);
+#ifdef XNU_KERNEL_PRIVATE

 
 

-/* Set Interrupts Enabled */
-boolean_t ml_set_interrupts_enabled(boolean_t enable);
+/* are we a 64 bit platform ? */

 
 

-/* Check if running at interrupt context */
-boolean_t ml_at_interrupt_context(void);
+boolean_t ml_is64bit(void);

 
 

-/* Generate a fake interrupt */
-void ml_cause_interrupt(void);
+/* is this a 64bit thread? */

 
 

-void ml_get_timebase(unsigned long long *timestamp);
+boolean_t ml_thread_is64bit(thread_t);

 
 

-/* Type for the IPI Hander */
-typedef void (*ipi_handler_t)(void);
+/* is this a 64bit thread? */

 
 

-/* Register a processor */
-kern_return_t ml_processor_register(
-       cpu_id_t cpu_id,
-       vm_offset_t start_paddr,
-       processor_t *processor,
-       ipi_handler_t *ipi_handler,
-       boolean_t boot_cpu);
+boolean_t ml_state_is64bit(void *);
+
+/* set state of fpu save area for signal handling */
+
+void   ml_fp_setvalid(boolean_t);
+
+void   ml_cpu_set_ldt(int);
+
+/* Interrupt handling */
+
+/* Initialize Interrupts */
+void    ml_init_interrupt(void);
+
+/* Generate a fake interrupt */
+void ml_cause_interrupt(void);

 
 /* Initialize Interrupts */
 void ml_install_interrupt_handler(
 
 /* Initialize Interrupts */
 void ml_install_interrupt_handler(


@@ -68,7 +78,9 @@ void ml_install_interrupt_handler(
     IOInterruptHandler handler,
     void *refCon);
 
     IOInterruptHandler handler,
     void *refCon);
 

-#ifdef __APPLE_API_UNSTABLE
+void ml_get_timebase(unsigned long long *timestamp);
+void ml_init_lock_timeout(void); 
+

 vm_offset_t
 ml_static_ptovirt(
        vm_offset_t);
 vm_offset_t
 ml_static_ptovirt(
        vm_offset_t);


@@ -77,13 +89,32 @@ void ml_static_mfree(
        vm_offset_t,
        vm_size_t);
 
        vm_offset_t,
        vm_size_t);
 

+/* boot memory allocation */
+vm_offset_t ml_static_malloc(
+       vm_size_t size);
+

 /* virtual to physical on wired pages */
 vm_offset_t ml_vtophys(
        vm_offset_t vaddr);
 
 /* virtual to physical on wired pages */
 vm_offset_t ml_vtophys(
        vm_offset_t vaddr);
 

-#endif /* __APPLE_API_UNSTABLE */
+vm_size_t ml_nofault_copy(
+       vm_offset_t virtsrc, vm_offset_t virtdst, vm_size_t size);
+
+/* Machine topology info */
+uint64_t ml_cpu_cache_size(unsigned int level);        
+uint64_t ml_cpu_cache_sharing(unsigned int level);     
+
+/* Initialize the maximum number of CPUs */
+void ml_init_max_cpus(
+       unsigned long max_cpus);
+
+extern void    ml_cpu_up(void);
+extern void    ml_cpu_down(void);
+
+void bzero_phys_nc(
+                                  addr64_t phys_address,
+                                  uint32_t length);

 
 

-#ifdef __APPLE_API_PRIVATE

 #if    defined(PEXPERT_KERNEL_PRIVATE) || defined(MACH_KERNEL_PRIVATE)
 /* IO memory map services */
 
 #if    defined(PEXPERT_KERNEL_PRIVATE) || defined(MACH_KERNEL_PRIVATE)
 /* IO memory map services */
 


@@ -92,21 +123,129 @@ vm_offset_t ml_io_map(
        vm_offset_t phys_addr, 
        vm_size_t size);
 
        vm_offset_t phys_addr, 
        vm_size_t size);
 

-/* boot memory allocation */
-vm_offset_t ml_static_malloc(
-       vm_size_t size);

 
 

+void   ml_get_bouncepool_info(
+                              vm_offset_t *phys_addr,
+                              vm_size_t   *size);
+/* Indicates if spinlock, IPI and other timeouts should be suspended */
+boolean_t machine_timeout_suspended(void);

 #endif /* PEXPERT_KERNEL_PRIVATE || MACH_KERNEL_PRIVATE  */
 
 #endif /* PEXPERT_KERNEL_PRIVATE || MACH_KERNEL_PRIVATE  */
 

-#ifdef  MACH_KERNEL_PRIVATE 
-/* check pending timers */
-#define machine_clock_assist()
+/* Warm up a CPU to receive an interrupt */
+kern_return_t ml_interrupt_prewarm(uint64_t deadline);
+
+#endif /* XNU_KERNEL_PRIVATE */

 
 

-void machine_idle(void);
+#ifdef KERNEL_PRIVATE

 
 

-void machine_signal_idle(
-        processor_t processor);
-#endif /* MACH_KERNEL_PRIVATE */
+/* Type for the Time Base Enable function */
+typedef void (*time_base_enable_t)(cpu_id_t cpu_id, boolean_t enable);
+
+/* Type for the IPI Hander */
+typedef void (*ipi_handler_t)(void);
+
+/* Struct for ml_processor_register */
+struct ml_processor_info {
+       cpu_id_t                        cpu_id;
+       boolean_t                       boot_cpu;
+       vm_offset_t                     start_paddr;
+       boolean_t                       supports_nap;
+       unsigned long           l2cr_value;
+       time_base_enable_t      time_base_enable;
+};
+
+typedef struct ml_processor_info ml_processor_info_t;
+
+
+/* Register a processor */
+kern_return_t
+ml_processor_register(
+        cpu_id_t        cpu_id,
+        uint32_t        lapic_id,
+        processor_t     *processor_out,
+        boolean_t       boot_cpu,
+       boolean_t       start );
+
+/* PCI config cycle probing */
+boolean_t ml_probe_read(
+       vm_offset_t paddr,
+       unsigned int *val);
+boolean_t ml_probe_read_64(
+       addr64_t paddr,
+       unsigned int *val);
+
+/* Read physical address byte */
+unsigned int ml_phys_read_byte(
+       vm_offset_t paddr);
+unsigned int ml_phys_read_byte_64(
+       addr64_t paddr);
+
+/* Read physical address half word */
+unsigned int ml_phys_read_half(
+       vm_offset_t paddr);
+unsigned int ml_phys_read_half_64(
+       addr64_t paddr);
+
+/* Read physical address word*/
+unsigned int ml_phys_read(
+       vm_offset_t paddr);
+unsigned int ml_phys_read_64(
+       addr64_t paddr);
+unsigned int ml_phys_read_word(
+       vm_offset_t paddr);
+unsigned int ml_phys_read_word_64(
+       addr64_t paddr);
+
+/* Read physical address double word */
+unsigned long long ml_phys_read_double(
+       vm_offset_t paddr);
+unsigned long long ml_phys_read_double_64(
+       addr64_t paddr);
+
+/* Write physical address byte */
+void ml_phys_write_byte(
+       vm_offset_t paddr, unsigned int data);
+void ml_phys_write_byte_64(
+       addr64_t paddr, unsigned int data);
+
+/* Write physical address half word */
+void ml_phys_write_half(
+       vm_offset_t paddr, unsigned int data);
+void ml_phys_write_half_64(
+       addr64_t paddr, unsigned int data);
+
+/* Write physical address word */
+void ml_phys_write(
+       vm_offset_t paddr, unsigned int data);
+void ml_phys_write_64(
+       addr64_t paddr, unsigned int data);
+void ml_phys_write_word(
+       vm_offset_t paddr, unsigned int data);
+void ml_phys_write_word_64(
+       addr64_t paddr, unsigned int data);
+
+/* Write physical address double word */
+void ml_phys_write_double(
+       vm_offset_t paddr, unsigned long long data);
+void ml_phys_write_double_64(
+       addr64_t paddr, unsigned long long data);
+
+/* Struct for ml_cpu_get_info */
+struct ml_cpu_info {
+       uint32_t        vector_unit;
+       uint32_t        cache_line_size;
+       uint32_t        l1_icache_size;
+       uint32_t        l1_dcache_size;
+       uint32_t        l2_settings;
+       uint32_t        l2_cache_size;
+       uint32_t        l3_settings;
+       uint32_t        l3_cache_size;
+};
+
+typedef struct ml_cpu_info ml_cpu_info_t;
+
+/* Get processor info */
+void ml_cpu_get_info(ml_cpu_info_t *ml_cpu_info);

 
 void ml_thread_policy(
        thread_t thread,
 
 void ml_thread_policy(
        thread_t thread,


@@ -118,6 +257,56 @@ void ml_thread_policy(
 #define MACHINE_NETWORK_WORKLOOP               0x00000001
 #define MACHINE_NETWORK_NETISR                 0x00000002
 
 #define MACHINE_NETWORK_WORKLOOP               0x00000001
 #define MACHINE_NETWORK_NETISR                 0x00000002
 

-#endif /* __APPLE_API_PRIVATE */
+/* Return the maximum number of CPUs set by ml_init_max_cpus() */
+int ml_get_max_cpus(
+       void);
+
+/*
+ * The following are in pmCPU.c not machine_routines.c.
+ */
+extern void ml_set_maxsnoop(uint32_t maxdelay);
+extern unsigned ml_get_maxsnoop(void);
+extern void ml_set_maxbusdelay(uint32_t mdelay);
+extern uint32_t ml_get_maxbusdelay(void);
+extern void ml_set_maxintdelay(uint64_t mdelay);
+extern uint64_t ml_get_maxintdelay(void);
+extern boolean_t ml_get_interrupt_prewake_applicable(void);
+
+
+extern uint64_t tmrCvt(uint64_t time, uint64_t conversion);
+
+extern uint64_t ml_cpu_int_event_time(void);
+
+#endif /* KERNEL_PRIVATE */
+
+/* Get Interrupts Enabled */
+boolean_t ml_get_interrupts_enabled(void);
+
+/* Set Interrupts Enabled */
+boolean_t ml_set_interrupts_enabled(boolean_t enable);
+
+/* Check if running at interrupt context */
+boolean_t ml_at_interrupt_context(void);
+
+/* Zero bytes starting at a physical address */
+void bzero_phys(
+       addr64_t phys_address,
+       uint32_t length);
+
+/* Bytes available on current stack */
+vm_offset_t ml_stack_remaining(void);
+
+#if CONFIG_COUNTERS
+void ml_get_csw_threads(thread_t * /*old*/, thread_t * /*new*/);
+#endif /* CONFIG_COUNTERS */
+
+__END_DECLS
+
+#ifdef XNU_KERNEL_PRIVATE
+boolean_t ml_fpu_avx_enabled(void);
+void interrupt_latency_tracker_setup(void);
+void interrupt_reset_latency_stats(void);
+void interrupt_populate_latency_stats(char *, unsigned);

 
 

+#endif /* XNU_KERNEL_PRIVATE */

 #endif /* _I386_MACHINE_ROUTINES_H_ */
 #endif /* _I386_MACHINE_ROUTINES_H_ */