include/asm/cpufeature.h

94  * Each capability has the following list of attributes :
96  * 1) Scope of Detection : The system detects a given capability by
99  *    model. The capability provides a call back ( @matches() ) to
106  *        capability is finalised. (See section 2 below)
110  *        system decides to finalise the state of the capability. If the
111  *        capability relies on a field in one of the CPU ID feature
120  *    The process of detection is usually denoted by "update" capability
124  *    capability at some point during its execution and take necessary
131  *    changes to the state of a capability once it finalises the capability
133  *    safely. A CPU brought up after a capability is "finalised" is
134  *    referred to as "Late CPU" w.r.t the capability. e.g, all secondary
155  *	a) SCOPE_BOOT_CPU : All CPUs are verified against the capability
159  *	user after the kernel boot are verified against the capability.
164  *    capability, if it has not been finalised already. See section 5
168  *    detected capability, on all CPUs on the system. Appropriate actions
172  *    point. The actions are always initiated only after the capability
173  *    is finalised. This is usally denoted by "enabling" the capability.
175  *	a) Action is triggered on all online CPUs, after the capability is
183  * 5) Conflicts: Based on the state of the capability on a late CPU vs.
199  *     Case (a) is not permitted for a capability that the system requires
200  *     all CPUs to have in order for the capability to be enabled. This is
203  *     Case (b) is not permitted for a capability that must be enabled
206  *     enabled after the corresponding capability is finalised.
210  *     or both flags in the capability's type field.
213  *     ARM64_CPUCAP_PANIC_ON_CONFLICT flag is specified for the capability,
219  * Decide how the capability is detected.
226  * during early boot. i.e, the capability should be "detected" and
241  * Is it permitted for a late CPU to have this capability when system
245 /* Is it safe for a late CPU to miss this capability when system has it */
272  * capability to be advertised by cpus_have_*cap()!
281  * is not allowed to have the capability when the system doesn't have it.
290  * CPUs must match the state of the capability as detected by the boot CPU. In
307 	u16 capability;  member
311 	 * Take the appropriate actions to configure this capability
312 	 * for this CPU. If the capability is detected by the kernel
315 	 * capability is available on that specific CPU. This is
319 	 * is required only if the CPU has the capability, then the
345 	 * "capability" of the same "type" as described by the parent.
364  * of call backs, sharing the same capability bit.
423  * Test for a capability with a runtime check.
425  * Before the capability is detected, this returns false.
435  * Test for a capability without a runtime check.
450  * Test for a capability without a runtime check.
466  * Test for a capability, possibly with a runtime check for non-hyp code.
489 		pr_warn("Attempt to set an illegal CPU capability (%d >= %d)\n",  in cpus_set_cap()