From patchwork Fri Sep 15 17:28:11 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Shiju Jose X-Patchwork-Id: 13387304 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 kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id BFDA6EED61C for ; Fri, 15 Sep 2023 17:29:11 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 80BC56B0364; Fri, 15 Sep 2023 13:29:09 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 7E26B6B0366; Fri, 15 Sep 2023 13:29:09 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 635CA6B036C; Fri, 15 Sep 2023 13:29:09 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id 2DBE56B0366 for ; Fri, 15 Sep 2023 13:29:09 -0400 (EDT) Received: from smtpin27.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id 058691207AC for ; Fri, 15 Sep 2023 17:29:08 +0000 (UTC) X-FDA: 81239517618.27.F90D506 Received: from frasgout.his.huawei.com (frasgout.his.huawei.com [185.176.79.56]) by imf24.hostedemail.com (Postfix) with ESMTP id 1510D18000D for ; Fri, 15 Sep 2023 17:29:06 +0000 (UTC) Authentication-Results: imf24.hostedemail.com; dkim=none; spf=pass (imf24.hostedemail.com: domain of shiju.jose@huawei.com designates 185.176.79.56 as permitted sender) smtp.mailfrom=shiju.jose@huawei.com; dmarc=pass (policy=quarantine) header.from=huawei.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1694798947; a=rsa-sha256; cv=none; b=Af5CMYEonxbauKer6pP+IfWfbpg397q3fs+b/0cizUHF8BhLOfWng55m5ZfZ13o2WBL9g8 io+CPp4qVvR1NYqQrHypgh7RMzcVHZKtEk1oA1bym+spXVyCugh+pQM+SI5JwalwHT1umT Z2FsnV0y2bfw6dy/l6Uov0+z59reluI= ARC-Authentication-Results: i=1; imf24.hostedemail.com; dkim=none; spf=pass (imf24.hostedemail.com: domain of shiju.jose@huawei.com designates 185.176.79.56 as permitted sender) smtp.mailfrom=shiju.jose@huawei.com; dmarc=pass (policy=quarantine) header.from=huawei.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1694798947; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=T7oaJA45CCb4UP4mn8TvsGwQjEz3z96hQRobhJyZbCw=; b=Om39G9pminBtatXk0EzdG6949kFWOzWU7MwERTAKHLkascOFBKAIuPw7Yx1KHefMxSItbj g6CMuR3PJRa7NCElZZCkUCUWol4Xp/jYN7hL0UdphXxjbJtlqexkSM4p4+27tFtv8ZHKBf txKX+IKZ2U0ecNPJFz3ILrLAe20n/Y0= Received: from lhrpeml500006.china.huawei.com (unknown [172.18.147.200]) by frasgout.his.huawei.com (SkyGuard) with ESMTP id 4RnLkc2nYbz6K6LG; Sat, 16 Sep 2023 01:28:24 +0800 (CST) Received: from SecurePC30232.china.huawei.com (10.122.247.234) by lhrpeml500006.china.huawei.com (7.191.161.198) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.31; Fri, 15 Sep 2023 18:29:04 +0100 From: To: , , CC: , , , , , , , , , , , , , , , , , , , , , Subject: [RFC PATCH 2/9] memory: scrub: sysfs: Add Documentation entries for set of scrub attributes Date: Sat, 16 Sep 2023 01:28:11 +0800 Message-ID: <20230915172818.761-3-shiju.jose@huawei.com> X-Mailer: git-send-email 2.35.1.windows.2 In-Reply-To: <20230915172818.761-1-shiju.jose@huawei.com> References: <20230915172818.761-1-shiju.jose@huawei.com> MIME-Version: 1.0 X-Originating-IP: [10.122.247.234] X-ClientProxiedBy: lhrpeml500001.china.huawei.com (7.191.163.213) To lhrpeml500006.china.huawei.com (7.191.161.198) X-CFilter-Loop: Reflected X-Rspam-User: X-Rspamd-Server: rspam06 X-Rspamd-Queue-Id: 1510D18000D X-Stat-Signature: iyxr9du9tcxoxj9yb698w1k4wygcybhc X-HE-Tag: 1694798946-271825 X-HE-Meta: U2FsdGVkX1+Ul/l/FKFO/sFqmrmzpRGgDmZeuYRA33m9Fgi4hA7NiY5ylieDthYGeQw9MxoFoQlIIt7nZ9RESdQyoKnY/24NU/WM+g1eWYso5S8cRFSu8quzxPpLbwbN/r7iKMze8zGBoKtt4d/YaU5gtnFMw5goaEEpb4978dKFIoD1qIpwSpM2r+U20fBMzyXE328qFixkjp/fK2zEhm3VKyk6bEJ+FIEduuMhiVXFV3hcGxCbgC9Bg/6ov9F1t1H/3/dJV2e/j1zYHrvhL0sz2BKa0qHa7Zoq2JKI7gAXI6kbF4XhXk7TFmeJbNoRTnZjY4r67zgV8IF8ERO7j2KptEIJtMCW06WSs1cuX3hPbYTFYCwOQS1btg1jZ454ZWR9JlFk7UVLEulxBgazECPZtRH/S6gUvndIU/AB/z6Y+IZxOQUxDoQH66ImgmymB34etmKeTTmLalqKK0IohsbVGkHS1ojGOkSAfeajugK+f4S5mnxLUKD6jIeWd6Jj9MrogtvtCwtefOc22780S/EmcuaHe7LbKN6conO+08BBiMzhwvwQxLfYplzasUpvO3Jp1zJ0DJlHvplrBUH8WLzl8JtVAwqAhg3vutSZ+1iSFuE0yPnxGInqaO9uDVr8TMh8vEmLxWPvd+jd9ZmuG1OLLwXCnkx+FPs79CIlDR0KiUMusL9V/1BmjMRdsM8kFlBRoRh2GFgZgNBrN1CPrRuOXHD6296FrvPVRh4Ta43uzM/KrYPoGxxmyGVhjV7Z3pBSE8y4ZdY5SdhpxsBsNe0AThZBBgT8UdSW5Tb5jR7WZgh7Fn6eeLJ62h8J+0EtHuzxE8yVUAoSRUY9pRK6d62FCEE6VB+hxT9Vzt70psh9wyv4N/OtZjauNRw6sl5EO96YSePMwwHBaZScGR982x0oyHrkda4XTlWE9u7AtVIMpunu+ScAj44MsPo1rqM+npYK++pZgOf+HWKLCY0 btlibjc8 gskEC0b4qgXC8fAEhCPx8dleY31371x1+8XEUs8MwGVovE8vULoQmtx4y9/Nh5wI1IdmFYUD2UKzXGNlxUNloo7LS4x1Tu2TzUzDi1wAZHsM227Z1rn2D1GXKzDAa80yWmnWZPnvRXkw/k230eZ3C/z/oq+ghcuGWDKOjW+dOywx0rBHLaWpu1lbCxUx+KhIJHQjw33zqNoI+Yi4IUJtlM6uVSjIJqWJrQsAQ X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: From: Shiju Jose Add sysfs documentation entries for the set of attributes those are exposed in /sys/class/scrub/ by the scrub driver. These attributes support configuring parameters of a scrub device. Signed-off-by: Shiju Jose --- .../ABI/testing/sysfs-class-scrub-configure | 82 +++++++++++++++++++ 1 file changed, 82 insertions(+) create mode 100644 Documentation/ABI/testing/sysfs-class-scrub-configure diff --git a/Documentation/ABI/testing/sysfs-class-scrub-configure b/Documentation/ABI/testing/sysfs-class-scrub-configure new file mode 100644 index 000000000000..347e2167dc62 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-class-scrub-configure @@ -0,0 +1,82 @@ +What: /sys/class/scrub/ +Date: September 2023 +KernelVersion: 6.7 +Contact: linux-kernel@vger.kernel.org +Description: + The scrub/ class subdirectory belongs to the + scrubber subsystem. + +What: /sys/class/scrub/scrubX/ +Date: September 2023 +KernelVersion: 6.7 +Contact: linux-kernel@vger.kernel.org +Description: + The /sys/class/scrub/scrub{0,1,2,3,...} directories + correspond to each scrub device. + +What: /sys/class/scrub/scrubX/name +Date: September 2023 +KernelVersion: 6.7 +Contact: linux-kernel@vger.kernel.org +Description: + (RO) name of the memory scrub device + +What: /sys/class/scrub/scrubX/regionY/ +Date: September 2023 +KernelVersion: 6.7 +Contact: linux-kernel@vger.kernel.org +Description: + The /sys/class/scrub/scrubX/region{0,1,2,3,...} + directories correspond to each scrub region under a scrub device. + Scrub region is a physical address range for which scrub may be + separately controlled. Regions may overlap in which case the + scrubbing rate of the overlapped memory will be at least that + expected due to each overlapping region. + +What: /sys/class/scrub/scrubX/regionY/addr_base +Date: September 2023 +KernelVersion: 6.7 +Contact: linux-kernel@vger.kernel.org +Description: + (RW) The base of the address range of the memory region + to be patrol scrubbed. + On reading, returns the base of the memory region for + the actual address range(The platform calculates + the nearest patrol scrub boundary address from where + it can start scrubbing). + +What: /sys/class/scrub/scrubX/regionY/addr_size +Date: September 2023 +KernelVersion: 6.7 +Contact: linux-kernel@vger.kernel.org +Description: + (RW) The size of the address range to be patrol scrubbed. + On reading, returns the size of the memory region for + the actual address range. + +What: /sys/class/scrub/scrubX/regionY/enable +Date: September 2023 +KernelVersion: 6.7 +Contact: linux-kernel@vger.kernel.org +Description: + (WO) Start/Stop scrubbing the memory region. + 1 - enable the memory scrubbing. + 0 - disable the memory scrubbing.. + +What: /sys/class/scrub/scrubX/regionY/speed_available +Date: September 2023 +KernelVersion: 6.7 +Contact: linux-kernel@vger.kernel.org +Description: + (RO) Supported range for the partol speed(scrub rate) + by the scrubber for a memory region. + The unit of the scrub rate vary depends on the scrubber. + +What: /sys/class/scrub/scrubX/regionY/speed +Date: September 2023 +KernelVersion: 6.7 +Contact: linux-kernel@vger.kernel.org +Description: + (RW) The partol speed(scrub rate) on the memory region specified and + it must be with in the supported range by the scrubber. + The unit of the scrub rate vary depends on the scrubber.