From mboxrd@z Thu Jan 1 00:00:00 1970 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 4FD81CCF2DA for ; Mon, 19 Oct 2026 07:56:24 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From: Reply-To:Content-Type:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=pM4/Gj0Cb3LUXcp9sTVrpS/0rQM/R6r7247NHEq1kfo=; b=aez5Tpxehr94Os43MHLNFRIlHv ORoND0648FQrkz/pMWV2jco2ibcSNzuts6HlY/oSUsW0ItT6r27IQv6EISJ6ajINyIL7MNvRdSIQ9 sRTneI+zmTZqSqeHFzaOfRTT0/onc33ZCQ7RhaAhQFLylUqV7T+83UiCTEU/OuW/K7oIFDgkX0iHK 5ub8jtszFSYsvGUNN6dhohwXXtNW9rrcaUIplnEc5YmJ71FfOp3lv72kdFpnqd4meuy+W2SQG5KBs AJ/V+nRCvkRe7CXSqpp3oRQfjYK0a6A6rdUJMsXV1HJ8kykUl5Tq981el9KEPRkg9NnlV9e+JwpUa fephFLYg==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.99.1 #2 (Red Hat Linux)) id 1xIiEI-00000006nkU-29x0; Mon, 19 Oct 2026 07:56:22 +0000 Received: from out30-131.freemail.mail.aliyun.com ([115.124.30.131]) by bombadil.infradead.org with esmtps (Exim 4.99.1 #2 (Red Hat Linux)) id 1xIiEE-00000006ngV-1J46 for linux-nvme@lists.infradead.org; Mon, 19 Oct 2026 07:56:19 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.alibaba.com; s=default; t=1792396576; h=From:To:Subject:Date:Message-ID:MIME-Version; bh=pM4/Gj0Cb3LUXcp9sTVrpS/0rQM/R6r7247NHEq1kfo=; b=VmwyKyQ7RqmNrKrzxXvV6GFGenrsU6UIdQcS1qsYe7RVT8x1WSTOhOVW2Cq6OEjCFgi4V6+mhgpUm3dfmv/qZlkAa8v2VcynjdwpC8AOItOqMNDkPEovgKkiyTCjjozxePJ84T6USKUGSvCucxxm7hfRoJSE/rtyISGdbFkdQ6E= X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R161e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=maildocker-contentspam033037026112;MF=kanie@linux.alibaba.com;NM=1;PH=DS;RN=8;SR=0;TI=SMTPD_---0XD1g9S4_1792396575; Received: from localhost(mailfrom:kanie@linux.alibaba.com fp:SMTPD_---0XD1g9S4_1792396575 cluster:ay36) by smtp.aliyun-inc.com; Mon, 19 Oct 2026 15:56:15 +0800 From: Guixin Liu To: Keith Busch , Jens Axboe , Christoph Hellwig , Sagi Grimberg , Nilay Shroff , Daniel Wagner , Hannes Reinecke Cc: linux-nvme@lists.infradead.org Subject: [PATCH v2 3/3] nvme: document the service-time iopolicy sysfs attributes Date: Mon, 19 Oct 2026 15:56:05 +0800 Message-ID: <20261019075607.808947-4-kanie@linux.alibaba.com> X-Mailer: git-send-email 2.43.7 In-Reply-To: <20261019075607.808947-1-kanie@linux.alibaba.com> References: <20261019075607.808947-1-kanie@linux.alibaba.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.9.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20261019_005618_528998_ACE10AEF X-CRM114-Status: GOOD ( 12.22 ) X-BeenThere: linux-nvme@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-nvme" Errors-To: linux-nvme-bounces+linux-nvme=archiver.kernel.org@lists.infradead.org The service-time iopolicy adds two sysfs attributes to the NVMe path namespace devices: in_flight_bytes, reporting the bytes currently in flight on the path's controller, and relative_throughput, the per-path throughput weight used by the service-time estimation. Document both in the stable sysfs ABI, including the 0-100 value range, the default of 1, and the standby semantics of a relative_throughput of 0. Signed-off-by: Guixin Liu --- Documentation/ABI/stable/sysfs-nvme | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/Documentation/ABI/stable/sysfs-nvme b/Documentation/ABI/stable/sysfs-nvme index a2f5d0710db40..adaf292c8c67b 100644 --- a/Documentation/ABI/stable/sysfs-nvme +++ b/Documentation/ABI/stable/sysfs-nvme @@ -326,6 +326,28 @@ Description: currently selected path. Returns empty if iopolicy is not "numa". Requires CONFIG_NVME_MULTIPATH. +What: /sys/block/nvmeXcYnZ/in_flight_bytes +What: /sys/block/nvmeXcYnZ/relative_throughput +Date: October 2026 +KernelVersion: 7.5 +Contact: Guixin Liu +Description: + in_flight_bytes: Shows the number of bytes currently in + flight on this path's controller. Returns empty if + iopolicy is not "service-time". + Requires CONFIG_NVME_MULTIPATH. + + relative_throughput: Shows or sets the relative + throughput weight of this path, which the "service-time" + iopolicy uses to estimate the path service time as + in_flight_bytes / relative_throughput. The value is an + integer in the range 0-100 and defaults to 1; assign + higher values to faster paths. A path with a value of 0 + is only selected when no path with a positive value is + available. Reading returns empty if iopolicy is not + "service-time"; writing is accepted regardless of the + active policy. Requires CONFIG_NVME_MULTIPATH. + What: /sys/block/nvmeXnY/delayed_removal_secs Date: May 2025 KernelVersion: 6.16 -- 2.43.7