]> git.saurik.com Git - apple/xnu.git/blob - osfmk/i386/pal_routines.h
xnu-2422.100.13.tar.gz
[apple/xnu.git] / osfmk / i386 / pal_routines.h
1 /*
2 * Copyright (c) 2009-2012 Apple Inc. All rights reserved.
3 *
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5 *
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
14 *
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
17 *
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
25 *
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27 */
28 #ifndef _I386_PAL_ROUTINES_H
29 #define _I386_PAL_ROUTINES_H
30
31 #include <stdint.h>
32 #include <mach/kern_return.h>
33 #include <mach/mach_types.h>
34
35 #if defined(__cplusplus)
36 extern "C" {
37 #endif
38
39 /* PAL routines exported to kexts */
40
41 /*
42 * Load registers with these values. In 32-bit mode,
43 * only the low-order half is loaded (if applicable)
44 */
45 struct pal_efi_registers {
46 uint64_t rcx;
47 uint64_t rdx;
48 uint64_t r8;
49 uint64_t r9;
50 uint64_t rax;
51 };
52
53 /*
54 * Load registers and stack with these values before
55 * executing "call" instruction
56 */
57 kern_return_t
58 pal_efi_call_in_64bit_mode(uint64_t func,
59 struct pal_efi_registers *efi_reg,
60 void *stack_contents,
61 size_t stack_contents_size, /* 16-byte multiple */
62 uint64_t *efi_status);
63
64 kern_return_t
65 pal_efi_call_in_32bit_mode(uint32_t func,
66 struct pal_efi_registers *efi_reg,
67 void *stack_contents,
68 size_t stack_contents_size, /* 16-byte multiple */
69 uint32_t *efi_status);
70
71 /* Go into ACPI sleep */
72
73 boolean_t pal_machine_sleep(uint8_t type_a,
74 uint8_t type_b,
75 uint32_t bit_position,
76 uint32_t disable_mask,
77 uint32_t enable_mask);
78
79 /* xnu internal PAL routines */
80 #ifdef XNU_KERNEL_PRIVATE
81
82 /* Define any PAL-specific types for x86 */
83 typedef uint64_t pal_cr_t;
84
85 struct pal_cpu_data; /* Defined per-platform */
86 struct pal_pcb; /* Defined per-platform */
87 struct pal_apic_table; /* Defined per-platform */
88
89 /* For use by APIC kext */
90 extern struct pal_apic_table *apic_table;
91
92 /* serial / debug output routines */
93 extern int pal_serial_init(void);
94 extern void pal_serial_putc(char);
95 extern int pal_serial_getc(void);
96
97 /* Generic I386 PAL functions go here */
98 extern void pal_i386_init(void);
99 extern void pal_set_signal_delivery(thread_t);
100
101 /* Get values for cr0..4 */
102 extern void pal_get_control_registers( pal_cr_t *cr0, pal_cr_t *cr2,
103 pal_cr_t *cr3, pal_cr_t *cr4 );
104
105 /* Debug hook invoked in the page-fault path */
106 extern void pal_dbg_page_fault( thread_t thread, user_addr_t vadddr,
107 kern_return_t kr );
108
109 /* Set a task's name in the platform kernel debugger */
110 extern void pal_dbg_set_task_name( task_t task );
111
112 /* wind-back to the start of a system call */
113 void pal_syscall_restart(thread_t thread, x86_saved_state_t *state);
114
115 /* Hook for non-vfork exec */
116 void pal_execve_return(thread_t thread);
117
118 /* Called by thread_terminate_self() */
119 void pal_thread_terminate_self(thread_t thread);
120
121 /* Called by ast_check() */
122 void pal_ast_check(thread_t thread);
123
124 /* Called by sync_iss_to_iks */
125 extern void pal_get_kern_regs( x86_saved_state_t *state );
126
127 /* Called by load_machfile */
128 void pal_switch_pmap(thread_t, pmap_t, boolean_t);
129
130 /*
131 * Platform-specific hlt/sti.
132 */
133 extern void pal_hlt(void);
134 extern void pal_sti(void);
135 extern void pal_cli(void);
136
137 /*
138 * Mark in-memory thread register cache state validity.
139 */
140 typedef enum { DIRTY, VALID } pal_cache_state_t;
141 void pal_register_cache_state(thread_t thread, pal_cache_state_t state);
142
143
144 /* Catch code running on the except thread that shouldn't be */
145 void pal_preemption_assert(void);
146
147 void hibernate_pal_prepare(void);
148 void pal_efi_hibernate_prepare(void);
149
150 /* Include a PAL-specific header, too, for xnu-internal overrides */
151 #include <i386/pal_native.h>
152
153
154 extern boolean_t virtualized;
155 #define PAL_VIRTUALIZED_PROPERTY_VALUE 4
156
157 /* Allow for tricky IOKit property matching */
158 #define PAL_AICPM_PROPERTY_NAME "intel_cpupm_matching"
159 static inline void
160 pal_get_resource_property(const char **property_name, int *property_value)
161 {
162 *property_name = PAL_AICPM_PROPERTY_NAME;
163 *property_value = PAL_AICPM_PROPERTY_VALUE;
164 if (virtualized)
165 *property_value = PAL_VIRTUALIZED_PROPERTY_VALUE;
166 }
167
168 /* assembly function to update TSC / timebase info */
169 extern void _pal_rtc_nanotime_store(
170 uint64_t tsc,
171 uint64_t nsec,
172 uint32_t scale,
173 uint32_t shift,
174 struct pal_rtc_nanotime *dst);
175
176 /* global nanotime info */
177 extern struct pal_rtc_nanotime pal_rtc_nanotime_info;
178
179 #endif /* XNU_KERNEL_PRIVATE */
180
181 #if defined(__cplusplus)
182 }
183 #endif
184
185 #endif /* _I386_PAL_ROUTINES_H */