From: Bagas Sanjaya <bagasdotme@gmail.com>
To: Linux Documentation <linux-doc@vger.kernel.org>,
Linux RISC-V <linux-riscv@lists.infradead.org>,
Linux Kernel Mailing List <linux-kernel@vger.kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>,
Paul Walmsley <paul.walmsley@sifive.com>,
Palmer Dabbelt <palmer@dabbelt.com>,
Albert Ou <aou@eecs.berkeley.edu>,
Bagas Sanjaya <bagasdotme@gmail.com>,
Vincent Chen <vincent.chen@sifive.com>,
Andy Chiu <andy.chiu@sifive.com>,
Greentime Hu <greentime.hu@sifive.com>
Subject: [PATCH 5/5] Documentation: riscv: vector: Fix bullet list usage on sysctl section
Date: Sun, 14 May 2023 16:04:32 +0700 [thread overview]
Message-ID: <20230514090432.78217-6-bagasdotme@gmail.com> (raw)
In-Reply-To: <20230514090432.78217-1-bagasdotme@gmail.com>
Prose sentences are better written as normal paragraph instead of
using bullet lists.
Also, use bullet list for list of riscv_v_default_allow values.
Fixes: 412c68cfeeb178 ("riscv: Add documentation for Vector")
Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
---
Documentation/riscv/vector.rst | 27 +++++++++++++--------------
1 file changed, 13 insertions(+), 14 deletions(-)
diff --git a/Documentation/riscv/vector.rst b/Documentation/riscv/vector.rst
index 4624e5b9bef4cc..f752826871b0e2 100644
--- a/Documentation/riscv/vector.rst
+++ b/Documentation/riscv/vector.rst
@@ -102,25 +102,24 @@ status for the use of Vector in userspace:
2. System runtime configuration (sysctl)
-----------------------------------------
- * To mitigate the ABI impact of expansion of the signal stack, a
- policy mechanism is provided to the administrators, distro maintainers, and
- developers to control the default Vector enablement status for userspace
- processes:
+To mitigate the ABI impact of expansion of the signal stack, a
+policy mechanism is provided to the administrators, distro maintainers, and
+developers to control the default Vector enablement status for userspace
+processes in form of sysctl knob:
-/proc/sys/abi/riscv_v_default_allow
+* /proc/sys/abi/riscv_v_default_allow
Writing the text representation of 0 or 1 to this file sets the default
- system enablement status for new starting userspace programs. A valid value
- should be:
+ system enablement status for new starting userspace programs. Valid values
+ are:
- 0: Do not allow Vector code to be executed as the default for new processes.
-
- 1: Allow Vector code to be executed as the default for new processes.
+ * 0: Do not allow Vector code to be executed as the default for new processes.
+ * 1: Allow Vector code to be executed as the default for new processes.
Reading this file returns the current system default enablement status.
-* At every execve() call, a new enablement status of the new process is set to
- the system default, unless:
+ At every execve() call, a new enablement status of the new process is set to
+ the system default, unless:
* PR_RISCV_V_VSTATE_CTRL_INHERIT is set for the calling process, and the
setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not
@@ -129,5 +128,5 @@ status for the use of Vector in userspace:
* The setting in PR_RISCV_V_VSTATE_CTRL_NEXT_MASK is not
PR_RISCV_V_VSTATE_CTRL_DEFAULT.
-* Modifying the system default enablement status does not affect the enablement
- status of any existing process of thread that do not make an execve() call.
+ Modifying the system default enablement status does not affect the enablement
+ status of any existing process of thread that do not make an execve() call.
--
An old man doll... just what I always wanted! - Clara
prev parent reply other threads:[~2023-05-14 9:05 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-05-14 9:04 [PATCH 0/5] riscv: Fixes for vector extension documentation Bagas Sanjaya
2023-05-14 9:04 ` [PATCH 1/5] Documentation: riscv: vector: Separate SPDX license identifier and page title Bagas Sanjaya
2023-05-14 9:04 ` [PATCH 2/5] Documentation: riscv: vector: Wrap control_argument struct definition in code block Bagas Sanjaya
2023-05-14 9:04 ` [PATCH 3/5] Documentation: riscv: vector: Use bullet lists for prctl list Bagas Sanjaya
2023-05-14 9:49 ` Conor Dooley
2023-05-16 14:28 ` Andy Chiu
2023-05-14 9:04 ` [PATCH 4/5] Documentation: riscv: vector: Use bullet lists for prctl() return values Bagas Sanjaya
2023-05-14 9:04 ` Bagas Sanjaya [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20230514090432.78217-6-bagasdotme@gmail.com \
--to=bagasdotme@gmail.com \
--cc=andy.chiu@sifive.com \
--cc=aou@eecs.berkeley.edu \
--cc=corbet@lwn.net \
--cc=greentime.hu@sifive.com \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-riscv@lists.infradead.org \
--cc=palmer@dabbelt.com \
--cc=paul.walmsley@sifive.com \
--cc=vincent.chen@sifive.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
Powered by JetHome