2 * Copyright (c) 2000-2006 Apple Computer, Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
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.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
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.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
33 * x86 CPU identification
37 #ifndef _MACHINE_CPUID_H_
38 #define _MACHINE_CPUID_H_
40 #include <sys/appleapiopts.h>
42 #ifdef __APPLE_API_PRIVATE
44 #define CPUID_VID_INTEL "GenuineIntel"
45 #define CPUID_VID_AMD "AuthenticAMD"
47 #define CPUID_STRING_UNKNOWN "Unknown CPU Typ"
49 #define _Bit(n) (1ULL << n)
50 #define _HBit(n) (1ULL << ((n)+32))
53 * The CPUID_FEATURE_XXX values define 64-bit values
54 * returned in %ecx:%edx to a CPUID request with %eax of 1:
56 #define CPUID_FEATURE_FPU _Bit(0) /* Floating point unit on-chip */
57 #define CPUID_FEATURE_VME _Bit(1) /* Virtual Mode Extension */
58 #define CPUID_FEATURE_DE _Bit(2) /* Debugging Extension */
59 #define CPUID_FEATURE_PSE _Bit(3) /* Page Size Extension */
60 #define CPUID_FEATURE_TSC _Bit(4) /* Time Stamp Counter */
61 #define CPUID_FEATURE_MSR _Bit(5) /* Model Specific Registers */
62 #define CPUID_FEATURE_PAE _Bit(6) /* Physical Address Extension */
63 #define CPUID_FEATURE_MCE _Bit(7) /* Machine Check Exception */
64 #define CPUID_FEATURE_CX8 _Bit(8) /* CMPXCHG8B */
65 #define CPUID_FEATURE_APIC _Bit(9) /* On-chip APIC */
66 #define CPUID_FEATURE_SEP _Bit(11) /* Fast System Call */
67 #define CPUID_FEATURE_MTRR _Bit(12) /* Memory Type Range Register */
68 #define CPUID_FEATURE_PGE _Bit(13) /* Page Global Enable */
69 #define CPUID_FEATURE_MCA _Bit(14) /* Machine Check Architecture */
70 #define CPUID_FEATURE_CMOV _Bit(15) /* Conditional Move Instruction */
71 #define CPUID_FEATURE_PAT _Bit(16) /* Page Attribute Table */
72 #define CPUID_FEATURE_PSE36 _Bit(17) /* 36-bit Page Size Extension */
73 #define CPUID_FEATURE_PSN _Bit(18) /* Processor Serial Number */
74 #define CPUID_FEATURE_CLFSH _Bit(19) /* CLFLUSH Instruction supported */
75 #define CPUID_FEATURE_DS _Bit(21) /* Debug Store */
76 #define CPUID_FEATURE_ACPI _Bit(22) /* Thermal monitor and Clock Ctrl */
77 #define CPUID_FEATURE_MMX _Bit(23) /* MMX supported */
78 #define CPUID_FEATURE_FXSR _Bit(24) /* Fast floating pt save/restore */
79 #define CPUID_FEATURE_SSE _Bit(25) /* Streaming SIMD extensions */
80 #define CPUID_FEATURE_SSE2 _Bit(26) /* Streaming SIMD extensions 2 */
81 #define CPUID_FEATURE_SS _Bit(27) /* Self-Snoop */
82 #define CPUID_FEATURE_HTT _Bit(28) /* Hyper-Threading Technology */
83 #define CPUID_FEATURE_TM _Bit(29) /* Thermal Monitor (TM1) */
84 #define CPUID_FEATURE_PBE _Bit(31) /* Pend Break Enable */
86 #define CPUID_FEATURE_SSE3 _HBit(0) /* Streaming SIMD extensions 3 */
87 #define CPUID_FEATURE_MONITOR _HBit(3) /* Monitor/mwait */
88 #define CPUID_FEATURE_DSCPL _HBit(4) /* Debug Store CPL */
89 #define CPUID_FEATURE_VMX _HBit(5) /* VMX */
90 #define CPUID_FEATURE_SMX _HBit(6) /* SMX */
91 #define CPUID_FEATURE_EST _HBit(7) /* Enhanced SpeedsTep (GV3) */
92 #define CPUID_FEATURE_TM2 _HBit(8) /* Thermal Monitor 2 */
93 #define CPUID_FEATURE_SSSE3 _HBit(9) /* Supplemental SSE3 instructions */
94 #define CPUID_FEATURE_CID _HBit(10) /* L1 Context ID */
95 #define CPUID_FEATURE_CX16 _HBit(13) /* CmpXchg16b instruction */
96 #define CPUID_FEATURE_xTPR _HBit(14) /* Send Task PRiority msgs */
97 #define CPUID_FEATURE_PDCM _HBit(15) /* Perf/Debug Capability MSR */
98 #define CPUID_FEATURE_DCA _HBit(18) /* Direct Cache Access */
99 #define CPUID_FEATURE_SSE4_1 _HBit(19) /* Streaming SIMD extensions 4.1 */
100 #define CPUID_FEATURE_SSE4_2 _HBit(20) /* Streaming SIMD extensions 4.2 */
101 #define CPUID_FEATURE_xAPIC _HBit(21) /* Extended APIC Mode */
102 #define CPUID_FEATURE_POPCNT _HBit(23) /* POPCNT instruction */
105 * The CPUID_EXTFEATURE_XXX values define 64-bit values
106 * returned in %ecx:%edx to a CPUID request with %eax of 0x80000001:
108 #define CPUID_EXTFEATURE_SYSCALL _Bit(11) /* SYSCALL/sysret */
109 #define CPUID_EXTFEATURE_XD _Bit(20) /* eXecute Disable */
110 #define CPUID_EXTFEATURE_EM64T _Bit(29) /* Extended Mem 64 Technology */
112 #define CPUID_EXTFEATURE_LAHF _HBit(20) /* LAFH/SAHF instructions */
114 #define CPUID_CACHE_SIZE 16 /* Number of descriptor vales */
116 #define CPUID_CACHE_NULL 0x00 /* NULL */
117 #define CPUID_CACHE_ITLB_4K_32_4 0x01 /* Inst TLB: 4K pages, 32 ents, 4-way */
118 #define CPUID_CACHE_ITLB_4M_2 0x02 /* Inst TLB: 4M pages, 2 ents */
119 #define CPUID_CACHE_DTLB_4K_64_4 0x03 /* Data TLB: 4K pages, 64 ents, 4-way */
120 #define CPUID_CACHE_DTLB_4M_8_4 0x04 /* Data TLB: 4M pages, 8 ents, 4-way */
121 #define CPUID_CACHE_DTLB_4M_32_4 0x05 /* Data TLB: 4M pages, 32 ents, 4-way */
122 #define CPUID_CACHE_L1I_8K 0x06 /* Icache: 8K */
123 #define CPUID_CACHE_L1I_16K 0x08 /* Icache: 16K */
124 #define CPUID_CACHE_L1I_32K 0x09 /* Icache: 32K, 4-way, 64 bytes */
125 #define CPUID_CACHE_L1D_8K 0x0A /* Dcache: 8K */
126 #define CPUID_CACHE_L1D_16K 0x0C /* Dcache: 16K */
127 #define CPUID_CACHE_L1D_16K_4_32 0x0D /* Dcache: 16K, 4-way, 64 byte, ECC */
128 #define CPUID_CACHE_L2_256K_8_64 0x21 /* L2: 256K, 8-way, 64 bytes */
129 #define CPUID_CACHE_L3_512K 0x22 /* L3: 512K */
130 #define CPUID_CACHE_L3_1M 0x23 /* L3: 1M */
131 #define CPUID_CACHE_L3_2M 0x25 /* L3: 2M */
132 #define CPUID_CACHE_L3_4M 0x29 /* L3: 4M */
133 #define CPUID_CACHE_L1D_32K_8 0x2C /* Dcache: 32K, 8-way, 64 byte */
134 #define CPUID_CACHE_L1I_32K_8 0x30 /* Icache: 32K, 8-way */
135 #define CPUID_CACHE_L2_128K_S4 0x39 /* L2: 128K, 4-way, sectored */
136 #define CPUID_CACHE_L2_128K_S2 0x3B /* L2: 128K, 2-way, sectored */
137 #define CPUID_CACHE_L2_256K_S4 0x3C /* L2: 256K, 4-way, sectored */
138 #define CPUID_CACHE_NOCACHE 0x40 /* No 2nd level or 3rd-level cache */
139 #define CPUID_CACHE_L2_128K 0x41 /* L2: 128K */
140 #define CPUID_CACHE_L2_256K 0x42 /* L2: 256K */
141 #define CPUID_CACHE_L2_512K 0x43 /* L2: 512K */
142 #define CPUID_CACHE_L2_1M_4 0x44 /* L2: 1M, 4-way */
143 #define CPUID_CACHE_L2_2M_4 0x45 /* L2: 2M, 4-way */
144 #define CPUID_CACHE_L3_4M_4_64 0x46 /* L3: 4M, 4-way, 64 bytes */
145 #define CPUID_CACHE_L3_8M_8_64 0x47 /* L3: 8M, 8-way, 64 bytes*/
146 #define CPUID_CACHE_L2_3M_12_64 0x48 /* L3: 3M, 8-way, 64 bytes*/
147 #define CPUID_CACHE_L2_4M_16_64 0x49 /* L2: 4M, 16-way, 64 bytes */
148 #define CPUID_CACHE_L2_6M_12_64 0x4A /* L2: 6M, 12-way, 64 bytes */
149 #define CPUID_CACHE_L2_8M_16_64 0x4B /* L2: 8M, 16-way, 64 bytes */
150 #define CPUID_CACHE_L2_12M_12_64 0x4C /* L2: 12M, 12-way, 64 bytes */
151 #define CPUID_CACHE_L2_16M_16_64 0x4D /* L2: 16M, 16-way, 64 bytes */
152 #define CPUID_CACHE_L2_6M_24_64 0x4E /* L2: 6M, 24-way, 64 bytes */
153 #define CPUID_CACHE_ITLB_64 0x50 /* Inst TLB: 64 entries */
154 #define CPUID_CACHE_ITLB_128 0x51 /* Inst TLB: 128 entries */
155 #define CPUID_CACHE_ITLB_256 0x52 /* Inst TLB: 256 entries */
156 #define CPUID_CACHE_ITLB_4M2M_7 0x55 /* Inst TLB: 4M/2M, 7 entries */
157 #define CPUID_CACHE_DTLB_4M_16_4 0x56 /* Data TLB: 4M, 16 entries, 4-way */
158 #define CPUID_CACHE_DTLB_4K_16_4 0x57 /* Data TLB: 4K, 16 entries, 4-way */
159 #define CPUID_CACHE_DTLB_4M2M_32_4 0x5A /* Data TLB: 4M/2M, 32 entries */
160 #define CPUID_CACHE_DTLB_64 0x5B /* Data TLB: 64 entries */
161 #define CPUID_CACHE_DTLB_128 0x5C /* Data TLB: 128 entries */
162 #define CPUID_CACHE_DTLB_256 0x5D /* Data TLB: 256 entries */
163 #define CPUID_CACHE_L1D_16K_8_64 0x60 /* Data cache: 16K, 8-way, 64 bytes */
164 #define CPUID_CACHE_L1D_8K_4_64 0x66 /* Data cache: 8K, 4-way, 64 bytes */
165 #define CPUID_CACHE_L1D_16K_4_64 0x67 /* Data cache: 16K, 4-way, 64 bytes */
166 #define CPUID_CACHE_L1D_32K_4_64 0x68 /* Data cache: 32K, 4-way, 64 bytes */
167 #define CPUID_CACHE_TRACE_12K_8 0x70 /* Trace cache 12K-uop, 8-way */
168 #define CPUID_CACHE_TRACE_16K_8 0x71 /* Trace cache 16K-uop, 8-way */
169 #define CPUID_CACHE_TRACE_32K_8 0x72 /* Trace cache 32K-uop, 8-way */
170 #define CPUID_CACHE_L2_1M_4_64 0x78 /* L2: 1M, 4-way, 64 bytes */
171 #define CPUID_CACHE_L2_128K_8_64_2 0x79 /* L2: 128K, 8-way, 64b, 2 lines/sec */
172 #define CPUID_CACHE_L2_256K_8_64_2 0x7A /* L2: 256K, 8-way, 64b, 2 lines/sec */
173 #define CPUID_CACHE_L2_512K_8_64_2 0x7B /* L2: 512K, 8-way, 64b, 2 lines/sec */
174 #define CPUID_CACHE_L2_1M_8_64_2 0x7C /* L2: 1M, 8-way, 64b, 2 lines/sec */
175 #define CPUID_CACHE_L2_2M_8_64 0x7D /* L2: 2M, 8-way, 64 bytes */
176 #define CPUID_CACHE_L2_512K_2_64 0x7F /* L2: 512K, 2-way, 64 bytes */
177 #define CPUID_CACHE_L2_256K_8_32 0x82 /* L2: 256K, 8-way, 32 bytes */
178 #define CPUID_CACHE_L2_512K_8_32 0x83 /* L2: 512K, 8-way, 32 bytes */
179 #define CPUID_CACHE_L2_1M_8_32 0x84 /* L2: 1M, 8-way, 32 bytes */
180 #define CPUID_CACHE_L2_2M_8_32 0x85 /* L2: 2M, 8-way, 32 bytes */
181 #define CPUID_CACHE_L2_512K_4_64 0x86 /* L2: 512K, 4-way, 64 bytes */
182 #define CPUID_CACHE_L2_1M_8_64 0x87 /* L2: 1M, 8-way, 64 bytes */
183 #define CPUID_CACHE_ITLB_4K_128_4 0xB0 /* ITLB: 4KB, 128 entries, 4-way */
184 #define CPUID_CACHE_ITLB_4M_4_4 0xB1 /* ITLB: 4MB, 4 entries, 4-way, or */
185 #define CPUID_CACHE_ITLB_2M_8_4 0xB1 /* ITLB: 2MB, 8 entries, 4-way, or */
186 #define CPUID_CACHE_ITLB_4M_8 0xB1 /* ITLB: 4MB, 8 entries */
187 #define CPUID_CACHE_ITLB_4K_64_4 0xB2 /* ITLB: 4KB, 64 entries, 4-way */
188 #define CPUID_CACHE_DTLB_4K_128_4 0xB3 /* DTLB: 4KB, 128 entries, 4-way */
189 #define CPUID_CACHE_DTLB_4K_256_4 0xB4 /* DTLB: 4KB, 256 entries, 4-way */
190 #define CPUID_CACHE_2TLB_4K_512_4 0xB4 /* 2nd-level TLB: 4KB, 512, 4-way */
191 #define CPUID_CACHE_L3_512K_4_64 0xD0 /* L3: 512KB, 4-way, 64 bytes */
192 #define CPUID_CACHE_L3_1M_4_64 0xD1 /* L3: 1M, 4-way, 64 bytes */
193 #define CPUID_CACHE_L3_2M_4_64 0xD2 /* L3: 2M, 4-way, 64 bytes */
194 #define CPUID_CACHE_L3_1M_8_64 0xD6 /* L3: 1M, 8-way, 64 bytes */
195 #define CPUID_CACHE_L3_2M_8_64 0xD7 /* L3: 2M, 8-way, 64 bytes */
196 #define CPUID_CACHE_L3_4M_8_64 0xD8 /* L3: 4M, 8-way, 64 bytes */
197 #define CPUID_CACHE_L3_1M5_12_64 0xDC /* L3: 1.5M, 12-way, 64 bytes */
198 #define CPUID_CACHE_L3_3M_12_64 0xDD /* L3: 3M, 12-way, 64 bytes */
199 #define CPUID_CACHE_L3_6M_12_64 0xDE /* L3: 6M, 12-way, 64 bytes */
200 #define CPUID_CACHE_L3_2M_16_64 0xE2 /* L3: 2M, 16-way, 64 bytes */
201 #define CPUID_CACHE_L3_4M_16_64 0xE3 /* L3: 4M, 16-way, 64 bytes */
202 #define CPUID_CACHE_L3_8M_16_64 0xE4 /* L3: 8M, 16-way, 64 bytes */
203 #define CPUID_CACHE_PREFETCH_64 0xF0 /* 64-Byte Prefetching */
204 #define CPUID_CACHE_PREFETCH_128 0xF1 /* 128-Byte Prefetching */
206 #define CPUID_MWAIT_EXTENSION _Bit(0) /* enumeration of WMAIT extensions */
207 #define CPUID_MWAIT_BREAK _Bit(1) /* interrupts are break events */
209 #define CPUID_MODEL_YONAH 14
210 #define CPUID_MODEL_MEROM 15
211 #define CPUID_MODEL_PENRYN 23
212 #define CPUID_MODEL_NEHALEM 26
216 #include <mach/mach_types.h>
217 #include <kern/kern_types.h>
218 #include <mach/machine.h>
221 typedef enum { eax
, ebx
, ecx
, edx
} cpuid_register_t
;
223 cpuid(uint32_t *data
)
236 do_cpuid(uint32_t selector
, uint32_t *data
)
247 * Cache ID descriptor structure, used to parse CPUID leaf 2.
248 * Note: not used in kernel.
250 typedef enum { Lnone
, L1I
, L1D
, L2U
, L3U
, LCACHE_MAX
} cache_type_t
;
252 unsigned char value
; /* Descriptor value */
253 cache_type_t type
; /* Cache type */
254 unsigned int size
; /* Cache size */
255 unsigned int linesize
; /* Cache line size */
257 const char *description
; /* Cache description */
259 } cpuid_cache_desc_t
;
262 #define CACHE_DESC(value,type,size,linesize,text) \
263 { value, type, size, linesize, text }
265 #define CACHE_DESC(value,type,size,linesize,text) \
266 { value, type, size, linesize }
269 /* Physical CPU info - this is exported out of the kernel (kexts), so be wary of changes */
271 char cpuid_vendor
[16];
272 char cpuid_brand_string
[48];
273 const char *cpuid_model_string
;
275 cpu_type_t cpuid_type
; /* this is *not* a cpu_type_t in our <mach/machine.h> */
276 uint8_t cpuid_family
;
278 uint8_t cpuid_extmodel
;
279 uint8_t cpuid_extfamily
;
280 uint8_t cpuid_stepping
;
281 uint64_t cpuid_features
;
282 uint64_t cpuid_extfeatures
;
283 uint32_t cpuid_signature
;
286 uint32_t cache_size
[LCACHE_MAX
];
287 uint32_t cache_linesize
;
289 uint8_t cache_info
[64]; /* list of cache descriptors */
291 uint32_t cpuid_cores_per_package
;
292 uint32_t cpuid_logical_per_package
;
293 uint32_t cache_sharing
[LCACHE_MAX
];
294 uint32_t cache_partitions
[LCACHE_MAX
];
296 cpu_type_t cpuid_cpu_type
; /* <mach/machine.h> */
297 cpu_subtype_t cpuid_cpu_subtype
; /* <mach/machine.h> */
299 /* Monitor/mwait Leaf: */
300 uint32_t cpuid_mwait_linesize_min
;
301 uint32_t cpuid_mwait_linesize_max
;
302 uint32_t cpuid_mwait_extensions
;
303 uint32_t cpuid_mwait_sub_Cstates
;
305 /* Thermal and Power Management Leaf: */
306 boolean_t cpuid_thermal_sensor
;
307 boolean_t cpuid_thermal_dynamic_acceleration
;
308 uint32_t cpuid_thermal_thresholds
;
309 boolean_t cpuid_thermal_ACNT_MCNT
;
311 /* Architectural Performance Monitoring Leaf: */
312 uint8_t cpuid_arch_perf_version
;
313 uint8_t cpuid_arch_perf_number
;
314 uint8_t cpuid_arch_perf_width
;
315 uint8_t cpuid_arch_perf_events_number
;
316 uint32_t cpuid_arch_perf_events
;
317 uint8_t cpuid_arch_perf_fixed_number
;
318 uint8_t cpuid_arch_perf_fixed_width
;
321 uint32_t cpuid_cache_linesize
;
322 uint32_t cpuid_cache_L2_associativity
;
323 uint32_t cpuid_cache_size
;
325 /* Virtual and physical address aize: */
326 uint32_t cpuid_address_bits_physical
;
327 uint32_t cpuid_address_bits_virtual
;
329 uint32_t cpuid_microcode_version
;
331 /* Numbers of tlbs per processor */
332 uint32_t cpuid_itlb_small
;
333 uint32_t cpuid_dtlb_small
;
334 uint32_t cpuid_itlb_large
;
335 uint32_t cpuid_dtlb_large
;
338 uint32_t thread_count
;
347 * External declarations
349 extern cpu_type_t
cpuid_cputype(void);
350 extern cpu_subtype_t
cpuid_cpusubtype(void);
351 extern void cpuid_cpu_display(const char *);
352 extern void cpuid_feature_display(const char *);
353 extern void cpuid_extfeature_display(const char *);
354 extern char * cpuid_get_feature_names(uint64_t, char *, unsigned);
355 extern char * cpuid_get_extfeature_names(uint64_t, char *, unsigned);
357 extern uint64_t cpuid_features(void);
358 extern uint64_t cpuid_extfeatures(void);
359 extern uint32_t cpuid_family(void);
361 extern void cpuid_get_info(i386_cpu_info_t
*info_p
);
362 extern i386_cpu_info_t
*cpuid_info(void);
364 extern void cpuid_set_info(void);
370 #endif /* ASSEMBLER */
372 #endif /* __APPLE_API_PRIVATE */
373 #endif /* _MACHINE_CPUID_H_ */