2 * i386 CPUID helper functions
4 * Copyright (c) 2003 Fabrice Bellard
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
27 #include "qemu-option.h"
28 #include "qemu-config.h"
30 /* feature flags taken from "Intel Processor Identification and the CPUID
31 * Instruction" and AMD's "CPUID Specification". In cases of disagreement
32 * between feature naming conventions, aliases may be added.
34 static const char *feature_name
[] = {
35 "fpu", "vme", "de", "pse",
36 "tsc", "msr", "pae", "mce",
37 "cx8", "apic", NULL
, "sep",
38 "mtrr", "pge", "mca", "cmov",
39 "pat", "pse36", "pn" /* Intel psn */, "clflush" /* Intel clfsh */,
40 NULL
, "ds" /* Intel dts */, "acpi", "mmx",
41 "fxsr", "sse", "sse2", "ss",
42 "ht" /* Intel htt */, "tm", "ia64", "pbe",
44 static const char *ext_feature_name
[] = {
45 "pni|sse3" /* Intel,AMD sse3 */, "pclmuldq", "dtes64", "monitor",
46 "ds_cpl", "vmx", "smx", "est",
47 "tm2", "ssse3", "cid", NULL
,
48 "fma", "cx16", "xtpr", "pdcm",
49 NULL
, NULL
, "dca", "sse4.1|sse4_1",
50 "sse4.2|sse4_2", "x2apic", "movbe", "popcnt",
51 NULL
, "aes", "xsave", "osxsave",
52 "avx", NULL
, NULL
, "hypervisor",
54 static const char *ext2_feature_name
[] = {
55 "fpu", "vme", "de", "pse",
56 "tsc", "msr", "pae", "mce",
57 "cx8" /* AMD CMPXCHG8B */, "apic", NULL
, "syscall",
58 "mtrr", "pge", "mca", "cmov",
59 "pat", "pse36", NULL
, NULL
/* Linux mp */,
60 "nx" /* Intel xd */, NULL
, "mmxext", "mmx",
61 "fxsr", "fxsr_opt" /* AMD ffxsr */, "pdpe1gb" /* AMD Page1GB */, "rdtscp",
62 NULL
, "lm" /* Intel 64 */, "3dnowext", "3dnow",
64 static const char *ext3_feature_name
[] = {
65 "lahf_lm" /* AMD LahfSahf */, "cmp_legacy", "svm", "extapic" /* AMD ExtApicSpace */,
66 "cr8legacy" /* AMD AltMovCr8 */, "abm", "sse4a", "misalignsse",
67 "3dnowprefetch", "osvw", "ibs", "xop",
68 "skinit", "wdt", NULL
, NULL
,
69 "fma4", NULL
, "cvt16", "nodeid_msr",
70 NULL
, NULL
, NULL
, NULL
,
71 NULL
, NULL
, NULL
, NULL
,
72 NULL
, NULL
, NULL
, NULL
,
75 static const char *kvm_feature_name
[] = {
76 "kvmclock", "kvm_nopiodelay", "kvm_mmu", "kvmclock", "kvm_asyncpf", NULL
, NULL
, NULL
,
77 NULL
, NULL
, NULL
, NULL
, NULL
, NULL
, NULL
, NULL
,
78 NULL
, NULL
, NULL
, NULL
, NULL
, NULL
, NULL
, NULL
,
79 NULL
, NULL
, NULL
, NULL
, NULL
, NULL
, NULL
, NULL
,
82 static const char *svm_feature_name
[] = {
83 "npt", "lbrv", "svm_lock", "nrip_save",
84 "tsc_scale", "vmcb_clean", "flushbyasid", "decodeassists",
85 NULL
, NULL
, "pause_filter", NULL
,
86 "pfthreshold", NULL
, NULL
, NULL
,
87 NULL
, NULL
, NULL
, NULL
,
88 NULL
, NULL
, NULL
, NULL
,
89 NULL
, NULL
, NULL
, NULL
,
90 NULL
, NULL
, NULL
, NULL
,
93 /* collects per-function cpuid data
95 typedef struct model_features_t
{
99 const char **flag_names
;
104 int enforce_cpuid
= 0;
106 void host_cpuid(uint32_t function
, uint32_t count
,
107 uint32_t *eax
, uint32_t *ebx
, uint32_t *ecx
, uint32_t *edx
)
109 #if defined(CONFIG_KVM)
111 *eax
= kvm_arch_get_supported_cpuid(kvm_state
, function
, count
, R_EAX
);
113 *ebx
= kvm_arch_get_supported_cpuid(kvm_state
, function
, count
, R_EBX
);
115 *ecx
= kvm_arch_get_supported_cpuid(kvm_state
, function
, count
, R_ECX
);
117 *edx
= kvm_arch_get_supported_cpuid(kvm_state
, function
, count
, R_EDX
);
121 #define iswhite(c) ((c) && ((c) <= ' ' || '~' < (c)))
123 /* general substring compare of *[s1..e1) and *[s2..e2). sx is start of
124 * a substring. ex if !NULL points to the first char after a substring,
125 * otherwise the string is assumed to sized by a terminating nul.
126 * Return lexical ordering of *s1:*s2.
128 static int sstrcmp(const char *s1
, const char *e1
, const char *s2
,
132 if (!*s1
|| !*s2
|| *s1
!= *s2
)
135 if (s1
== e1
&& s2
== e2
)
144 /* compare *[s..e) to *altstr. *altstr may be a simple string or multiple
145 * '|' delimited (possibly empty) strings in which case search for a match
146 * within the alternatives proceeds left to right. Return 0 for success,
147 * non-zero otherwise.
149 static int altcmp(const char *s
, const char *e
, const char *altstr
)
153 for (q
= p
= altstr
; ; ) {
154 while (*p
&& *p
!= '|')
156 if ((q
== p
&& !*s
) || (q
!= p
&& !sstrcmp(s
, e
, q
, p
)))
165 /* search featureset for flag *[s..e), if found set corresponding bit in
166 * *pval and return true, otherwise return false
168 static bool lookup_feature(uint32_t *pval
, const char *s
, const char *e
,
169 const char **featureset
)
175 for (mask
= 1, ppc
= featureset
; mask
; mask
<<= 1, ++ppc
) {
176 if (*ppc
&& !altcmp(s
, e
, *ppc
)) {
184 static void add_flagname_to_bitmaps(const char *flagname
, uint32_t *features
,
185 uint32_t *ext_features
,
186 uint32_t *ext2_features
,
187 uint32_t *ext3_features
,
188 uint32_t *kvm_features
,
189 uint32_t *svm_features
)
191 if (!lookup_feature(features
, flagname
, NULL
, feature_name
) &&
192 !lookup_feature(ext_features
, flagname
, NULL
, ext_feature_name
) &&
193 !lookup_feature(ext2_features
, flagname
, NULL
, ext2_feature_name
) &&
194 !lookup_feature(ext3_features
, flagname
, NULL
, ext3_feature_name
) &&
195 !lookup_feature(kvm_features
, flagname
, NULL
, kvm_feature_name
) &&
196 !lookup_feature(svm_features
, flagname
, NULL
, svm_feature_name
))
197 fprintf(stderr
, "CPU feature %s not found\n", flagname
);
200 typedef struct x86_def_t
{
201 struct x86_def_t
*next
;
204 uint32_t vendor1
, vendor2
, vendor3
;
209 uint32_t features
, ext_features
, ext2_features
, ext3_features
;
210 uint32_t kvm_features
, svm_features
;
215 /* Store the results of Centaur's CPUID instructions */
216 uint32_t ext4_features
;
220 #define I486_FEATURES (CPUID_FP87 | CPUID_VME | CPUID_PSE)
221 #define PENTIUM_FEATURES (I486_FEATURES | CPUID_DE | CPUID_TSC | \
222 CPUID_MSR | CPUID_MCE | CPUID_CX8 | CPUID_MMX | CPUID_APIC)
223 #define PENTIUM2_FEATURES (PENTIUM_FEATURES | CPUID_PAE | CPUID_SEP | \
224 CPUID_MTRR | CPUID_PGE | CPUID_MCA | CPUID_CMOV | CPUID_PAT | \
225 CPUID_PSE36 | CPUID_FXSR)
226 #define PENTIUM3_FEATURES (PENTIUM2_FEATURES | CPUID_SSE)
227 #define PPRO_FEATURES (CPUID_FP87 | CPUID_DE | CPUID_PSE | CPUID_TSC | \
228 CPUID_MSR | CPUID_MCE | CPUID_CX8 | CPUID_PGE | CPUID_CMOV | \
229 CPUID_PAT | CPUID_FXSR | CPUID_MMX | CPUID_SSE | CPUID_SSE2 | \
230 CPUID_PAE | CPUID_SEP | CPUID_APIC)
231 #define EXT2_FEATURE_MASK 0x0183F3FF
233 #define TCG_FEATURES (CPUID_FP87 | CPUID_PSE | CPUID_TSC | CPUID_MSR | \
234 CPUID_PAE | CPUID_MCE | CPUID_CX8 | CPUID_APIC | CPUID_SEP | \
235 CPUID_MTRR | CPUID_PGE | CPUID_MCA | CPUID_CMOV | CPUID_PAT | \
236 CPUID_PSE36 | CPUID_CLFLUSH | CPUID_ACPI | CPUID_MMX | \
237 CPUID_FXSR | CPUID_SSE | CPUID_SSE2 | CPUID_SS)
238 /* partly implemented:
239 CPUID_MTRR, CPUID_MCA, CPUID_CLFLUSH (needed for Win64)
240 CPUID_PSE36 (needed for Solaris) */
242 CPUID_VME, CPUID_DTS, CPUID_SS, CPUID_HT, CPUID_TM, CPUID_PBE */
243 #define TCG_EXT_FEATURES (CPUID_EXT_SSE3 | CPUID_EXT_MONITOR | \
244 CPUID_EXT_CX16 | CPUID_EXT_POPCNT | \
245 CPUID_EXT_HYPERVISOR)
247 CPUID_EXT_DTES64, CPUID_EXT_DSCPL, CPUID_EXT_VMX, CPUID_EXT_EST,
248 CPUID_EXT_TM2, CPUID_EXT_XTPR, CPUID_EXT_PDCM, CPUID_EXT_XSAVE */
249 #define TCG_EXT2_FEATURES ((TCG_FEATURES & EXT2_FEATURE_MASK) | \
250 CPUID_EXT2_NX | CPUID_EXT2_MMXEXT | CPUID_EXT2_RDTSCP | \
251 CPUID_EXT2_3DNOW | CPUID_EXT2_3DNOWEXT)
253 CPUID_EXT2_PDPE1GB */
254 #define TCG_EXT3_FEATURES (CPUID_EXT3_LAHF_LM | CPUID_EXT3_SVM | \
255 CPUID_EXT3_CR8LEG | CPUID_EXT3_ABM | CPUID_EXT3_SSE4A)
256 #define TCG_SVM_FEATURES 0
258 /* maintains list of cpu model definitions
260 static x86_def_t
*x86_defs
= {NULL
};
262 /* built-in cpu model definitions (deprecated)
264 static x86_def_t builtin_x86_defs
[] = {
268 .vendor1
= CPUID_VENDOR_AMD_1
,
269 .vendor2
= CPUID_VENDOR_AMD_2
,
270 .vendor3
= CPUID_VENDOR_AMD_3
,
274 .features
= PPRO_FEATURES
|
275 CPUID_MTRR
| CPUID_CLFLUSH
| CPUID_MCA
|
277 .ext_features
= CPUID_EXT_SSE3
| CPUID_EXT_CX16
| CPUID_EXT_POPCNT
,
278 .ext2_features
= (PPRO_FEATURES
& EXT2_FEATURE_MASK
) |
279 CPUID_EXT2_LM
| CPUID_EXT2_SYSCALL
| CPUID_EXT2_NX
,
280 .ext3_features
= CPUID_EXT3_LAHF_LM
| CPUID_EXT3_SVM
|
281 CPUID_EXT3_ABM
| CPUID_EXT3_SSE4A
,
282 .xlevel
= 0x8000000A,
283 .model_id
= "QEMU Virtual CPU version " QEMU_VERSION
,
288 .vendor1
= CPUID_VENDOR_AMD_1
,
289 .vendor2
= CPUID_VENDOR_AMD_2
,
290 .vendor3
= CPUID_VENDOR_AMD_3
,
294 .features
= PPRO_FEATURES
|
295 CPUID_MTRR
| CPUID_CLFLUSH
| CPUID_MCA
|
296 CPUID_PSE36
| CPUID_VME
| CPUID_HT
,
297 .ext_features
= CPUID_EXT_SSE3
| CPUID_EXT_MONITOR
| CPUID_EXT_CX16
|
299 .ext2_features
= (PPRO_FEATURES
& EXT2_FEATURE_MASK
) |
300 CPUID_EXT2_LM
| CPUID_EXT2_SYSCALL
| CPUID_EXT2_NX
|
301 CPUID_EXT2_3DNOW
| CPUID_EXT2_3DNOWEXT
| CPUID_EXT2_MMXEXT
|
302 CPUID_EXT2_FFXSR
| CPUID_EXT2_PDPE1GB
| CPUID_EXT2_RDTSCP
,
303 /* Missing: CPUID_EXT3_CMP_LEG, CPUID_EXT3_EXTAPIC,
305 CPUID_EXT3_MISALIGNSSE, CPUID_EXT3_3DNOWPREFETCH,
306 CPUID_EXT3_OSVW, CPUID_EXT3_IBS */
307 .ext3_features
= CPUID_EXT3_LAHF_LM
| CPUID_EXT3_SVM
|
308 CPUID_EXT3_ABM
| CPUID_EXT3_SSE4A
,
309 .svm_features
= CPUID_SVM_NPT
| CPUID_SVM_LBRV
,
310 .xlevel
= 0x8000001A,
311 .model_id
= "AMD Phenom(tm) 9550 Quad-Core Processor"
319 .features
= PPRO_FEATURES
|
320 CPUID_MTRR
| CPUID_CLFLUSH
| CPUID_MCA
|
321 CPUID_PSE36
| CPUID_VME
| CPUID_DTS
| CPUID_ACPI
| CPUID_SS
|
322 CPUID_HT
| CPUID_TM
| CPUID_PBE
,
323 .ext_features
= CPUID_EXT_SSE3
| CPUID_EXT_MONITOR
| CPUID_EXT_SSSE3
|
324 CPUID_EXT_DTES64
| CPUID_EXT_DSCPL
| CPUID_EXT_VMX
| CPUID_EXT_EST
|
325 CPUID_EXT_TM2
| CPUID_EXT_CX16
| CPUID_EXT_XTPR
| CPUID_EXT_PDCM
,
326 .ext2_features
= CPUID_EXT2_LM
| CPUID_EXT2_SYSCALL
| CPUID_EXT2_NX
,
327 .ext3_features
= CPUID_EXT3_LAHF_LM
,
328 .xlevel
= 0x80000008,
329 .model_id
= "Intel(R) Core(TM)2 Duo CPU T7700 @ 2.40GHz",
334 .vendor1
= CPUID_VENDOR_INTEL_1
,
335 .vendor2
= CPUID_VENDOR_INTEL_2
,
336 .vendor3
= CPUID_VENDOR_INTEL_3
,
340 /* Missing: CPUID_VME, CPUID_HT */
341 .features
= PPRO_FEATURES
|
342 CPUID_MTRR
| CPUID_CLFLUSH
| CPUID_MCA
|
344 /* Missing: CPUID_EXT_POPCNT, CPUID_EXT_MONITOR */
345 .ext_features
= CPUID_EXT_SSE3
| CPUID_EXT_CX16
,
346 /* Missing: CPUID_EXT2_PDPE1GB, CPUID_EXT2_RDTSCP */
347 .ext2_features
= (PPRO_FEATURES
& EXT2_FEATURE_MASK
) |
348 CPUID_EXT2_LM
| CPUID_EXT2_SYSCALL
| CPUID_EXT2_NX
,
349 /* Missing: CPUID_EXT3_LAHF_LM, CPUID_EXT3_CMP_LEG, CPUID_EXT3_EXTAPIC,
350 CPUID_EXT3_CR8LEG, CPUID_EXT3_ABM, CPUID_EXT3_SSE4A,
351 CPUID_EXT3_MISALIGNSSE, CPUID_EXT3_3DNOWPREFETCH,
352 CPUID_EXT3_OSVW, CPUID_EXT3_IBS, CPUID_EXT3_SVM */
354 .xlevel
= 0x80000008,
355 .model_id
= "Common KVM processor"
363 .features
= PPRO_FEATURES
,
364 .ext_features
= CPUID_EXT_SSE3
| CPUID_EXT_POPCNT
,
365 .xlevel
= 0x80000004,
366 .model_id
= "QEMU Virtual CPU version " QEMU_VERSION
,
374 .features
= PPRO_FEATURES
|
375 CPUID_MTRR
| CPUID_CLFLUSH
| CPUID_MCA
| CPUID_PSE36
,
376 .ext_features
= CPUID_EXT_SSE3
,
377 .ext2_features
= PPRO_FEATURES
& EXT2_FEATURE_MASK
,
379 .xlevel
= 0x80000008,
380 .model_id
= "Common 32-bit KVM processor"
388 .features
= PPRO_FEATURES
| CPUID_VME
|
389 CPUID_MTRR
| CPUID_CLFLUSH
| CPUID_MCA
| CPUID_DTS
| CPUID_ACPI
|
390 CPUID_SS
| CPUID_HT
| CPUID_TM
| CPUID_PBE
,
391 .ext_features
= CPUID_EXT_SSE3
| CPUID_EXT_MONITOR
| CPUID_EXT_VMX
|
392 CPUID_EXT_EST
| CPUID_EXT_TM2
| CPUID_EXT_XTPR
| CPUID_EXT_PDCM
,
393 .ext2_features
= CPUID_EXT2_NX
,
394 .xlevel
= 0x80000008,
395 .model_id
= "Genuine Intel(R) CPU T2600 @ 2.16GHz",
403 .features
= I486_FEATURES
,
412 .features
= PENTIUM_FEATURES
,
421 .features
= PENTIUM2_FEATURES
,
430 .features
= PENTIUM3_FEATURES
,
436 .vendor1
= CPUID_VENDOR_AMD_1
,
437 .vendor2
= CPUID_VENDOR_AMD_2
,
438 .vendor3
= CPUID_VENDOR_AMD_3
,
442 .features
= PPRO_FEATURES
| CPUID_PSE36
| CPUID_VME
| CPUID_MTRR
| CPUID_MCA
,
443 .ext2_features
= (PPRO_FEATURES
& EXT2_FEATURE_MASK
) | CPUID_EXT2_MMXEXT
| CPUID_EXT2_3DNOW
| CPUID_EXT2_3DNOWEXT
,
444 .xlevel
= 0x80000008,
445 /* XXX: put another string ? */
446 .model_id
= "QEMU Virtual CPU version " QEMU_VERSION
,
450 /* original is on level 10 */
455 .features
= PPRO_FEATURES
|
456 CPUID_MTRR
| CPUID_CLFLUSH
| CPUID_MCA
| CPUID_VME
| CPUID_DTS
|
457 CPUID_ACPI
| CPUID_SS
| CPUID_HT
| CPUID_TM
| CPUID_PBE
,
458 /* Some CPUs got no CPUID_SEP */
459 .ext_features
= CPUID_EXT_SSE3
| CPUID_EXT_MONITOR
| CPUID_EXT_SSSE3
|
460 CPUID_EXT_DSCPL
| CPUID_EXT_EST
| CPUID_EXT_TM2
| CPUID_EXT_XTPR
,
461 .ext2_features
= (PPRO_FEATURES
& EXT2_FEATURE_MASK
) | CPUID_EXT2_NX
,
462 .ext3_features
= CPUID_EXT3_LAHF_LM
,
463 .xlevel
= 0x8000000A,
464 .model_id
= "Intel(R) Atom(TM) CPU N270 @ 1.60GHz",
468 static int cpu_x86_fill_model_id(char *str
)
470 uint32_t eax
= 0, ebx
= 0, ecx
= 0, edx
= 0;
473 for (i
= 0; i
< 3; i
++) {
474 host_cpuid(0x80000002 + i
, 0, &eax
, &ebx
, &ecx
, &edx
);
475 memcpy(str
+ i
* 16 + 0, &eax
, 4);
476 memcpy(str
+ i
* 16 + 4, &ebx
, 4);
477 memcpy(str
+ i
* 16 + 8, &ecx
, 4);
478 memcpy(str
+ i
* 16 + 12, &edx
, 4);
483 static int cpu_x86_fill_host(x86_def_t
*x86_cpu_def
)
485 uint32_t eax
= 0, ebx
= 0, ecx
= 0, edx
= 0;
487 x86_cpu_def
->name
= "host";
488 host_cpuid(0x0, 0, &eax
, &ebx
, &ecx
, &edx
);
489 x86_cpu_def
->level
= eax
;
490 x86_cpu_def
->vendor1
= ebx
;
491 x86_cpu_def
->vendor2
= edx
;
492 x86_cpu_def
->vendor3
= ecx
;
494 host_cpuid(0x1, 0, &eax
, &ebx
, &ecx
, &edx
);
495 x86_cpu_def
->family
= ((eax
>> 8) & 0x0F) + ((eax
>> 20) & 0xFF);
496 x86_cpu_def
->model
= ((eax
>> 4) & 0x0F) | ((eax
& 0xF0000) >> 12);
497 x86_cpu_def
->stepping
= eax
& 0x0F;
498 x86_cpu_def
->ext_features
= ecx
;
499 x86_cpu_def
->features
= edx
;
501 host_cpuid(0x80000000, 0, &eax
, &ebx
, &ecx
, &edx
);
502 x86_cpu_def
->xlevel
= eax
;
504 host_cpuid(0x80000001, 0, &eax
, &ebx
, &ecx
, &edx
);
505 x86_cpu_def
->ext2_features
= edx
;
506 x86_cpu_def
->ext3_features
= ecx
;
507 cpu_x86_fill_model_id(x86_cpu_def
->model_id
);
508 x86_cpu_def
->vendor_override
= 0;
510 /* Call Centaur's CPUID instruction. */
511 if (x86_cpu_def
->vendor1
== CPUID_VENDOR_VIA_1
&&
512 x86_cpu_def
->vendor2
== CPUID_VENDOR_VIA_2
&&
513 x86_cpu_def
->vendor3
== CPUID_VENDOR_VIA_3
) {
514 host_cpuid(0xC0000000, 0, &eax
, &ebx
, &ecx
, &edx
);
515 if (eax
>= 0xC0000001) {
516 /* Support VIA max extended level */
517 x86_cpu_def
->xlevel2
= eax
;
518 host_cpuid(0xC0000001, 0, &eax
, &ebx
, &ecx
, &edx
);
519 x86_cpu_def
->ext4_features
= edx
;
524 * Every SVM feature requires emulation support in KVM - so we can't just
525 * read the host features here. KVM might even support SVM features not
526 * available on the host hardware. Just set all bits and mask out the
527 * unsupported ones later.
529 x86_cpu_def
->svm_features
= -1;
534 static int unavailable_host_feature(struct model_features_t
*f
, uint32_t mask
)
538 for (i
= 0; i
< 32; ++i
)
540 fprintf(stderr
, "warning: host cpuid %04x_%04x lacks requested"
541 " flag '%s' [0x%08x]\n",
542 f
->cpuid
>> 16, f
->cpuid
& 0xffff,
543 f
->flag_names
[i
] ? f
->flag_names
[i
] : "[reserved]", mask
);
549 /* best effort attempt to inform user requested cpu flags aren't making
550 * their way to the guest. Note: ft[].check_feat ideally should be
551 * specified via a guest_def field to suppress report of extraneous flags.
553 static int check_features_against_host(x86_def_t
*guest_def
)
558 struct model_features_t ft
[] = {
559 {&guest_def
->features
, &host_def
.features
,
560 ~0, feature_name
, 0x00000000},
561 {&guest_def
->ext_features
, &host_def
.ext_features
,
562 ~CPUID_EXT_HYPERVISOR
, ext_feature_name
, 0x00000001},
563 {&guest_def
->ext2_features
, &host_def
.ext2_features
,
564 ~PPRO_FEATURES
, ext2_feature_name
, 0x80000000},
565 {&guest_def
->ext3_features
, &host_def
.ext3_features
,
566 ~CPUID_EXT3_SVM
, ext3_feature_name
, 0x80000001}};
568 cpu_x86_fill_host(&host_def
);
569 for (rv
= 0, i
= 0; i
< ARRAY_SIZE(ft
); ++i
)
570 for (mask
= 1; mask
; mask
<<= 1)
571 if (ft
[i
].check_feat
& mask
&& *ft
[i
].guest_feat
& mask
&&
572 !(*ft
[i
].host_feat
& mask
)) {
573 unavailable_host_feature(&ft
[i
], mask
);
579 static int cpu_x86_find_by_name(x86_def_t
*x86_cpu_def
, const char *cpu_model
)
584 char *s
= g_strdup(cpu_model
);
585 char *featurestr
, *name
= strtok(s
, ",");
586 /* Features to be added*/
587 uint32_t plus_features
= 0, plus_ext_features
= 0;
588 uint32_t plus_ext2_features
= 0, plus_ext3_features
= 0;
589 uint32_t plus_kvm_features
= 0, plus_svm_features
= 0;
590 /* Features to be removed */
591 uint32_t minus_features
= 0, minus_ext_features
= 0;
592 uint32_t minus_ext2_features
= 0, minus_ext3_features
= 0;
593 uint32_t minus_kvm_features
= 0, minus_svm_features
= 0;
596 for (def
= x86_defs
; def
; def
= def
->next
)
597 if (name
&& !strcmp(name
, def
->name
))
599 if (kvm_enabled() && name
&& strcmp(name
, "host") == 0) {
600 cpu_x86_fill_host(x86_cpu_def
);
604 memcpy(x86_cpu_def
, def
, sizeof(*def
));
607 plus_kvm_features
= ~0; /* not supported bits will be filtered out later */
609 add_flagname_to_bitmaps("hypervisor", &plus_features
,
610 &plus_ext_features
, &plus_ext2_features
, &plus_ext3_features
,
611 &plus_kvm_features
, &plus_svm_features
);
613 featurestr
= strtok(NULL
, ",");
617 if (featurestr
[0] == '+') {
618 add_flagname_to_bitmaps(featurestr
+ 1, &plus_features
,
619 &plus_ext_features
, &plus_ext2_features
,
620 &plus_ext3_features
, &plus_kvm_features
,
622 } else if (featurestr
[0] == '-') {
623 add_flagname_to_bitmaps(featurestr
+ 1, &minus_features
,
624 &minus_ext_features
, &minus_ext2_features
,
625 &minus_ext3_features
, &minus_kvm_features
,
626 &minus_svm_features
);
627 } else if ((val
= strchr(featurestr
, '='))) {
629 if (!strcmp(featurestr
, "family")) {
631 numvalue
= strtoul(val
, &err
, 0);
633 fprintf(stderr
, "bad numerical value %s\n", val
);
636 x86_cpu_def
->family
= numvalue
;
637 } else if (!strcmp(featurestr
, "model")) {
639 numvalue
= strtoul(val
, &err
, 0);
640 if (!*val
|| *err
|| numvalue
> 0xff) {
641 fprintf(stderr
, "bad numerical value %s\n", val
);
644 x86_cpu_def
->model
= numvalue
;
645 } else if (!strcmp(featurestr
, "stepping")) {
647 numvalue
= strtoul(val
, &err
, 0);
648 if (!*val
|| *err
|| numvalue
> 0xf) {
649 fprintf(stderr
, "bad numerical value %s\n", val
);
652 x86_cpu_def
->stepping
= numvalue
;
653 } else if (!strcmp(featurestr
, "level")) {
655 numvalue
= strtoul(val
, &err
, 0);
657 fprintf(stderr
, "bad numerical value %s\n", val
);
660 x86_cpu_def
->level
= numvalue
;
661 } else if (!strcmp(featurestr
, "xlevel")) {
663 numvalue
= strtoul(val
, &err
, 0);
665 fprintf(stderr
, "bad numerical value %s\n", val
);
668 if (numvalue
< 0x80000000) {
669 numvalue
+= 0x80000000;
671 x86_cpu_def
->xlevel
= numvalue
;
672 } else if (!strcmp(featurestr
, "vendor")) {
673 if (strlen(val
) != 12) {
674 fprintf(stderr
, "vendor string must be 12 chars long\n");
677 x86_cpu_def
->vendor1
= 0;
678 x86_cpu_def
->vendor2
= 0;
679 x86_cpu_def
->vendor3
= 0;
680 for(i
= 0; i
< 4; i
++) {
681 x86_cpu_def
->vendor1
|= ((uint8_t)val
[i
]) << (8 * i
);
682 x86_cpu_def
->vendor2
|= ((uint8_t)val
[i
+ 4]) << (8 * i
);
683 x86_cpu_def
->vendor3
|= ((uint8_t)val
[i
+ 8]) << (8 * i
);
685 x86_cpu_def
->vendor_override
= 1;
686 } else if (!strcmp(featurestr
, "model_id")) {
687 pstrcpy(x86_cpu_def
->model_id
, sizeof(x86_cpu_def
->model_id
),
689 } else if (!strcmp(featurestr
, "tsc_freq")) {
693 tsc_freq
= strtosz_suffix_unit(val
, &err
,
694 STRTOSZ_DEFSUFFIX_B
, 1000);
696 fprintf(stderr
, "bad numerical value %s\n", val
);
699 x86_cpu_def
->tsc_khz
= tsc_freq
/ 1000;
701 fprintf(stderr
, "unrecognized feature %s\n", featurestr
);
704 } else if (!strcmp(featurestr
, "check")) {
706 } else if (!strcmp(featurestr
, "enforce")) {
707 check_cpuid
= enforce_cpuid
= 1;
709 fprintf(stderr
, "feature string `%s' not in format (+feature|-feature|feature=xyz)\n", featurestr
);
712 featurestr
= strtok(NULL
, ",");
714 x86_cpu_def
->features
|= plus_features
;
715 x86_cpu_def
->ext_features
|= plus_ext_features
;
716 x86_cpu_def
->ext2_features
|= plus_ext2_features
;
717 x86_cpu_def
->ext3_features
|= plus_ext3_features
;
718 x86_cpu_def
->kvm_features
|= plus_kvm_features
;
719 x86_cpu_def
->svm_features
|= plus_svm_features
;
720 x86_cpu_def
->features
&= ~minus_features
;
721 x86_cpu_def
->ext_features
&= ~minus_ext_features
;
722 x86_cpu_def
->ext2_features
&= ~minus_ext2_features
;
723 x86_cpu_def
->ext3_features
&= ~minus_ext3_features
;
724 x86_cpu_def
->kvm_features
&= ~minus_kvm_features
;
725 x86_cpu_def
->svm_features
&= ~minus_svm_features
;
727 if (check_features_against_host(x86_cpu_def
) && enforce_cpuid
)
738 /* generate a composite string into buf of all cpuid names in featureset
739 * selected by fbits. indicate truncation at bufsize in the event of overflow.
740 * if flags, suppress names undefined in featureset.
742 static void listflags(char *buf
, int bufsize
, uint32_t fbits
,
743 const char **featureset
, uint32_t flags
)
745 const char **p
= &featureset
[31];
749 b
= 4 <= bufsize
? buf
+ (bufsize
-= 3) - 1 : NULL
;
751 for (q
= buf
, bit
= 31; fbits
&& bufsize
; --p
, fbits
&= ~(1 << bit
), --bit
)
752 if (fbits
& 1 << bit
&& (*p
|| !flags
)) {
754 nc
= snprintf(q
, bufsize
, "%s%s", q
== buf
? "" : " ", *p
);
756 nc
= snprintf(q
, bufsize
, "%s[%d]", q
== buf
? "" : " ", bit
);
759 memcpy(b
, "...", sizeof("..."));
768 /* generate CPU information:
769 * -? list model names
770 * -?model list model names/IDs
771 * -?dump output all model (x86_def_t) data
772 * -?cpuid list all recognized cpuid flag names
774 void x86_cpu_list(FILE *f
, fprintf_function cpu_fprintf
, const char *optarg
)
776 unsigned char model
= !strcmp("?model", optarg
);
777 unsigned char dump
= !strcmp("?dump", optarg
);
778 unsigned char cpuid
= !strcmp("?cpuid", optarg
);
783 (*cpu_fprintf
)(f
, "Recognized CPUID flags:\n");
784 listflags(buf
, sizeof (buf
), (uint32_t)~0, feature_name
, 1);
785 (*cpu_fprintf
)(f
, " f_edx: %s\n", buf
);
786 listflags(buf
, sizeof (buf
), (uint32_t)~0, ext_feature_name
, 1);
787 (*cpu_fprintf
)(f
, " f_ecx: %s\n", buf
);
788 listflags(buf
, sizeof (buf
), (uint32_t)~0, ext2_feature_name
, 1);
789 (*cpu_fprintf
)(f
, " extf_edx: %s\n", buf
);
790 listflags(buf
, sizeof (buf
), (uint32_t)~0, ext3_feature_name
, 1);
791 (*cpu_fprintf
)(f
, " extf_ecx: %s\n", buf
);
794 for (def
= x86_defs
; def
; def
= def
->next
) {
795 snprintf(buf
, sizeof (buf
), def
->flags
? "[%s]": "%s", def
->name
);
797 (*cpu_fprintf
)(f
, "x86 %16s %-48s\n", buf
, def
->model_id
);
799 (*cpu_fprintf
)(f
, "x86 %16s\n", buf
);
802 memcpy(buf
, &def
->vendor1
, sizeof (def
->vendor1
));
803 memcpy(buf
+ 4, &def
->vendor2
, sizeof (def
->vendor2
));
804 memcpy(buf
+ 8, &def
->vendor3
, sizeof (def
->vendor3
));
807 " family %d model %d stepping %d level %d xlevel 0x%x"
809 def
->family
, def
->model
, def
->stepping
, def
->level
,
811 listflags(buf
, sizeof (buf
), def
->features
, feature_name
, 0);
812 (*cpu_fprintf
)(f
, " feature_edx %08x (%s)\n", def
->features
,
814 listflags(buf
, sizeof (buf
), def
->ext_features
, ext_feature_name
,
816 (*cpu_fprintf
)(f
, " feature_ecx %08x (%s)\n", def
->ext_features
,
818 listflags(buf
, sizeof (buf
), def
->ext2_features
, ext2_feature_name
,
820 (*cpu_fprintf
)(f
, " extfeature_edx %08x (%s)\n",
821 def
->ext2_features
, buf
);
822 listflags(buf
, sizeof (buf
), def
->ext3_features
, ext3_feature_name
,
824 (*cpu_fprintf
)(f
, " extfeature_ecx %08x (%s)\n",
825 def
->ext3_features
, buf
);
826 (*cpu_fprintf
)(f
, "\n");
830 (*cpu_fprintf
)(f
, "x86 %16s\n", "[host]");
834 int cpu_x86_register (CPUX86State
*env
, const char *cpu_model
)
836 x86_def_t def1
, *def
= &def1
;
838 memset(def
, 0, sizeof(*def
));
840 if (cpu_x86_find_by_name(def
, cpu_model
) < 0)
843 env
->cpuid_vendor1
= def
->vendor1
;
844 env
->cpuid_vendor2
= def
->vendor2
;
845 env
->cpuid_vendor3
= def
->vendor3
;
847 env
->cpuid_vendor1
= CPUID_VENDOR_INTEL_1
;
848 env
->cpuid_vendor2
= CPUID_VENDOR_INTEL_2
;
849 env
->cpuid_vendor3
= CPUID_VENDOR_INTEL_3
;
851 env
->cpuid_vendor_override
= def
->vendor_override
;
852 env
->cpuid_level
= def
->level
;
853 if (def
->family
> 0x0f)
854 env
->cpuid_version
= 0xf00 | ((def
->family
- 0x0f) << 20);
856 env
->cpuid_version
= def
->family
<< 8;
857 env
->cpuid_version
|= ((def
->model
& 0xf) << 4) | ((def
->model
>> 4) << 16);
858 env
->cpuid_version
|= def
->stepping
;
859 env
->cpuid_features
= def
->features
;
860 env
->cpuid_ext_features
= def
->ext_features
;
861 env
->cpuid_ext2_features
= def
->ext2_features
;
862 env
->cpuid_ext3_features
= def
->ext3_features
;
863 env
->cpuid_xlevel
= def
->xlevel
;
864 env
->cpuid_kvm_features
= def
->kvm_features
;
865 env
->cpuid_svm_features
= def
->svm_features
;
866 env
->cpuid_ext4_features
= def
->ext4_features
;
867 env
->cpuid_xlevel2
= def
->xlevel2
;
868 env
->tsc_khz
= def
->tsc_khz
;
869 if (!kvm_enabled()) {
870 env
->cpuid_features
&= TCG_FEATURES
;
871 env
->cpuid_ext_features
&= TCG_EXT_FEATURES
;
872 env
->cpuid_ext2_features
&= (TCG_EXT2_FEATURES
874 | CPUID_EXT2_SYSCALL
| CPUID_EXT2_LM
877 env
->cpuid_ext3_features
&= TCG_EXT3_FEATURES
;
878 env
->cpuid_svm_features
&= TCG_SVM_FEATURES
;
881 const char *model_id
= def
->model_id
;
885 len
= strlen(model_id
);
886 for(i
= 0; i
< 48; i
++) {
890 c
= (uint8_t)model_id
[i
];
891 env
->cpuid_model
[i
>> 2] |= c
<< (8 * (i
& 3));
897 #if !defined(CONFIG_USER_ONLY)
898 /* copy vendor id string to 32 bit register, nul pad as needed
900 static void cpyid(const char *s
, uint32_t *id
)
902 char *d
= (char *)id
;
905 for (i
= sizeof (*id
); i
--; )
906 *d
++ = *s
? *s
++ : '\0';
909 /* interpret radix and convert from string to arbitrary scalar,
910 * otherwise flag failure
912 #define setscalar(pval, str, perr) \
917 ul = strtoul(str, &pend, 0); \
918 *str && !*pend ? (*pval = ul) : (*perr = 1); \
921 /* map cpuid options to feature bits, otherwise return failure
922 * (option tags in *str are delimited by whitespace)
924 static void setfeatures(uint32_t *pval
, const char *str
,
925 const char **featureset
, int *perr
)
929 for (q
= p
= str
; *p
|| *q
; q
= p
) {
932 while (*p
&& !iswhite(*p
))
936 if (!lookup_feature(pval
, q
, p
, featureset
)) {
937 fprintf(stderr
, "error: feature \"%.*s\" not available in set\n",
945 /* map config file options to x86_def_t form
947 static int cpudef_setfield(const char *name
, const char *str
, void *opaque
)
949 x86_def_t
*def
= opaque
;
952 if (!strcmp(name
, "name")) {
953 g_free((void *)def
->name
);
954 def
->name
= g_strdup(str
);
955 } else if (!strcmp(name
, "model_id")) {
956 strncpy(def
->model_id
, str
, sizeof (def
->model_id
));
957 } else if (!strcmp(name
, "level")) {
958 setscalar(&def
->level
, str
, &err
)
959 } else if (!strcmp(name
, "vendor")) {
960 cpyid(&str
[0], &def
->vendor1
);
961 cpyid(&str
[4], &def
->vendor2
);
962 cpyid(&str
[8], &def
->vendor3
);
963 } else if (!strcmp(name
, "family")) {
964 setscalar(&def
->family
, str
, &err
)
965 } else if (!strcmp(name
, "model")) {
966 setscalar(&def
->model
, str
, &err
)
967 } else if (!strcmp(name
, "stepping")) {
968 setscalar(&def
->stepping
, str
, &err
)
969 } else if (!strcmp(name
, "feature_edx")) {
970 setfeatures(&def
->features
, str
, feature_name
, &err
);
971 } else if (!strcmp(name
, "feature_ecx")) {
972 setfeatures(&def
->ext_features
, str
, ext_feature_name
, &err
);
973 } else if (!strcmp(name
, "extfeature_edx")) {
974 setfeatures(&def
->ext2_features
, str
, ext2_feature_name
, &err
);
975 } else if (!strcmp(name
, "extfeature_ecx")) {
976 setfeatures(&def
->ext3_features
, str
, ext3_feature_name
, &err
);
977 } else if (!strcmp(name
, "xlevel")) {
978 setscalar(&def
->xlevel
, str
, &err
)
980 fprintf(stderr
, "error: unknown option [%s = %s]\n", name
, str
);
984 fprintf(stderr
, "error: bad option value [%s = %s]\n", name
, str
);
990 /* register config file entry as x86_def_t
992 static int cpudef_register(QemuOpts
*opts
, void *opaque
)
994 x86_def_t
*def
= g_malloc0(sizeof (x86_def_t
));
996 qemu_opt_foreach(opts
, cpudef_setfield
, def
, 1);
997 def
->next
= x86_defs
;
1002 void cpu_clear_apic_feature(CPUX86State
*env
)
1004 env
->cpuid_features
&= ~CPUID_APIC
;
1007 #endif /* !CONFIG_USER_ONLY */
1009 /* register "cpudef" models defined in configuration file. Here we first
1010 * preload any built-in definitions
1012 void x86_cpudef_setup(void)
1016 for (i
= 0; i
< ARRAY_SIZE(builtin_x86_defs
); ++i
) {
1017 builtin_x86_defs
[i
].next
= x86_defs
;
1018 builtin_x86_defs
[i
].flags
= 1;
1019 x86_defs
= &builtin_x86_defs
[i
];
1021 #if !defined(CONFIG_USER_ONLY)
1022 qemu_opts_foreach(qemu_find_opts("cpudef"), cpudef_register
, NULL
, 0);
1026 static void get_cpuid_vendor(CPUX86State
*env
, uint32_t *ebx
,
1027 uint32_t *ecx
, uint32_t *edx
)
1029 *ebx
= env
->cpuid_vendor1
;
1030 *edx
= env
->cpuid_vendor2
;
1031 *ecx
= env
->cpuid_vendor3
;
1033 /* sysenter isn't supported on compatibility mode on AMD, syscall
1034 * isn't supported in compatibility mode on Intel.
1035 * Normally we advertise the actual cpu vendor, but you can override
1036 * this if you want to use KVM's sysenter/syscall emulation
1037 * in compatibility mode and when doing cross vendor migration
1039 if (kvm_enabled() && ! env
->cpuid_vendor_override
) {
1040 host_cpuid(0, 0, NULL
, ebx
, ecx
, edx
);
1044 void cpu_x86_cpuid(CPUX86State
*env
, uint32_t index
, uint32_t count
,
1045 uint32_t *eax
, uint32_t *ebx
,
1046 uint32_t *ecx
, uint32_t *edx
)
1048 /* test if maximum index reached */
1049 if (index
& 0x80000000) {
1050 if (index
> env
->cpuid_xlevel
) {
1051 if (env
->cpuid_xlevel2
> 0) {
1052 /* Handle the Centaur's CPUID instruction. */
1053 if (index
> env
->cpuid_xlevel2
) {
1054 index
= env
->cpuid_xlevel2
;
1055 } else if (index
< 0xC0000000) {
1056 index
= env
->cpuid_xlevel
;
1059 index
= env
->cpuid_xlevel
;
1063 if (index
> env
->cpuid_level
)
1064 index
= env
->cpuid_level
;
1069 *eax
= env
->cpuid_level
;
1070 get_cpuid_vendor(env
, ebx
, ecx
, edx
);
1073 *eax
= env
->cpuid_version
;
1074 *ebx
= (env
->cpuid_apic_id
<< 24) | 8 << 8; /* CLFLUSH size in quad words, Linux wants it. */
1075 *ecx
= env
->cpuid_ext_features
;
1076 *edx
= env
->cpuid_features
;
1077 if (env
->nr_cores
* env
->nr_threads
> 1) {
1078 *ebx
|= (env
->nr_cores
* env
->nr_threads
) << 16;
1079 *edx
|= 1 << 28; /* HTT bit */
1083 /* cache info: needed for Pentium Pro compatibility */
1090 /* cache info: needed for Core compatibility */
1091 if (env
->nr_cores
> 1) {
1092 *eax
= (env
->nr_cores
- 1) << 26;
1097 case 0: /* L1 dcache info */
1103 case 1: /* L1 icache info */
1109 case 2: /* L2 cache info */
1111 if (env
->nr_threads
> 1) {
1112 *eax
|= (env
->nr_threads
- 1) << 14;
1118 default: /* end of info */
1127 /* mwait info: needed for Core compatibility */
1128 *eax
= 0; /* Smallest monitor-line size in bytes */
1129 *ebx
= 0; /* Largest monitor-line size in bytes */
1130 *ecx
= CPUID_MWAIT_EMX
| CPUID_MWAIT_IBE
;
1134 /* Thermal and Power Leaf */
1141 if (kvm_enabled()) {
1142 KVMState
*s
= env
->kvm_state
;
1144 *eax
= kvm_arch_get_supported_cpuid(s
, 0x7, count
, R_EAX
);
1145 *ebx
= kvm_arch_get_supported_cpuid(s
, 0x7, count
, R_EBX
);
1146 *ecx
= kvm_arch_get_supported_cpuid(s
, 0x7, count
, R_ECX
);
1147 *edx
= kvm_arch_get_supported_cpuid(s
, 0x7, count
, R_EDX
);
1156 /* Direct Cache Access Information Leaf */
1157 *eax
= 0; /* Bits 0-31 in DCA_CAP MSR */
1163 /* Architectural Performance Monitoring Leaf */
1170 /* Processor Extended State */
1171 if (!(env
->cpuid_ext_features
& CPUID_EXT_XSAVE
)) {
1178 if (kvm_enabled()) {
1179 KVMState
*s
= env
->kvm_state
;
1181 *eax
= kvm_arch_get_supported_cpuid(s
, 0xd, count
, R_EAX
);
1182 *ebx
= kvm_arch_get_supported_cpuid(s
, 0xd, count
, R_EBX
);
1183 *ecx
= kvm_arch_get_supported_cpuid(s
, 0xd, count
, R_ECX
);
1184 *edx
= kvm_arch_get_supported_cpuid(s
, 0xd, count
, R_EDX
);
1193 *eax
= env
->cpuid_xlevel
;
1194 *ebx
= env
->cpuid_vendor1
;
1195 *edx
= env
->cpuid_vendor2
;
1196 *ecx
= env
->cpuid_vendor3
;
1199 *eax
= env
->cpuid_version
;
1201 *ecx
= env
->cpuid_ext3_features
;
1202 *edx
= env
->cpuid_ext2_features
;
1204 /* The Linux kernel checks for the CMPLegacy bit and
1205 * discards multiple thread information if it is set.
1206 * So dont set it here for Intel to make Linux guests happy.
1208 if (env
->nr_cores
* env
->nr_threads
> 1) {
1209 uint32_t tebx
, tecx
, tedx
;
1210 get_cpuid_vendor(env
, &tebx
, &tecx
, &tedx
);
1211 if (tebx
!= CPUID_VENDOR_INTEL_1
||
1212 tedx
!= CPUID_VENDOR_INTEL_2
||
1213 tecx
!= CPUID_VENDOR_INTEL_3
) {
1214 *ecx
|= 1 << 1; /* CmpLegacy bit */
1221 *eax
= env
->cpuid_model
[(index
- 0x80000002) * 4 + 0];
1222 *ebx
= env
->cpuid_model
[(index
- 0x80000002) * 4 + 1];
1223 *ecx
= env
->cpuid_model
[(index
- 0x80000002) * 4 + 2];
1224 *edx
= env
->cpuid_model
[(index
- 0x80000002) * 4 + 3];
1227 /* cache info (L1 cache) */
1234 /* cache info (L2 cache) */
1241 /* virtual & phys address size in low 2 bytes. */
1242 /* XXX: This value must match the one used in the MMU code. */
1243 if (env
->cpuid_ext2_features
& CPUID_EXT2_LM
) {
1244 /* 64 bit processor */
1245 /* XXX: The physical address space is limited to 42 bits in exec.c. */
1246 *eax
= 0x00003028; /* 48 bits virtual, 40 bits physical */
1248 if (env
->cpuid_features
& CPUID_PSE36
)
1249 *eax
= 0x00000024; /* 36 bits physical */
1251 *eax
= 0x00000020; /* 32 bits physical */
1256 if (env
->nr_cores
* env
->nr_threads
> 1) {
1257 *ecx
|= (env
->nr_cores
* env
->nr_threads
) - 1;
1261 if (env
->cpuid_ext3_features
& CPUID_EXT3_SVM
) {
1262 *eax
= 0x00000001; /* SVM Revision */
1263 *ebx
= 0x00000010; /* nr of ASIDs */
1265 *edx
= env
->cpuid_svm_features
; /* optional features */
1274 *eax
= env
->cpuid_xlevel2
;
1280 /* Support for VIA CPU's CPUID instruction */
1281 *eax
= env
->cpuid_version
;
1284 *edx
= env
->cpuid_ext4_features
;
1289 /* Reserved for the future, and now filled with zero */
1296 /* reserved values: zero */