From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 61E1626A095; Tue, 1 Jul 2025 08:57:18 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1751360238; cv=none; b=tkWqRN8PhmfnKkUjQVmQNFMSJvM+nC70oIXrd7VtyOG2BZRzHHCmrGepQiEv4J1xeszuOAa6Evb/aQw2IXJ6iHjRpznZxjQlFT3YJ72mGitVc21+G4qtu7W3MEwGR/RKg5fxSWTZ+glZ0TcTA+nAsaQn7zTGH92x8OBggbTYRbE= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1751360238; c=relaxed/simple; bh=vmReX47mqCLgmmgZzbo16/Xw5onF/bS5D530hw5Anx8=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=O1+OZkiYQKZYn9o6kN+Ri6Mxr/qGeOpEoG53O45Hi0mjrkSYr3iBwoiNNqRLWnioaiV8i0JMvo+fXIEmFPdG/atoNogJ/x1XvhyPi8G1psNUhpgvaZwGIHLHkcG8km+C09AAs6No6+PKqmZ6+p2puP5l+cFqetzPRzRLZiN5BWc= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=TOPCN3lE; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="TOPCN3lE" Received: by smtp.kernel.org (Postfix) with ESMTPS id 1194EC4CEFD; Tue, 1 Jul 2025 08:57:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1751360238; bh=vmReX47mqCLgmmgZzbo16/Xw5onF/bS5D530hw5Anx8=; h=From:Date:Subject:References:In-Reply-To:To:Cc:From; b=TOPCN3lEFa9Pb04mHDONYZhWUehnQy/XLyKk96s791L+h1USqQRyA4hc3cG4FFZLw sf3uPeYnAvcMKvOb216bOzvNrcvmLCMrH2lyEaEo6Iy5TTOGiuPEAn/MwnxflhreUc gsr5GkJs9DkNf+FEFvJH7guc9x32yUpBk8hbuhpYbxGPI0JgQeItVYy87Hj8hlkUiq o1Y2UhDJh2V5cA8O+mOsyUUDIoP2d3w6hWKn70KbmIAK9ol9eY6rw773VduO6dpJCN 4xCAjqx3GmCJmTDmMBFgf0xe4HTOoHJvZsfo51WdGgZz/AaHPkOx3o6oxBNH7xzjuV Egk5Rs5DlIP6Q== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id 0951BC8302F; Tue, 1 Jul 2025 08:57:18 +0000 (UTC) From: Joel Granados Date: Tue, 01 Jul 2025 10:56:47 +0200 Subject: [PATCH 6/6] docs: Downgrade arm64 & riscv from titles to comment Precedence: bulk X-Mailing-List: linux-doc@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20250701-jag-sysctldoc-v1-6-936912553f58@kernel.org> References: <20250701-jag-sysctldoc-v1-0-936912553f58@kernel.org> In-Reply-To: <20250701-jag-sysctldoc-v1-0-936912553f58@kernel.org> To: Kees Cook , Jonathan Corbet , Paul Walmsley , Palmer Dabbelt , Albert Ou , Alexandre Ghiti Cc: linux-kernel@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-doc@vger.kernel.org, linux-riscv@lists.infradead.org, Joel Granados X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=2491; i=joel.granados@kernel.org; h=from:subject:message-id; bh=vmReX47mqCLgmmgZzbo16/Xw5onF/bS5D530hw5Anx8=; b=owJ4nAHtARL+kA0DAAoBupfNUreWQU8ByyZiAGhjoutgafknIe4uDW/tuqngY3301IDb7siVv D+Ppdv3MEHYgIkBswQAAQoAHRYhBK5HCVcl5jElzssnkLqXzVK3lkFPBQJoY6LrAAoJELqXzVK3 lkFPIqYMAIw2aha8NP8P8uQJTcXrqi1uSeSVBitGs7JzTKKQH03EcYNNRzfXlq0GvfmC694C68K 589+Rg8OmUJyr8RY9P8gRir1sNTcfD377eXgw2JBiBuNYo3sjcy9AH74ytTRTmuKtgkfOgqLbQB L1t0O/8qy5g0lVo3UboWOEmAj28SisTNub/9IDCBLn/3YxVfeqlId3k6HJgp3E4Shr1Va8fwDHD DUGoZ45iqIKT4ZNSDZcTuZpo+kLYFF+Q1zDWD+vXV8BeBRbOblYB9Fq5dKKWWq4elk5K/LhMdyB ZwDosse7CN63dW+gi8zKu8wD1CcLQ7gBvQqcouX51yE/HMRlqiyIY8vvPhlOdzILOg7yZxdl5fh K5Swo/tIBbzJh5pPNb5A9s0wLS06nyLLFa7rKscBeWVqhHqUF0lU+Qbtd/wgiEowZt3jRumBlya qrzjEEq6B/3sp3UaVJUsfXH1j+4LAyb5+TgCSP4stcZ/rTULBR8x2KOtuq09XuOXDpQRa13oMI7 lk= X-Developer-Key: i=joel.granados@kernel.org; a=openpgp; fpr=F1F8E46D30F0F6C4A45FF4465895FAAC338C6E77 X-Endpoint-Received: by B4 Relay for joel.granados@kernel.org/default with auth_id=239 Remove the title string ("====") from under arm64 & riscv and move them to a commment under the perf_user_access sysctl. They are explanations, *not* sysctls themselves This effectively removes these two strings from appearing as not implemented when the check-sysctl-docs script is run Signed-off-by: Joel Granados --- Documentation/admin-guide/sysctl/kernel.rst | 32 +++++++++++++---------------- 1 file changed, 14 insertions(+), 18 deletions(-) diff --git a/Documentation/admin-guide/sysctl/kernel.rst b/Documentation/admin-guide/sysctl/kernel.rst index dd49a89a62d3542fa1a599f318dff26589e1d57b..c2683ce17b25821559d0c04914aea360440c7309 100644 --- a/Documentation/admin-guide/sysctl/kernel.rst +++ b/Documentation/admin-guide/sysctl/kernel.rst @@ -1014,30 +1014,26 @@ perf_user_access (arm64 and riscv only) Controls user space access for reading perf event counters. -arm64 -===== +* for arm64 + The default value is 0 (access disabled). -The default value is 0 (access disabled). + When set to 1, user space can read performance monitor counter registers + directly. -When set to 1, user space can read performance monitor counter registers -directly. + See Documentation/arch/arm64/perf.rst for more information. -See Documentation/arch/arm64/perf.rst for more information. +* for riscv + When set to 0, user space access is disabled. -riscv -===== + The default value is 1, user space can read performance monitor counter + registers through perf, any direct access without perf intervention will trigger + an illegal instruction. -When set to 0, user space access is disabled. + When set to 2, which enables legacy mode (user space has direct access to cycle + and insret CSRs only). Note that this legacy value is deprecated and will be + removed once all user space applications are fixed. -The default value is 1, user space can read performance monitor counter -registers through perf, any direct access without perf intervention will trigger -an illegal instruction. - -When set to 2, which enables legacy mode (user space has direct access to cycle -and insret CSRs only). Note that this legacy value is deprecated and will be -removed once all user space applications are fixed. - -Note that the time CSR is always directly accessible to all modes. + Note that the time CSR is always directly accessible to all modes. pid_max ======= -- 2.47.2