From nobody Mon Feb 9 15:59:22 2026 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2EA27C7EE26 for ; Sun, 14 May 2023 09:05:01 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234523AbjENJE6 (ORCPT ); Sun, 14 May 2023 05:04:58 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37362 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233374AbjENJEq (ORCPT ); Sun, 14 May 2023 05:04:46 -0400 Received: from mail-pf1-x42c.google.com (mail-pf1-x42c.google.com [IPv6:2607:f8b0:4864:20::42c]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 7708A1BDD; Sun, 14 May 2023 02:04:45 -0700 (PDT) Received: by mail-pf1-x42c.google.com with SMTP id d2e1a72fcca58-6439f186366so7324698b3a.2; 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=llzP2b2bSXgjUICXIjyR8LdnaJuMJKA70y5+HeWqosMt1/V+PCOL4Orbu0mSU653Qw CT2KMOdUoCylgNK3Haf+qT8T80YYgloAP0JEcnaRPJ79MUIvU5RMsLm0g2Y4lNXMiPK0 PtrC4BBweLV0nOBgQyF9WK6GfJPa0MHP98PWXJXCNMl6Qy1qBJlK4+gQICyGx496vmUu 5ym0Flw+/ZS3aZrdaH0e/Vi6zztsWIRSPZJQc6yo1Y79oitbCp+zNyenUnf9BsJQ5s8h f7j7NIfpdEErjdsqE7N1ze7R/MxuEi8RzbTP+glCHXk+QSTD4PL9GZhLaSNsTOB8Eqsi nRXA== X-Gm-Message-State: AC+VfDyIragiTxjxdqZxpseSGsplf+kUsTiQ8qTZUjueGsm+yi+IMwmG yojl2zy+4IxygChplJg+xbk= 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 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" kernel test robot reports htmldocs warning: Documentation/riscv/vector.rst:2: WARNING: Explicit markup ends without a b= lank line; unexpected unindent. Add a blank line separator between SPDX tag and doc title to fix above warn= ing. Fixes: 412c68cfeeb178 ("riscv: Add documentation for Vector") Reported-by: kernel test robot Closes: https://lore.kernel.org/linux-doc/202305141409.bEBvlSY4-lkp@intel.c= om/ 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 + =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Vector Extension Support for RISC-V Linux =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --=20 An old man doll... just what I always wanted! - Clara From nobody Mon Feb 9 15:59:22 2026 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2FB38C77B7F for ; Sun, 14 May 2023 09:04:53 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233893AbjENJEr (ORCPT ); Sun, 14 May 2023 05:04:47 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37332 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229763AbjENJEn (ORCPT ); Sun, 14 May 2023 05:04:43 -0400 Received: from mail-pg1-x530.google.com (mail-pg1-x530.google.com [IPv6:2607:f8b0:4864:20::530]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 703191BDD; Sun, 14 May 2023 02:04:42 -0700 (PDT) Received: by mail-pg1-x530.google.com with SMTP id 41be03b00d2f7-51b33c72686so7847153a12.1; 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=DMNxha7+Ibsrg6NjF1HMPCXFHi56kLfuK565DfX5rrBxS17zN5SDj3YNlhPOQagtGn uhyCk/jjg+/vMmPMrNwO3rFdPVmAnWgSRbEFDEkwjwgoX1U9lhcNi8JMLdQrfA2GVT03 B37jkgVgt+UOcRqdBKLY3L5rfT/JSMUM/pZ0zLTcy28U+Y4D2NiRCVXc0NieNv7Ib1Qc iCnATzzF9U9Wyl+2p3aTrfwp9ZLMLUQUPpOJ3bSAa1btj1qT3R2vcQeEdMsO89/AjrrB 8cMIRbDh80cSKTRVCXUYifIbu/YzD5td6Vz3MZVYnSo+yyTNf632h77QGLnLPPcv7e2K 7Xaw== X-Gm-Message-State: AC+VfDxO2APl7cCDReQLCYjPXOxcur2GVKl08fZme69VS5PwmbUHLDZi MKpqhXa1n5teSNfd3+GKtXA= 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 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" 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@int= el.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. =20 - 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; + } =20 The 3 masks, PR_RISCV_V_VSTATE_CTRL_CUR_MASK, PR_RISCV_V_VSTATE_CTRL_NEXT_MASK, and PR_RISCV_V_VSTATE_CTRL_INHERIT --=20 An old man doll... just what I always wanted! - Clara From nobody Mon Feb 9 15:59:22 2026 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 51EC2C7EE26 for ; Sun, 14 May 2023 09:04:53 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234003AbjENJEt (ORCPT ); Sun, 14 May 2023 05:04:49 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37338 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230051AbjENJEn (ORCPT ); Sun, 14 May 2023 05:04:43 -0400 Received: from mail-pg1-x52f.google.com (mail-pg1-x52f.google.com [IPv6:2607:f8b0:4864:20::52f]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 8ED2E1BE2; Sun, 14 May 2023 02:04:42 -0700 (PDT) Received: by mail-pg1-x52f.google.com with SMTP id 41be03b00d2f7-5307502146aso2631330a12.1; 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=IVTh4R3jtUWvddI4EJDi5QtZnIc09RSZuZkZ139sOmRjryZ0s1Nz+zmcrgwc3xCm7C znZlA1/G2hfx+jgdxtuj9ypOanVE9gGZx7CLr8kWfFCyYTLQp9jadO3ybWQ66i1Nt5c7 vBpbCP0Qua1iOqbZiZv/wMlUKif90DGS2fkrbcEmnYHIc8mlg9R07ItqQbRtzKMcg56c k1k/qPu3rB6y14oTraN8dZxJCwbU86JGJIuLNUMBQ6IgR9z27ivmYdMAFeG/mqK5CzDG DOtH38nFlN9qLNp20Ak81q+KV+yKsWOWuybWexPREexfUrRcl/XJZCGlfNTptQTcJlsk U2PQ== X-Gm-Message-State: AC+VfDyv8fYYhXybBkvYIbiHI9ICSKouDz39rTcipVt7oGGOEFKSvZHP 2IZCGjQ4IHaSpX9kjDxIWjc= 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 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" 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: =20 -prctl(PR_RISCV_V_SET_CONTROL, unsigned long arg) +* prctl(PR_RISCV_V_SET_CONTROL, unsigned long arg) =20 Sets the Vector enablement status of the calling thread, where the con= trol argument consists of two 2-bit enablement statuses and a bit for inher= itance @@ -89,7 +89,7 @@ prctl(PR_RISCV_V_SET_CONTROL, unsigned long arg) * Every successful call overwrites a previous setting for the call= ing thread. =20 -prctl(PR_RISCV_V_SET_CONTROL) +* prctl(PR_RISCV_V_SET_CONTROL) =20 Gets the same Vector enablement status for the calling thread. Setting= for next execve() call and the inheritance bit are all OR-ed together. --=20 An old man doll... just what I always wanted! - Clara From nobody Mon Feb 9 15:59:22 2026 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 0211CC7EE2E for ; Sun, 14 May 2023 09:05:01 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229763AbjENJEz (ORCPT ); Sun, 14 May 2023 05:04:55 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37342 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231296AbjENJEo (ORCPT ); Sun, 14 May 2023 05:04:44 -0400 Received: from mail-pl1-x62d.google.com (mail-pl1-x62d.google.com [IPv6:2607:f8b0:4864:20::62d]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D88FF1BE3; Sun, 14 May 2023 02:04:42 -0700 (PDT) Received: by mail-pl1-x62d.google.com with SMTP id d9443c01a7336-1aaf91ae451so108644195ad.1; 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=If+52pfrtTrV+ky/Y3RTSAXIaki+xiROoU2TMamQhWlZaetA3mJosu+4OGM8kLtE02 BgL/P4s57EHsZ4YIsj7T+eHt1tLK10Lv0lyq3SvDcRGI15cqUtEBmtajq/RmAvbLXbB/ KLGuaP05NgoTthZKWv0V357+mNBTuIHXezwTlyujEsx3ljWKYZfVdFafCA/yPHwf26o5 0wbPs1mCTQI2EPts1ugatF87dhEIByuKh9qjjGm5Xq27AlYD8hSQB5BBp+8cHuDrzqsn qHZyckvn0aWo6TM2+r4e/bnxftcrEP2CjfRSG0qW6bKxskwxGJHBImP7PHbNZ3UkdLi8 0C9w== X-Gm-Message-State: AC+VfDzOgjSTMOPVvORUnQep3mXO2F1MoJtTMnQVGdYrQxY/S1/lrXnc lSLhKvKZIFlWVZz+RWPIKCE= 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 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" 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_INHE= RIT. This setting persists across changes in the system-wide default = value. =20 - Return value: return 0 on success, or a negative error value: - EINVAL: Vector not supported, invalid enablement status for curren= t or - next mask - EPERM: Turning off Vector in PR_RISCV_V_VSTATE_CTRL_CUR_MASK if Ve= ctor - was enabled for the calling thread. + Return value: + * 0 on success; + * EINVAL: Vector not supported, invalid enablement status for curr= ent or + next mask; + * EPERM: Turning off Vector in PR_RISCV_V_VSTATE_CTRL_CUR_MASK if = Vector + was enabled for the calling thread. =20 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. =20 - Return value: a nonnegative value on success, or a negative error valu= e: - EINVAL: Vector not supported. + Return value: + * a nonnegative value on success; + * EINVAL: Vector not supported. =20 2. System runtime configuration (sysctl) ----------------------------------------- --=20 An old man doll... just what I always wanted! - Clara From nobody Mon Feb 9 15:59:22 2026 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 3ECD0C7EE2D for ; Sun, 14 May 2023 09:05:01 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234243AbjENJEw (ORCPT ); Sun, 14 May 2023 05:04:52 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37344 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232258AbjENJEo (ORCPT ); Sun, 14 May 2023 05:04:44 -0400 Received: from mail-pf1-x42f.google.com (mail-pf1-x42f.google.com [IPv6:2607:f8b0:4864:20::42f]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 4ECE01BE5; Sun, 14 May 2023 02:04:43 -0700 (PDT) Received: by mail-pf1-x42f.google.com with SMTP id d2e1a72fcca58-6439b410679so7643161b3a.0; 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=d+Rcvp0AGtFx12UTV+ocm/817rItOMXWu+zNtGyPJvDiq0tIi+zbAww1JGomopHeg4 IYnCUBowbwqz069e9zhiDE6npRK4CDC09TECFCsnqmsBDh5/0BOqJ1Nk0aE69y881MpD C70Ia31L+Bi18VXDNgz5xi1ClDr1rcTHw7lok+gmpaCNV3BrzibEhyi28FWev4mBVqub M/Fjfw0yEIJd2BmYvdlH5RXktem+RO8PNoVLFTwKhGqK3Xe9HvPKQ4K4Ss4+CEQrXItr uHzJamPI6+D3IxgZGkzMmkMZHWKIK8pWl6bFfmzn4PE5Vu0zzYhmcaA5zGmDt1tr8yVh qebA== X-Gm-Message-State: AC+VfDymO/HxFwjUnRkO+9T3IK6chZuPQ8jqJAzePWsuZKLIJz8yPSwr A1tkBeGjEpChMan1swi/HHM= 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 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" 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) ----------------------------------------- =20 - * 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: =20 -/proc/sys/abi/riscv_v_default_allow +* /proc/sys/abi/riscv_v_default_allow =20 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 va= lues + are: =20 - 0: Do not allow Vector code to be executed as the default for new proc= esses. - - 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 pr= ocesses. + * 1: Allow Vector code to be executed as the default for new processes. =20 Reading this file returns the current system default enablement status. =20 -* At every execve() call, a new enablement status of the new process is se= t to - the system default, unless: + At every execve() call, a new enablement status of the new process is = set to + the system default, unless: =20 * 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. =20 -* Modifying the system default enablement status does not affect the enabl= ement - status of any existing process of thread that do not make an execve() ca= ll. + Modifying the system default enablement status does not affect the ena= blement + status of any existing process of thread that do not make an execve() = call. --=20 An old man doll... just what I always wanted! - Clara