[PATCH v5 0/4] Documentation/x86: Improve the AMX documentation

From: Chang S. Bae
Date: Thu Sep 22 2022 - 16:08:54 EST


Hi all,

The change from the last version [1]:
* Update the purpose part (patch1) by rewriting the altstack story and
having it as the only reason.

Thanks Dave Hansen for the feedback.

=== Cover Letter ===

When the AMX feature was supported in Linux, the dynamic feature enabling
model was introduced. The following documentation changes were considered
to help users to adopt this new enabling model:

(1) The AMX-enabling code example is expected to clarify the steps.
(2) Along with that, a couple of ABI constants may be useful for users.
(3) Also, describing the motiviation will provide the context of this.
(4) Lastly, the description of new guest options are added as missing.

If they are acceptable, the arch_prctl(2) manual page [2] will be followed
up separately with something similar to the kernel documentation.

These patches can be also found in this repository:
git://github.com/intel/amx-linux.git amx-doc

And the compiled preview is available here:
https://htmlpreview.github.io/?https://github.com/intel/amx-linux/doc-web/x86/xstate.html

Thanks,
Chang

[1] https://lore.kernel.org/lkml/20220909201540.17705-1-chang.seok.bae@xxxxxxxxx/
[2] arch_prctl(2): https://man7.org/linux/man-pages/man2/arch_prctl.2.html

Chang S. Bae (4):
Documentation/x86: Explain the purpose for dynamic features
x86/arch_prctl: Add AMX feature numbers as ABI constants
Documentation/x86: Add the AMX enabling example
Documentation/x86: Explain the state component permission for guests

Documentation/x86/xstate.rst | 100 ++++++++++++++++++++++++++++++
arch/x86/include/uapi/asm/prctl.h | 3 +
2 files changed, 103 insertions(+)


base-commit: 08ed00508bc1fa0a0bc6dd2420f982b55051de23
--
2.17.1