From patchwork Sun May 14 09:04:28 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 13240418 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 780B9C7EE25 for ; Sun, 14 May 2023 09:05:00 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=2uwUS0+BthrgXGKBusalw9L0j6/7+XONYM407kLg4cE=; b=Knkj9fZfl1CPki 0CNSy4wBZNRMHlczClZBAoQFQlV6mmx782pkNoet3WvbL1CfUgg47wUP1qSxMQ15QeRtuo6O/R85M MDOoUKz+d9Dde8hXf0cwdLJJdS68EpcwYwvkZyam9aVO/uC99KyowHjJwNoA0vtaiEU1LMYc3LHDr m4qwzzPsNIVLLSqDpfA+sX/jiTIpYiYvu19MhPzmCNrKe4RTnFsC+YEqxGbKS65y0A0V4wiheM3np DLXkRtHf47EjR5R9xn4TIEMPkiqNXgD2oM48ahtkjnTAGgZx81n3/f+xLmHjjBnaWaiTO6q7VGe7T kzzU9R8jCGaxh2+2BNGw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.96 #2 (Red Hat Linux)) id 1py7eu-00GncK-2W; Sun, 14 May 2023 09:04:52 +0000 Received: from mail-pf1-x429.google.com ([2607:f8b0:4864:20::429]) by bombadil.infradead.org with esmtps (Exim 4.96 #2 (Red Hat Linux)) id 1py7eo-00GnZ5-1a for linux-riscv@lists.infradead.org; Sun, 14 May 2023 09:04:47 +0000 Received: by mail-pf1-x429.google.com with SMTP id d2e1a72fcca58-643b7b8f8ceso6438827b3a.1 for ; Sun, 14 May 2023 02:04:45 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1684055085; x=1686647085; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=usTUzbJN3/c9qoBFyD+eiQ3LKf9ePyuHk2BoTbJ/pEs=; b=Tw1gGElBkh8bqUaPMfHAAZpRT3Noti9lbtsdwJLRTcytBsUA/i1hG+XMsGkmHnE6NY aHyrQhxtHygbXeK/92udiPG55yV8EGkzNaio9qwQplvUx5sEerv5EeH6u1WMhAdb6N/7 M9P2Vlp5GGdsHBrcjmupaObC0zMFXrMAFACphbX4vQ4STofy+TILK02+2UjFMvrnREmj oZ7Yg4pHVIuF5i0TThC/V1EHpb0HqvcLuG6GRJtsj2LflWeJ6PoRT287VJaAgOlCm7Ty EFvBddckDp8Cn1pQrKbTbUvZFzRUb5SaRQdnP0uyk2p3U4gLRu3Oi1Ebc2GGBcaxZTw/ Hqrg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1684055085; x=1686647085; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=usTUzbJN3/c9qoBFyD+eiQ3LKf9ePyuHk2BoTbJ/pEs=; b=Di+QPiMNdS/RXliCBgGr7C+cyeOKqXBYiHUq6tqbWC577TngCJvWXzROF67yEFBfsn OQoDvEyAqSpomCJixcioqm9xjD21TbRz6u/XjPbsDred4q9kPGeKxp9ZMR8EeBAGy1JQ y+FaEjf3kFRBMhwpwGewAO73pW5Iw7n/33Z25Ga9secVaSUrYYC1Z/5t3Mw8qaDkQ882 9F+G1YCJn1XyDHBq0h0Fg9ciF1jg+QI6sKhiYiqWXcRmDzfIaVhaghu/ZqoNlbll02lF R6azH2N4cJhcXMwaLUJExI5kMO8Twwpa6EbGD/c93ZSrs0E7yP4aMbIwiayfigkTKLSS J2zg== X-Gm-Message-State: AC+VfDzQWag7sme9pJcTXpyZjb5LcNrN24Ooor1yN/s7UVDZf431wmvr oNnprL1yHwGYGNsAg2XcV8Gmg2RyEyQ= X-Google-Smtp-Source: ACHHUZ4bUWZYUrifcQ0piB59H0YsIlr7vxuuwgc5h7KVvnAMIt651hXEgbblF0+3MbYFblaVCvxnfA== X-Received: by 2002:a05:6a20:12ce:b0:104:edde:67b7 with SMTP id v14-20020a056a2012ce00b00104edde67b7mr6862078pzg.27.1684055084819; Sun, 14 May 2023 02:04:44 -0700 (PDT) Received: from debian.me (subs02-180-214-232-68.three.co.id. [180.214.232.68]) by smtp.gmail.com with ESMTPSA id 17-20020aa79251000000b00637b0c719c5sm9662227pfp.201.2023.05.14.02.04.44 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 14 May 2023 02:04:44 -0700 (PDT) Received: by debian.me (Postfix, from userid 1000) id 8522F1061D9; Sun, 14 May 2023 16:04:36 +0700 (WIB) From: Bagas Sanjaya To: Linux Documentation , Linux RISC-V , Linux Kernel Mailing List Cc: Jonathan Corbet , Paul Walmsley , Palmer Dabbelt , Albert Ou , Bagas Sanjaya , Vincent Chen , Andy Chiu , Greentime Hu , kernel test robot Subject: [PATCH 1/5] Documentation: riscv: vector: Separate SPDX license identifier and page title Date: Sun, 14 May 2023 16:04:28 +0700 Message-Id: <20230514090432.78217-2-bagasdotme@gmail.com> X-Mailer: git-send-email 2.40.1 In-Reply-To: <20230514090432.78217-1-bagasdotme@gmail.com> References: <20230514090432.78217-1-bagasdotme@gmail.com> MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1012; i=bagasdotme@gmail.com; h=from:subject; bh=6LP5rrObq7wY9XwwQUBOiCWJUloqKCLwe+amTJtxnvQ=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDCkJS+RnPnfcu+Hy37mZ1jef+dt2Ptr9+Iufm9XfTywvy 6TDTgtZdpSyMIhxMciKKbJMSuRrOr3LSORC+1pHmDmsTCBDGLg4BWAizt8YGTrnCWsFTL5asDRN +NDv/0Wavgb1J92MZm1fkWfmHfA3/T8jw8po0UlPrOqmBbyVkvrzZ2W9wJTchw3rW89alujLulb 18QMA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20230514_020446_532504_6CCD246F X-CRM114-Status: UNSURE ( 9.61 ) X-CRM114-Notice: Please train this message. X-BeenThere: linux-riscv@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-riscv" Errors-To: linux-riscv-bounces+linux-riscv=archiver.kernel.org@lists.infradead.org kernel test robot reports htmldocs warning: Documentation/riscv/vector.rst:2: WARNING: Explicit markup ends without a blank line; unexpected unindent. Add a blank line separator between SPDX tag and doc title to fix above warning. Fixes: 412c68cfeeb178 ("riscv: Add documentation for Vector") Reported-by: kernel test robot Closes: https://lore.kernel.org/linux-doc/202305141409.bEBvlSY4-lkp@intel.com/ Signed-off-by: Bagas Sanjaya --- Documentation/riscv/vector.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/Documentation/riscv/vector.rst b/Documentation/riscv/vector.rst index d4d626721921aa..acc97508ccb249 100644 --- a/Documentation/riscv/vector.rst +++ b/Documentation/riscv/vector.rst @@ -1,4 +1,5 @@ .. SPDX-License-Identifier: GPL-2.0 + ========================================= Vector Extension Support for RISC-V Linux ========================================= From patchwork Sun May 14 09:04:29 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 13240419 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 15813C77B7D for ; Sun, 14 May 2023 09:05:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=oKG7AMh7o+rkijbIx1xXyWYdP7l5NS+sy6JKwIB9ow8=; b=mHfGaadKTMCqBG OeN5ARRDtWlgSSzio3j3/YXHR/0s5EOzTPwTRUembSKhdfoaCBe0TMUta7mrtJjDz7EdCpVLKyLxC F5Zvbli8rrZj39HRRBrzPhGRsHUyZYsBjZOtJ0/B0GdudtCc+9jnQZtFk75wg8DACCTppzLNbdaqy maLyn9AqR/eO68NPwbQmqGenMz36wOuMFoSwRBMEL8TrFzI0Ee+b4RN74yXpx+QXMvZIYOuiRgyxp kbfw+ccLmk4RO+Z0/l3/HUDc3UXm4wDaVpCGNWSFtTZec8JE54LSyJVrCmTHtZ6wEQhpwCwBzd0xs KE2z/8u06UKZTl105H9w==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.96 #2 (Red Hat Linux)) id 1py7ep-00GnaL-1u; Sun, 14 May 2023 09:04:47 +0000 Received: from mail-pg1-x532.google.com ([2607:f8b0:4864:20::532]) by bombadil.infradead.org with esmtps (Exim 4.96 #2 (Red Hat Linux)) id 1py7el-00GnXB-0g for linux-riscv@lists.infradead.org; Sun, 14 May 2023 09:04:44 +0000 Received: by mail-pg1-x532.google.com with SMTP id 41be03b00d2f7-53202149ae2so510311a12.3 for ; Sun, 14 May 2023 02:04:42 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1684055082; x=1686647082; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=3VswhOVIM6N9lUQ5IbUMqB4CktfYicQQNL7zwxJA2o0=; b=gyDuam61cQhcYHV2PBw+v0qV4xXs/l6wEC2KCFNxFE/FegwP3dNUz5F1uZITuqHFNs syiVQB93aJW0sk3dLTzvIhAtFHwDUqDKv0DxfjPY2LAfiUZREKQetU0o4FtYmcZQHYIs SLz9bvWw+KOJZ9F58insz5q1Q/Skkb5ZBSSqQ4KzVy25ZR4TPjjpJmmxfaW5AkzGCLYU kyC0WR8qHm43CsElKIx+99P5bQhd5JC/WeUgHvZB+8yiE6kpC5wDiHU1qUxnNw8aFVm9 vFQy9JA/WrL+zGvFSBJEGZp5u/gEeh+YLvR48s3C3QiNrlZmM8/gWAa2JdPSR7QH4t7v dtTQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1684055082; x=1686647082; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=3VswhOVIM6N9lUQ5IbUMqB4CktfYicQQNL7zwxJA2o0=; b=KvX2sKHF7evPgLCJNX8lVI+3hzwNLlPtcmOO3qRQu8Y98vTomXoU/5epgok/npd9dV 15OFuJ9Rm2XYKLhggmShLyVYIJy/tPAWEWjanNkiUCJ0T3TfPC2TajWywwMJEeHKYIrg m3h+rtVqJJXorOnPawfk+wPcXtAa4kE45jqW/5M1kOvCIEYM1LRZndXVSAWJyB456/Nh hC6xhXzOf28gToHa/zlbFWSer+Pk2wsnNdPrVrQYL+/PtCo81GrGm5kqQkxC8N1gGg5j a2KcWvCqvcr0F47UdhTBGfxnyYcdw22RQhIyKK67aBcm6iNw91mNeTaJcJjk+ydVaqTG VWyQ== X-Gm-Message-State: AC+VfDytQBW3gdSaFi/Dj5EGxf6ZJbQx8MPb2DWFFePgWD2Rk/Yuj702 iO2jU8tGB18vUzcEzDVSgk0= X-Google-Smtp-Source: ACHHUZ4pzmq3hWDHq3IlCijrOGJ+N5qc/X55K3MabPDZwyQJR3SxOAkkPZxkiTNzN5IhuNLdSkgMaA== X-Received: by 2002:a17:903:483:b0:1aa:dba2:d155 with SMTP id jj3-20020a170903048300b001aadba2d155mr29039425plb.48.1684055081786; Sun, 14 May 2023 02:04:41 -0700 (PDT) Received: from debian.me (subs02-180-214-232-68.three.co.id. [180.214.232.68]) by smtp.gmail.com with ESMTPSA id l16-20020a170902f69000b001a6d08eb054sm11043270plg.78.2023.05.14.02.04.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 14 May 2023 02:04:41 -0700 (PDT) Received: by debian.me (Postfix, from userid 1000) id 2DC2B1061DC; Sun, 14 May 2023 16:04:36 +0700 (WIB) From: Bagas Sanjaya To: Linux Documentation , Linux RISC-V , Linux Kernel Mailing List Cc: Jonathan Corbet , Paul Walmsley , Palmer Dabbelt , Albert Ou , Bagas Sanjaya , Vincent Chen , Andy Chiu , Greentime Hu , kernel test robot Subject: [PATCH 2/5] Documentation: riscv: vector: Wrap control_argument struct definition in code block Date: Sun, 14 May 2023 16:04:29 +0700 Message-Id: <20230514090432.78217-3-bagasdotme@gmail.com> X-Mailer: git-send-email 2.40.1 In-Reply-To: <20230514090432.78217-1-bagasdotme@gmail.com> References: <20230514090432.78217-1-bagasdotme@gmail.com> MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1947; i=bagasdotme@gmail.com; h=from:subject; bh=S42igDCO53ZkCWTrexHErxJ8V8JjUUjsuLNH7WukgIk=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDCkJS+RzdR/arTB/dyeC+/VO9ajKJbfWaS/eYre5au63m 9852bandZSyMIhxMciKKbJMSuRrOr3LSORC+1pHmDmsTCBDGLg4BWAi14sY/kd1vNPLvh0ZLD/5 +z3mc4mLzqh4tworRzq5Tp3pp3vu1n5Ghv7++/tYF7VvFmVYUlTw9UbKt18FpXt8xcw3v5p2QmO 6JycA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20230514_020443_296791_5273EC5D X-CRM114-Status: GOOD ( 10.79 ) X-BeenThere: linux-riscv@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-riscv" Errors-To: linux-riscv-bounces+linux-riscv=archiver.kernel.org@lists.infradead.org kernel test robot reports htmldocs warning: Documentation/riscv/vector.rst:45: WARNING: Definition list ends without a blank line; unexpected unindent. The warning is due to definition of control_argument struct, written unformatted. Wrap it in code block with C syntax highlighting to fix the warning. Fixes: 412c68cfeeb178 ("riscv: Add documentation for Vector") Reported-by: kernel test robot Closes: https://lore.kernel.org/oe-kbuild-all/202305141409.bEBvlSY4-lkp@intel.com/ Signed-off-by: Bagas Sanjaya --- Documentation/riscv/vector.rst | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/Documentation/riscv/vector.rst b/Documentation/riscv/vector.rst index acc97508ccb249..178b3f3f452462 100644 --- a/Documentation/riscv/vector.rst +++ b/Documentation/riscv/vector.rst @@ -36,14 +36,16 @@ prctl(PR_RISCV_V_SET_CONTROL, unsigned long arg) be interpreted as the following structure, and accessed by 3 masks respectively. - struct control_argument { - // Located by PR_RISCV_V_VSTATE_CTRL_CUR_MASK - int current_enablement_status : 2; - // Located by PR_RISCV_V_VSTATE_CTRL_NEXT_MASK - int next_enablement_status : 2; - // Located by PR_RISCV_V_VSTATE_CTRL_INHERIT - bool inherit_mode : 1; - } + .. code-block:: c + + struct control_argument { + // Located by PR_RISCV_V_VSTATE_CTRL_CUR_MASK + int current_enablement_status : 2; + // Located by PR_RISCV_V_VSTATE_CTRL_NEXT_MASK + int next_enablement_status : 2; + // Located by PR_RISCV_V_VSTATE_CTRL_INHERIT + bool inherit_mode : 1; + } The 3 masks, PR_RISCV_V_VSTATE_CTRL_CUR_MASK, PR_RISCV_V_VSTATE_CTRL_NEXT_MASK, and PR_RISCV_V_VSTATE_CTRL_INHERIT From patchwork Sun May 14 09:04:30 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 13240421 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 2DB94C7EE2F for ; Sun, 14 May 2023 09:05:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=/JbgRPtNLynSwRkGDC+xVVkFLlEzq4yLbz3lfqTYF7I=; b=mtdohg7UN5uhsu VtlAF5ZCKTwbLmc/KJquc7TBUZ/vCa6jvhShGb0ByqH3aBe928Ux1/2fCXnxHHCjxy/CMW2oUtF5M l47oOr/58RnLoF5vVH87Tr0rRM5yVidFhy1pfZGq1s+GzsWZlPPGoWPRWtsrALDGRbSxZyjuxdFOG vjoIIRtIX2OOWkdPtFNZ1dYrFoDpnE+aPHkXBzOScyEfx4BGXa6LECAc2z7gnfJjWut3z1Xl29qVS HKVv1DfRnwCxVQ6zSRVlkFadjNjpn09B9iQ6G4tOYnrX/nXyU9Dpi6NkHesCnFNi9nKEUymArPbes tCP5fbSY+I8dF4YjI/Cw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.96 #2 (Red Hat Linux)) id 1py7en-00GnZ6-2n; Sun, 14 May 2023 09:04:45 +0000 Received: from mail-pg1-x536.google.com ([2607:f8b0:4864:20::536]) by bombadil.infradead.org with esmtps (Exim 4.96 #2 (Red Hat Linux)) id 1py7el-00GnXF-0g for linux-riscv@lists.infradead.org; Sun, 14 May 2023 09:04:44 +0000 Received: by mail-pg1-x536.google.com with SMTP id 41be03b00d2f7-528cdc9576cso7926500a12.0 for ; Sun, 14 May 2023 02:04:42 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1684055082; x=1686647082; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=qIanyhJS88Q7RfVNqljO8EtKKIvGna+18p2AMpDpX+U=; b=CgLdpdVKhiQqsKr2AyMNHWm3uR3kk6DMFszCy7EQcABgt28gkiZ1AafbMGbW86JTx+ LnizcfPOhbNBU8/9RIfbvviAVLKL1ApA166UNnezr4YyshFLSs+QU908wo51TG06sFUn 6vwOI3CzVmcFf9Rtmw2XNfDisol0wwtMnYLSalk8sHyygzfj7RXU2E0S5A3rVNLe39cR P9B3/gSUsU9KGsf+To00d+xpUeEBLJy8bzbwQhFkSQSDjJkM8eLN3QknKrQRTgN3aOg1 LLg2u3AUAQJQG1iOcSi9qA9U4jCzF82jq5Jb8ACLvSevx4NBSVdYaSwjhoKG0QHfQPWI C1Kg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1684055082; x=1686647082; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=qIanyhJS88Q7RfVNqljO8EtKKIvGna+18p2AMpDpX+U=; b=dZbLHKgBMFY7SsmHrcIPUEF1ZU3fubiZwZQSrVXx+YLbsULOzaVdrN7FdzatdCK0X2 BtoJN10Pu1SSGq1OaJGUiQ3MsHJCgOCJ6cUKLxtjvf4ISt7CYPF3UQ5VpmnT3v/tVcpj qFovyCzGJeX5PrgRBUI9YrqfMrCdd3YCFdbH6i9jAjJNG+rAsBVaqqKRQLnvCy7JgrgV aZgoG0Mcnv9ShOSI1QBQ0XwVOMSvvKKJru+dvzb/+H+6RrAYNk458F+/CAHvTY7P6gV7 2H+nftTrHJ3ShtY1FcCUitmPoX/gSbsUM4NWRLwhqNFxhtizN38MB4hvf8Kr8iPmLjDz ZgKQ== X-Gm-Message-State: AC+VfDwc+5nS4Y+pdNGphD/9eYFjE+Rj5fzJlhu0qRf5NPrwT3l6e6gN q/GgvfZK1d5k3kt3hFSKqnU= X-Google-Smtp-Source: ACHHUZ4V5wgMt2YCt4Gb1ub46b4Vak78d55bkX0cYjQkPO8T8Qiv0fPcs8d2tc7YVgqJPIXodP5WAQ== X-Received: by 2002:a17:903:22cb:b0:1ac:6e1f:d19c with SMTP id y11-20020a17090322cb00b001ac6e1fd19cmr30176048plg.41.1684055081976; Sun, 14 May 2023 02:04:41 -0700 (PDT) Received: from debian.me (subs02-180-214-232-68.three.co.id. [180.214.232.68]) by smtp.gmail.com with ESMTPSA id jj3-20020a170903048300b001a9666376a9sm11029564plb.226.2023.05.14.02.04.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 14 May 2023 02:04:41 -0700 (PDT) Received: by debian.me (Postfix, from userid 1000) id 6CA011061DE; Sun, 14 May 2023 16:04:36 +0700 (WIB) From: Bagas Sanjaya To: Linux Documentation , Linux RISC-V , Linux Kernel Mailing List Cc: Jonathan Corbet , Paul Walmsley , Palmer Dabbelt , Albert Ou , Bagas Sanjaya , Vincent Chen , Andy Chiu , Greentime Hu Subject: [PATCH 3/5] Documentation: riscv: vector: Use bullet lists for prctl list Date: Sun, 14 May 2023 16:04:30 +0700 Message-Id: <20230514090432.78217-4-bagasdotme@gmail.com> X-Mailer: git-send-email 2.40.1 In-Reply-To: <20230514090432.78217-1-bagasdotme@gmail.com> References: <20230514090432.78217-1-bagasdotme@gmail.com> MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1431; i=bagasdotme@gmail.com; h=from:subject; bh=cZzclkM/zLfkcp8yZSx1IGcKkEsU6t+56HAynF/Kr40=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDCkJS+R/RJzdLfV0aWb3xHVc1QXO9/n0mb18FBjuz246V HJDISSxo5SFQYyLQVZMkWVSIl/T6V1GIhfa1zrCzGFlAhnCwMUpABNZl8HIsCvPbkujH3+x3hJt oyKnX5v2sJq/UmgWD6lSrFV/6MfPysiw6g130FSu6xuc+hdWP3zTcr5Vwe9Jyox87rIcya02b6S 4AQ== X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20230514_020443_297182_3799B9E1 X-CRM114-Status: GOOD ( 12.55 ) X-BeenThere: linux-riscv@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-riscv" Errors-To: linux-riscv-bounces+linux-riscv=archiver.kernel.org@lists.infradead.org The documentation lists two userspace prctl() calls. Use bullet lists for the listing. Fixes: 412c68cfeeb178 ("riscv: Add documentation for Vector") Signed-off-by: Bagas Sanjaya --- Documentation/riscv/vector.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/riscv/vector.rst b/Documentation/riscv/vector.rst index 178b3f3f452462..c7bd701c7963b6 100644 --- a/Documentation/riscv/vector.rst +++ b/Documentation/riscv/vector.rst @@ -13,7 +13,7 @@ order to support the use of the RISC-V Vector Extension. Two new prctl() calls are added to allow programs to manage the enablement status for the use of Vector in userspace: -prctl(PR_RISCV_V_SET_CONTROL, unsigned long arg) +* prctl(PR_RISCV_V_SET_CONTROL, unsigned long arg) Sets the Vector enablement status of the calling thread, where the control argument consists of two 2-bit enablement statuses and a bit for inheritance @@ -89,7 +89,7 @@ prctl(PR_RISCV_V_SET_CONTROL, unsigned long arg) * Every successful call overwrites a previous setting for the calling thread. -prctl(PR_RISCV_V_SET_CONTROL) +* prctl(PR_RISCV_V_SET_CONTROL) Gets the same Vector enablement status for the calling thread. Setting for next execve() call and the inheritance bit are all OR-ed together. From patchwork Sun May 14 09:04:31 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 13240420 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id F4090C77B7F for ; Sun, 14 May 2023 09:05:02 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=Cq6gzMm6aV8jzvnLHhgEP3F2MvQhOfWgCpT/h3GNDuM=; b=M3thR1Q1I4XR4n drPxAHA/hsitG3ddCa8TlFmtZHHtRWa1U8d5QDN5Zw4BhWUikY6CkhHM3pKMMtikuJ+U1eRioFgS2 tL5BISiCdCg8Sgj7ULEykk3qb4vPTGsP899cfU/N0yw5c3ZDkYEDjSAcpG4NgaTZ5UN2y+v0fWsU7 6zii0DLyu8llaoEaBP8WPWNwKrbsBE3bPWA3lUDIhnj7gOSXEaeFMWoZcJjNjnlY/QgbqFV9JEiyG CPpqPXGC4Uutvmi1Cb/oDtRykq4gPFL0/WlFNyqgPY0FMLHsd9X2UD2jr77PnX1f7Fj/PtShj2dvH iSkzKsb5yHrVmugC40uA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.96 #2 (Red Hat Linux)) id 1py7eq-00Gnac-0Q; Sun, 14 May 2023 09:04:48 +0000 Received: from mail-pl1-x62c.google.com ([2607:f8b0:4864:20::62c]) by bombadil.infradead.org with esmtps (Exim 4.96 #2 (Red Hat Linux)) id 1py7el-00GnXL-2N for linux-riscv@lists.infradead.org; Sun, 14 May 2023 09:04:45 +0000 Received: by mail-pl1-x62c.google.com with SMTP id d9443c01a7336-1aaea3909d1so108452125ad.2 for ; Sun, 14 May 2023 02:04:42 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1684055082; x=1686647082; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=MlYIG+wyBwHIZ6Ig5rNTc1U+7HEnxpjzPz2HnP+gqKM=; b=sxfLoTD0NF/Oidjt/30xAfQe77E+2H/A1Bt6TqxQY2/6VNOFb0Uyd85NQjRvs0Gag5 ejrvn5D290RidtfydaauoUKGO4geu0N0v4EPBJVBS/2JCC7s9OlM++hFr2teuavzTW21 ZV38a4rRNxUSnzdANrgTy8cb43irt2nrXWTxTXA1cnSswvilFYTNiRQWaUC9O94aAmVC lsnuAyuWfstUpgoGlSOIE7RjKzp/q39GNYDFqSYH/lHiWVVtzTldV8FA1qIHmtitgb/Z H1jO8rmhRdfuzZAEtY0XTyuQtKvXr1GkSahDS2V2F5V30jwmZRixBETwojLYSyVRTjYu EPzw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1684055082; x=1686647082; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=MlYIG+wyBwHIZ6Ig5rNTc1U+7HEnxpjzPz2HnP+gqKM=; b=cBScXy1SbKAVpqKb3m+whh1PCv8j/GVu/Y2KYraV8xbZwOpLOmtUMr9zKCxlJmz3eo gZyZk3sgjF1rtSR8/8GCBn721sLsZxhRb0MqoItFXvoYP3LLN3szbw3SFVHRAwuBju0/ rqweUDjwVGnbFKge/dApUBL6LDRgywT6reXi9+x2xKVQVWJo1sVkfCsA3vRHDlmsMrjK kkBTibUxOZlj4WapiS1pOIkS7DOb3oCYce2HmY3h5VWanW6kWN9XMYRh607D4e5iVRrH 0y5pJbKbfM8cNq2B/7L999ZRBYga5wKc0YYY69ylloALrjim0bKD+0oj7xfTBuozajvt WYQA== X-Gm-Message-State: AC+VfDzKkMmFmyTGT+/vFPP6Exx59OngEzGEAp8lYWwwaCyCqtpfULGr 2upKMXhg9lFuKZtJNBp/MBUopwKfk4w= X-Google-Smtp-Source: ACHHUZ6wCkJuuI/JM0p/RqMI5Szf/kAYaz3iNpFxdIUUUIOPWbcgZwStiNGZBZC7kIqG3LZRUx/3VQ== X-Received: by 2002:a17:903:41d0:b0:1ac:4412:bd9 with SMTP id u16-20020a17090341d000b001ac44120bd9mr37163799ple.3.1684055082288; Sun, 14 May 2023 02:04:42 -0700 (PDT) Received: from debian.me (subs02-180-214-232-68.three.co.id. [180.214.232.68]) by smtp.gmail.com with ESMTPSA id x11-20020a170902fe8b00b001ac45598b59sm11060546plm.163.2023.05.14.02.04.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 14 May 2023 02:04:41 -0700 (PDT) Received: by debian.me (Postfix, from userid 1000) id F099710363C; Sun, 14 May 2023 16:04:36 +0700 (WIB) From: Bagas Sanjaya To: Linux Documentation , Linux RISC-V , Linux Kernel Mailing List Cc: Jonathan Corbet , Paul Walmsley , Palmer Dabbelt , Albert Ou , Bagas Sanjaya , Vincent Chen , Andy Chiu , Greentime Hu Subject: [PATCH 4/5] Documentation: riscv: vector: Use bullet lists for prctl() return values Date: Sun, 14 May 2023 16:04:31 +0700 Message-Id: <20230514090432.78217-5-bagasdotme@gmail.com> X-Mailer: git-send-email 2.40.1 In-Reply-To: <20230514090432.78217-1-bagasdotme@gmail.com> References: <20230514090432.78217-1-bagasdotme@gmail.com> MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=2108; i=bagasdotme@gmail.com; h=from:subject; bh=BIcautUtnBxQsDL0RzYa8VBmwL4oBx+HTCFWbrbAgPA=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDCkJSxQcJVJWzP9edXyJjjEvl+urG8yqOQaHWeu6mpPXT Yh+YGbWUcrCIMbFICumyDIpka/p9C4jkQvtax1h5rAygQxh4OIUgIu8YvhffPhVyo3d3M3LJhep XqwySe3xXazE+X990PRcvvXXl6vcZPinqrjPJvfnzrcnWx+vfqM8q/P7tacJkhIyZemTP3yYKnC dBQA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20230514_020443_771636_C96699BB X-CRM114-Status: GOOD ( 11.53 ) X-BeenThere: linux-riscv@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-riscv" Errors-To: linux-riscv-bounces+linux-riscv=archiver.kernel.org@lists.infradead.org Use bullet lists on return values of prctl() calls to follow other listings (bit lists and enablement status). This should convey purposes of listing things. Fixes: 412c68cfeeb178 ("riscv: Add documentation for Vector") Signed-off-by: Bagas Sanjaya --- Documentation/riscv/vector.rst | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/Documentation/riscv/vector.rst b/Documentation/riscv/vector.rst index c7bd701c7963b6..4624e5b9bef4cc 100644 --- a/Documentation/riscv/vector.rst +++ b/Documentation/riscv/vector.rst @@ -74,11 +74,12 @@ status for the use of Vector in userspace: PR_RISCV_V_VSTATE_CTRL_NEXT_MASK and PR_RISCV_V_VSTATE_CTRL_INHERIT. This setting persists across changes in the system-wide default value. - Return value: return 0 on success, or a negative error value: - EINVAL: Vector not supported, invalid enablement status for current or - next mask - EPERM: Turning off Vector in PR_RISCV_V_VSTATE_CTRL_CUR_MASK if Vector - was enabled for the calling thread. + Return value: + * 0 on success; + * EINVAL: Vector not supported, invalid enablement status for current or + next mask; + * EPERM: Turning off Vector in PR_RISCV_V_VSTATE_CTRL_CUR_MASK if Vector + was enabled for the calling thread. On success: * A valid setting for PR_RISCV_V_VSTATE_CTRL_CUR_MASK takes place @@ -94,8 +95,9 @@ status for the use of Vector in userspace: Gets the same Vector enablement status for the calling thread. Setting for next execve() call and the inheritance bit are all OR-ed together. - Return value: a nonnegative value on success, or a negative error value: - EINVAL: Vector not supported. + Return value: + * a nonnegative value on success; + * EINVAL: Vector not supported. 2. System runtime configuration (sysctl) ----------------------------------------- From patchwork Sun May 14 09:04:32 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bagas Sanjaya X-Patchwork-Id: 13240416 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id CC22FC77B7D for ; Sun, 14 May 2023 09:04:58 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=+50nZXXxylQ710cwSz1Fdp3pBvqb+03rXS251UGy/hg=; b=LtpmFiLlr7mw+H nWc/rcza+6VB1cMMNdca+wNnt45W2v0hVVF83R2Kw8pUHcHrYH1Xaa/ATHPaxuoySTaiDZkgjAwfP OI53y8fjuGysqDW6sOqOghRjp+nKVBnLMoRpDhjdeWvBCIagDJYMBx6JFpSqg/XcasbAXjVHc1RfR JghayBE221wcPoZ4K0RROIadhT3bkth5bF+NDiDHRODCZH33Vj9DhShX1bqGVVNTl23OnxT3O1irL uERo6d0QDpbN7NeXzIl1IZaMvvayj7L0ratXobNc1EpaIpXEn1AC7mCu0XG9YylxnVyM5mvEi3xm8 C/HZ2GKxo2KBT76U5JFw==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.96 #2 (Red Hat Linux)) id 1py7er-00Gnas-0W; Sun, 14 May 2023 09:04:49 +0000 Received: from mail-pl1-x631.google.com ([2607:f8b0:4864:20::631]) by bombadil.infradead.org with esmtps (Exim 4.96 #2 (Red Hat Linux)) id 1py7em-00GnXP-0i for linux-riscv@lists.infradead.org; Sun, 14 May 2023 09:04:46 +0000 Received: by mail-pl1-x631.google.com with SMTP id d9443c01a7336-1ab267e3528so82473125ad.0 for ; Sun, 14 May 2023 02:04:43 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1684055083; x=1686647083; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=tWsNucItL3Ir8RVSxlrmAT54pJTVw6Lt+rodKw+CzPs=; b=FvWwMcL2+nO561GFgxSm3hIVvRbDWjclyM+XprkVWb53HMSCvWLBbQ6PJDhWTynSgt 539bfRSH3T9xgYyZfPFiyfxmPfGmqYfdDy6RqsGwy16PcE7Qny9NesyE40zqGYBxffkh g2rSdN3GY7H//g+gBOEvduXkznoyHpiRX8U7JjejquImPn69mKZxY/OCU1u9zgo4rxag OYr2kbUB6kRu8QVgvKwCkJqMsBN+nrIIrTKV5uxHJ4A0zUzScsPlYt7Erhkm9vbAJWGP 4K1rwJSlcClcCmSJqpyAYqK/2u6hLNklJeGwvEvGIQuNk/wH3pU9qSuOCMinEgr8/0Lv huoQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1684055083; x=1686647083; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=tWsNucItL3Ir8RVSxlrmAT54pJTVw6Lt+rodKw+CzPs=; b=SQD4UZhaWGrlEsOSk9iUl4RFcHlaMtf8W8hKm/tZAXTQBFc1stx8Pp2sHFHZEAP2BO zg8h4aQHX8wCEnhchVOTTbJj1P2XJokQYw/XbggeTs16zjMN3zw3pewvnkkHTtaG5+yW s4Xe7Y6AOYEUr+Lvi6IhM9U84Pr48PE8dLtGxapKNI54V9MLMwStl4YGQ31yH+JuFB0s MynWlwJvOoJ7tOtcYpaszbZJxmW7Gz5WN4/5h+9LgOPsVipkWnkBgT6bgctk9xjh42uj gP/xFytH1RHnKfdq75txNAyYJ6JInaBrkce8qc5E/BefdIvaBRIqeig0dH0CwKj5vd8z pm2w== X-Gm-Message-State: AC+VfDzWl1+VY0BhuLQ+naVE49vzEGkKlqNMZYO8gWi/13XcH2ghSDPB 7eBLleYspxlJNeN4lATJ/7I= X-Google-Smtp-Source: ACHHUZ4h2oq0sD6DW1Jn3SJpVqz/5hks4ikFzYyfoO/TD8NhBqG3iYXTurrqa+0pLQikvgf1idsRIA== X-Received: by 2002:a17:903:2092:b0:1ac:8e0b:282c with SMTP id d18-20020a170903209200b001ac8e0b282cmr18318011plc.1.1684055082739; Sun, 14 May 2023 02:04:42 -0700 (PDT) Received: from debian.me (subs02-180-214-232-68.three.co.id. [180.214.232.68]) by smtp.gmail.com with ESMTPSA id g11-20020a1709026b4b00b001acae973449sm9287867plt.162.2023.05.14.02.04.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 14 May 2023 02:04:41 -0700 (PDT) Received: by debian.me (Postfix, from userid 1000) id 490BD1061D7; Sun, 14 May 2023 16:04:36 +0700 (WIB) From: Bagas Sanjaya To: Linux Documentation , Linux RISC-V , Linux Kernel Mailing List Cc: Jonathan Corbet , Paul Walmsley , Palmer Dabbelt , Albert Ou , Bagas Sanjaya , Vincent Chen , Andy Chiu , Greentime Hu Subject: [PATCH 5/5] Documentation: riscv: vector: Fix bullet list usage on sysctl section Date: Sun, 14 May 2023 16:04:32 +0700 Message-Id: <20230514090432.78217-6-bagasdotme@gmail.com> X-Mailer: git-send-email 2.40.1 In-Reply-To: <20230514090432.78217-1-bagasdotme@gmail.com> References: <20230514090432.78217-1-bagasdotme@gmail.com> MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=2953; i=bagasdotme@gmail.com; h=from:subject; bh=GHK5dRGPQCAuWJZz8ukbYwsZAgNOSpPJq12ZuI55/8M=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDCkJSxT0N3SHmsulmgt2i2dWNdX237yubfG1afKdzP3vo uclfZvSUcrCIMbFICumyDIpka/p9C4jkQvtax1h5rAygQxh4OIUgIlEhTEyzObe0dG9/OjsqQwy s3Pe3eVmbGUWEONcc9NrpTFrR1HdY4a/4g/fzL8wYbforvQTN69G7p6xbe3v1Z+v+Maf0z34yXK PBxcA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20230514_020444_256945_ED44E52D X-CRM114-Status: GOOD ( 13.39 ) X-BeenThere: linux-riscv@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-riscv" Errors-To: linux-riscv-bounces+linux-riscv=archiver.kernel.org@lists.infradead.org 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 --- 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.