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: 93662 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:b0ea:0:b0:3b6:4342:cba0 with SMTP id b10csp6200360vqo; Sun, 14 May 2023 02:18:07 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ5AVSzXFh68cFLEGsuK5yRqjoVedEGiXoTlBamK6O2FW3XJ6ZCcYl0j3R4VaAnuw9LkS4a0 X-Received: by 2002:a17:90b:380e:b0:252:f7b1:943f with SMTP id mq14-20020a17090b380e00b00252f7b1943fmr482833pjb.24.1684055886670; Sun, 14 May 2023 02:18:06 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1684055886; cv=none; d=google.com; s=arc-20160816; b=dpbX8XnyjpjxzNeO264vxUEEznKmT57IIR8LaPOpJV/GN74wHrsMhrrm/CX1OMpdXO BVORfe7UKOTHZQY0TZN0svLkZcj1EM+5Q1t/DK6fvOwh9gygj+sPw0LtKtjXSp8N/b1R S9cEt3K4HDoabU5ggPsKf3AfHvWIDGrEOUwjzVc75XcxrjX0ya1wAmBpdcZ3P0vGh17R F3o0+GQ8RkCBCRDzOcATxsdNyCrU2PQylex1ygbVmjVRcN6RLVSgDCdYUtvD3oKVJB2E pm+qKWpXoTtPcqTbQI0IMTt5gC0UCmhDvN/D1TzDXHX1Uu8r7cE48i21MolevEx2+U0/ DRQA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=usTUzbJN3/c9qoBFyD+eiQ3LKf9ePyuHk2BoTbJ/pEs=; b=Uc32NH3WmIB+ofPhNCJfRZm/B0ZMrtnjeBY+noREfx9TVxzdY2lQN3Vhv2kEdfO81A DggMxQxtzAwyNgYddeHTEo1LlNFHc/Vrg2o2KkMPNdoPW4nwjHokGqZwCoZHcuQ3Ebgt AQTCLGglIxjDsu+37FhhTtY3TegbzVYMZLJy2aI7njiMYq9DA0UMVlR9DerfKcJpx+VO IIz6+jiK0hMZBF2GXGGSetXF85kWaScuk5yZlupyRvNic/apNL3qBPZPw1uZubBI6Sjr mVEHv7g3AUam+MgZrl6brZ/WAFrvoQcityNbBeQkM+wq1MEALiXtAdDyn7owYKaclJ8z CkTw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20221208 header.b=Tw1gGElB; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id nv1-20020a17090b1b4100b0024e3527e8f1si29972114pjb.60.2023.05.14.02.17.54; Sun, 14 May 2023 02:18:06 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20221208 header.b=Tw1gGElB; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234425AbjENJE5 (ORCPT + 99 others); Sun, 14 May 2023 05:04:57 -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-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-Spam-Status: No, score=-0.6 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM, RCVD_IN_DNSWL_NONE,RCVD_IN_SORBS_WEB,SPF_HELO_NONE,SPF_PASS, T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1765860585365460339?= X-GMAIL-MSGID: =?utf-8?q?1765860585365460339?= 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: 93661 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:b0ea:0:b0:3b6:4342:cba0 with SMTP id b10csp6200150vqo; Sun, 14 May 2023 02:17:27 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ5PVOu6DP+3Nau8l8Bq4eaEY5hdNLm1k5gjHlS1+hoIXv5DDS1WkGBJ3weMTrp+aEnTvUs4 X-Received: by 2002:a17:902:e542:b0:1ac:2f98:e94d with SMTP id n2-20020a170902e54200b001ac2f98e94dmr36923292plf.67.1684055847112; Sun, 14 May 2023 02:17:27 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1684055847; cv=none; d=google.com; s=arc-20160816; b=yKRWk6oKUjDcfDaGVyNXRv778dvbSI2aApT+3QAu7MuRaAOJiwvH2kA9HKhSj83nbs 8NYfWm5lghV0f/cZ8QwecXgAwgK9qD/OXPnmNH67SMrvn/A2XcWg/4parbjGc6LD4lwn Nzn5JJNoeX98vug+UIAsGC/GpFKCkKU37o6paw1MaEC/DlAZDPcHFDwpwW4JicqlrEj4 5Z/U/vCqklGPOFgJROtu6KotZkj/2BV5QqZFwGC5vrmeZgmj/ciOq6u4n3ERxH0N05cl aNL0J2kj42kSgZIz9vyyF5h8Y68tLwrKrADaXXHhMXLqxIyrRxtRhV9qix+7ZAaHcEFK vcfw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=3VswhOVIM6N9lUQ5IbUMqB4CktfYicQQNL7zwxJA2o0=; b=t7YaonS74iIfTGlXHKfX2CjFr64hUAb6YlS3DLOF8+HL+YLYVy9Z270q4BUMgryA37 kEa3nOGICZWBsbQdpohTO3RvLQG1MTF+jR/ojDCRtVvLFanfEddgEcCiwjg++GQ6yCO/ 2RBVHrDZqGmvA9UjDbZJ/kdR+lNFcNcllj3ZPDaKdW5dG87NSwQeQTuQyTLGaPGDxP0y GfikPtqfqn6b7wy5CdmbBl7Tb1R8Clsgpwfh8wgYg6Xro6cUmkdd/dbY7FSLMzc6W+ew qwYhukFyYjmMr1Rb4Ax4asiW17VucHB4b9qbcDunS8Cr3JwDk7sTbPgWlUy7y6IIrXT6 cEPA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20221208 header.b=gyDuam61; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id jd5-20020a170903260500b001ab22e28a6csi12827196plb.216.2023.05.14.02.17.14; Sun, 14 May 2023 02:17:27 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20221208 header.b=gyDuam61; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233748AbjENJEr (ORCPT + 99 others); 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-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-Spam-Status: No, score=-0.6 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM, RCVD_IN_DNSWL_NONE,RCVD_IN_SORBS_WEB,SPF_HELO_NONE,SPF_PASS, T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1765860544152493623?= X-GMAIL-MSGID: =?utf-8?q?1765860544152493623?= 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: 93659 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:b0ea:0:b0:3b6:4342:cba0 with SMTP id b10csp6199971vqo; Sun, 14 May 2023 02:16:57 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ4nXoOYJd6Oxlo2d7Q8tpchv2cy+Nv9YuuH0vW8MNfcsSLWW0Q8rCg47CLdjN46oY8M7SH1 X-Received: by 2002:aa7:88ce:0:b0:645:6142:7f5a with SMTP id k14-20020aa788ce000000b0064561427f5amr30831886pff.3.1684055816788; Sun, 14 May 2023 02:16:56 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1684055816; cv=none; d=google.com; s=arc-20160816; b=eULy4zQbndBK1NST1HJ+Sj0sYf5qPF3SyEgFsTPjZzsppKD7VDd/wBFg3MGTbUB4I9 RUs5AFvfy9w1Oz1DY7OHJbw/IHm6grwCJRLtMays2qU4lf2kZPRsiFTQG0bVhWoO6maa CA3m7BveQK/Mbr++j98EwBCyBmX6cPP7RJgqbCCOrmYckI+wwCAerDW1vgpiSxr5Hn1+ fAfQrc8oi4ofp8p+sT/dKklE1HiSqDNmGVZKwLdq9w9rqMJOItDj0sLGb3lz4C0OIAfO dzjyTLEqiLkX/L5kmLZeDg4i33aJR5tdmwCwYdEl45yVZ47UH0zbgUgMXnUlZBB4d27f pLgw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=qIanyhJS88Q7RfVNqljO8EtKKIvGna+18p2AMpDpX+U=; b=jiffRYw5JQCmDqWY+BdbT6Sjg4JHjDrB+ziE3cRjazGsc7Y9aDiHa1jJkFgBJzgqRN IBvfQGBWkvz2wxSSOyamjVrPL12FLG4sGVRy4r64SJuT79pxy9AleL34B/xSEGutBOl1 bcPXrIo7zv4rze4xWerqa3X+FlJot7avyX4MoTZEKuw45yoweLqAuQ89LNAb4rDeMXt1 fGFi1rFPZnS3dtxqZxEGT+/jwC9dWUgiSJzdNq7edqo9htoSAfm62BD3S8nEeAwMAINS RkEPF82h8mCMgUvbE6AtdZS4Sz/mi3TiIzFEr7qBBxVKQ5pVB16pXHrsoAWxyBEHZ5H1 AV+w== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20221208 header.b=CgLdpdVK; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id b12-20020a621b0c000000b0064b03298c61si2705216pfb.84.2023.05.14.02.16.41; Sun, 14 May 2023 02:16:56 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20221208 header.b=CgLdpdVK; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233987AbjENJEt (ORCPT + 99 others); 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-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-Spam-Status: No, score=-0.6 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM, RCVD_IN_DNSWL_NONE,RCVD_IN_SORBS_WEB,SPF_HELO_NONE,SPF_PASS, T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1765860512258242639?= X-GMAIL-MSGID: =?utf-8?q?1765860512258242639?= 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: 93665 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:b0ea:0:b0:3b6:4342:cba0 with SMTP id b10csp6202205vqo; Sun, 14 May 2023 02:24:15 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ5mZ+JIR8dHZZfE/rsytevrCJY0JwcFibeiU5Nn9S01Yumwipzsk1XfaQPJYk2o/Ez3P8zq X-Received: by 2002:a17:902:7295:b0:1a2:6257:36b9 with SMTP id d21-20020a170902729500b001a2625736b9mr29533934pll.31.1684056255309; Sun, 14 May 2023 02:24:15 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1684056255; cv=none; d=google.com; s=arc-20160816; b=CPDbWfz0yWjWepo1+7BxQVieeAvADCpkCEAli8XmqqFuUYxovJapzaCV1wE9jNDZs2 fSm5Vwllzvca7127NsPeadYNC2DSVv51j6+tmGijgsYPFftcrGXGUFnqcDoHCyE6j7nF +7D57qHXqPLley/sUHChJTnh/97q+y7W+vXZWaZ/p+KwasaAffWGdAApwJbqWzkSIn8b v+AWyvH0I5DXJftAtLsQ4xTeOQErAREBpihmYlEXtu7eynXAYTtjfOJiX3/fX80p73Fr +HC6lQubtrgKIoqUzbxp4wD5JPQAVLB+PPXoXGN42oR+qvVvhYMr35OOD0rss9qln+K8 Y+Fg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=MlYIG+wyBwHIZ6Ig5rNTc1U+7HEnxpjzPz2HnP+gqKM=; b=VfSeh6/G15QK3phQeW/cTsNOeVSawfk/N8/QBpDo/YnVOkocZE5P4WXjYUEzZTkZ2S 59On5ho7LYq1nPbuPGeG4jiLgZ4taraw/OA7pL2KmCgKCZAraGyZvm0f2iaoLYi8L8TY c3iIeBuIWRnEA4FL81X7omF6wjtVmKu4NFjtv+Au+ySCPI2HNtIjUGU98zjqK8xS0wjR us0PUmadJIVf0zCZnJHkKMWwfqmSDxE8arv8v2Pd9F09dmlGgZSbYZ/6cQp1f5gPKBmG Ja24mT7FBRjqCxu3fTQf0hW+F5XF1KaTKLmFG3THdMQ8z4hnQ/zYUX78eHKmhBSqBDQW wsLQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20221208 header.b=sxfLoTD0; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id z5-20020a170903018500b001ab29e00303si12102731plg.426.2023.05.14.02.24.01; Sun, 14 May 2023 02:24:15 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20221208 header.b=sxfLoTD0; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234492AbjENJEy (ORCPT + 99 others); Sun, 14 May 2023 05:04:54 -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-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-Spam-Status: No, score=-0.6 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM, RCVD_IN_DNSWL_NONE,RCVD_IN_SORBS_WEB,SPF_HELO_NONE,SPF_PASS, T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1765860971957786084?= X-GMAIL-MSGID: =?utf-8?q?1765860971957786084?= 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: 93664 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:b0ea:0:b0:3b6:4342:cba0 with SMTP id b10csp6200506vqo; Sun, 14 May 2023 02:18:38 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ7vhNgDGWcLndXeTECiiS2CBmRP6W/uWWnYexarYeHF6WAiClnT5KPUh8MQZFjt4eEqIycM X-Received: by 2002:a17:903:258f:b0:1ad:bfba:9c2e with SMTP id jb15-20020a170903258f00b001adbfba9c2emr11687751plb.54.1684055918410; Sun, 14 May 2023 02:18:38 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1684055918; cv=none; d=google.com; s=arc-20160816; b=nSEsWGTIqo9nLBEhPAWO67InXpZpwHSlfyOQc49Dev8alElOmB/EuQ9OqkLX5nrEY2 +gRrVxEEg7FmAFbSXBu037uYE8L4BBkjA7F4czAnVy7TlkaAJGGCcXrqbCDpBJ4YsMtk /rvYyvkR+xvcyzwOO9yIX3zB45Z4kZTXfSLIJimYMONxmIfCgnOcerXjxOmhFkZLo8sl 2rjVbyPkmunKy+EM9uB8WZVPXB330izC0YHV6ZIkUBgCEFjFA2O3DGvV+g4m/HA9wc5s 85uBDwtKPFHUFW4iTjFwOlI7VIz04I+QejU7HrnHJqcada/fbt9KzjjxLbddVmUafSFB Z9Iw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=tWsNucItL3Ir8RVSxlrmAT54pJTVw6Lt+rodKw+CzPs=; b=IQdymqxNjoep9NZCldvIErDxVfbmh7CPjW5qegESSPVQuwijRpsQnHSYGCaO6t7eLE 3fRaZ5EwTtmCOBtsyqtgVELcyeX815jgDLrk5dH2kTO6749MNou/vO5yRTpMqVmFodwH VEn3uraIOgvr6jxPEo4S21rocmyr4xJTo0Mhv56pLLLXCJZA4D7LVS/ezd3ElgtRE2Su HVRJVXWkiLNhYHoMKUqCzU9fe1yNJ5mwS9VZc7rp3czMW52M1SYApIda3bKpeFVFbgXl pDX3cikYjlBCNFg6v1sWt3/bDWDNenN3lQprzJbFGXt9jX92VIeQYjdxxEA+G9NXrq8Y YZOQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20221208 header.b=FvWwMcL2; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id t11-20020a1709028c8b00b001ac3f3cc15fsi12626251plo.275.2023.05.14.02.18.25; Sun, 14 May 2023 02:18:38 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20221208 header.b=FvWwMcL2; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234058AbjENJEv (ORCPT + 99 others); Sun, 14 May 2023 05:04:51 -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-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-Spam-Status: No, score=-0.6 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM, RCVD_IN_DNSWL_NONE,RCVD_IN_SORBS_WEB,SPF_HELO_NONE,SPF_PASS, T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1765860618757974801?= X-GMAIL-MSGID: =?utf-8?q?1765860618757974801?= 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.