arch/x86/cpuinfo.rst

4 x86 Feature Flags
10 The list of feature flags in /proc/cpuinfo is not complete and
11 represents an ill-fated attempt from long time ago to put feature flags
14 However, the amount of feature flags is growing by the CPU generation,
17 What is more, those feature flags do not even need to be in that file
21 And even if it doesn't show a particular feature flag - although the CPU
24 feature and figure out if it is supported or not, regardless of whether
32 kernel has *enabled* and *supports*. As in: the CPUID feature flag is
38 So, if users want to know if a feature is available on a given system,
42 * the kernel knows about the feature enough to have an X86_FEATURE bit
47 * if the flag represents a hardware feature the hardware supports it.
52 On the one hand, a feature like "vaes" might be fully available to user
70 If the kernel cares about a feature or KVM want to expose the feature to
76 feature flags.
79 How are feature flags created?
82 a: Feature flags can be derived from the contents of CPUID leaves.
84 These feature definitions are organized mirroring the layout of CPUID
87 If a feature is defined with a X86_FEATURE_<name> definition in
96 if a given feature is present. This is done in init_scattered_cpuid_features().
103 has only one feature and would waste 31 bits of space in the x86_capability[]
113 the feature X86_FEATURE_SPLIT_LOCK_DETECT will be enabled and
120 software feature implemented in the kernel. For example, Kernel Page Table
121 Isolation is purely software feature and its feature flag X86_FEATURE_PTI is
153 The feature shall be omitted from /proc/cpuinfo if it does not make sense for
154 the feature to be exposed to userspace. For example, X86_FEATURE_ALWAYS is
155 defined in cpufeatures.h but that flag is an internal kernel feature used
164 For example, when a new kernel is running on old hardware or the feature is
166 problem enabling the feature at run time, the flag will not be displayed.
176 Even though the feature will still be detected via CPUID, the kernel disables
179 d: The feature is disabled at boot-time.
181 A feature can be disabled either using a command-line parameter or because
183 to disable features using the feature number as defined in
193 e: The feature was known to be non-functional.
195 The feature was known to be non-functional because a dependency was
196 missing at runtime. For example, AVX flags will not show up if XSAVE feature
197 is disabled since they depend on XSAVE feature. Another example would be broken
199 enable a feature.