[PATCH 0/2] Documentation/x86: Update the dynamic XSTATE doc
From: Chang S. Bae
Date: Thu Jun 16 2022 - 17:31:19 EST
Hi all,
This series is intended to update the documentation only. It is not ready
yet for x86 maintainers. So more acknowledgment from Intel reviewers is
needed. Any preliminary review from the cc'ed folks will be much
appreciated. But it is possibly a waste of maintainers' time to review this
draft at this stage.
=== Cover Letter ===
With the AMX support in the mainline, I realize a couple of new
arch_prctl(2) options that were added for KVM have been missing in the doc.
And recently I heard some folks had hard time to understand the AMX
enabling process. A code example is expected to clarify the steps.
Thus, this patch set includes the following two updates:
(1) Patch 1 adds AMX enabling code example.
(2) Patch 2 explains the arch_prctl(2) options for guest:
ARCH_{GET|REQ}_XCOMP_GUEST_PERM
The arch_prctl(2) manual page [1] is also missing the above and even other
options that are already included in the doc. Perhaps, the man-page update
follows up after this.
These changes can be found in the repo:
git://github.com/intel/amx-linux.git doc
And the compiled preview is available here:
https://htmlpreview.github.io/?https://github.com/intel/amx-linux/blob/doc-web/x86/xstate.html
Thanks,
Chang
[1] arch_prctl(2): https://man7.org/linux/man-pages/man2/arch_prctl.2.html
Chang S. Bae (2):
Documentation/x86: Add the AMX enabling example
Documentation/x86: Explain guest XSTATE permission control
Documentation/x86/xstate.rst | 69 ++++++++++++++++++++++++++++++++++++
1 file changed, 69 insertions(+)
base-commit: b13baccc3850ca8b8cccbf8ed9912dbaa0fdf7f3
--
2.17.1