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

From: Chang S. Bae
Date: Fri Sep 09 2022 - 16:26:37 EST


Hi all,

Here are the changes from the last version [1]:
* Add the motivation for the dynamic feature enabling.
* Add the description for the guest options back.

Thank you Tony for the review.

=== 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/20220711171347.27309-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 | 98 +++++++++++++++++++++++++++++++
arch/x86/include/uapi/asm/prctl.h | 3 +
2 files changed, 101 insertions(+)


base-commit: 132bde89b5234d0ca8909775b354c48b214e1abc
--
2.17.1