Received: by 2002:a05:6358:11c7:b0:104:8066:f915 with SMTP id i7csp1593621rwl; Wed, 5 Apr 2023 20:57:35 -0700 (PDT) X-Google-Smtp-Source: AKy350b/oJ2LgSEFni7PQZX58rJ9xOj4EoS2EGH2W61d9LPZ6aBirQB5Aszif9P3ZA306bdNamFz X-Received: by 2002:a17:906:5fd1:b0:91f:b13f:a028 with SMTP id k17-20020a1709065fd100b0091fb13fa028mr4710874ejv.34.1680753455635; Wed, 05 Apr 2023 20:57:35 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1680753455; cv=none; d=google.com; s=arc-20160816; b=E5adLCYfvTy5d+C52PYABVpcnSkZxQzBuhoxXAk+qWYaspICxEGQgoo9x6JUubpBSk UR4uZpbgjdYFByTbAlciGAyyU8Nk2NdLAZHAho/Fh0fXIvSoTVHdscnKoMKObwZNA2U9 q9EIZZKHi/DKDphYoSBw/Aw8bwCRFILucnFpZZBe9MD8d6Zk1d11FToi4C6UHj1R7EhF F7lfYekLSJ70c4CCSp5Xl9P/s/A/Pukxmxn+ERhPM1zDYoS7PBLxnfHTPu6cHfOmiozl V1Gle/AQxUE1MDxJO9Aokzn6ACqsfITbABCr6CsfoBVhS3n/N2a5fT+jalgYDwad2Vxa QGAQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:in-reply-to :mime-version:user-agent:date:message-id:from:references:to:subject :cc; bh=NY0dbj2gyk0qAW6dK6+ZmMbmgfONkgiB5wbwe3Wc9A8=; b=Z1E+Zay7xXEoutfGWOYVu5nLYNwJ/JP+vPgJ9390DPFeXTxx6kbk7d9CLzpKpr23Rv klQYbqcAYqSQAX5oHvfYaem6Tk0NO7za4B/4Nz+xjb7MT/3ocuOmBaCpNK445fqT9xzU Xmab4+daBcXMW02fd2s6HF5FOreEfeo3TRMb65YXGPWzTjSwRtHRUBZvlOroSZMPMrlq PwgN4P/UlwuDekkxr6yPXvLnwZBlQ/QsJa5WqrPDU66p9TgwKEMHCkBElgmYBtfeuE9L Spa4KfpVkmlqNNLC+F5Ud+yuOh3NGEEP7D5qz6sKzp71Ky8WCVRiJ+/59ancbGut8jIQ EKRA== ARC-Authentication-Results: i=1; mx.google.com; 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=fail (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=huawei.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id b14-20020a17090636ce00b0092fd9e735d6si416918ejc.314.2023.04.05.20.57.11; Wed, 05 Apr 2023 20:57:35 -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; 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=fail (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=huawei.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234914AbjDFDza (ORCPT + 99 others); Wed, 5 Apr 2023 23:55:30 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:55618 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231955AbjDFDz2 (ORCPT ); Wed, 5 Apr 2023 23:55:28 -0400 Received: from szxga02-in.huawei.com (szxga02-in.huawei.com [45.249.212.188]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id BA2C13ABC; Wed, 5 Apr 2023 20:55:26 -0700 (PDT) Received: from canpemm500009.china.huawei.com (unknown [172.30.72.53]) by szxga02-in.huawei.com (SkyGuard) with ESMTP id 4PsSJH60N3zKx16; Thu, 6 Apr 2023 11:52:47 +0800 (CST) Received: from [10.67.102.169] (10.67.102.169) by canpemm500009.china.huawei.com (7.192.105.203) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.23; Thu, 6 Apr 2023 11:54:59 +0800 CC: , , Dan Williams , Shaokun Zhang , Jiucheng Xu , Khuong Dinh , Robert Richter , Atish Patra , Anup Patel , Andy Gross , Bjorn Andersson , Frank Li , Shuai Xue , Vineet Gupta , Shawn Guo , Fenghua Yu , Dave Jiang , Wu Hao , Tom Rix , , Suzuki K Poulose , Liang Kan Subject: Re: [PATCH 31/32] Documentation: ABI + trace: hisi_ptt: update paths to bus/event_source To: Jonathan Cameron , Mark Rutland , Peter Zijlstra , Ingo Molnar , Arnaldo Carvalho de Melo , Will Deacon , , , References: <20230404134225.13408-1-Jonathan.Cameron@huawei.com> <20230404134225.13408-32-Jonathan.Cameron@huawei.com> From: Yicong Yang Message-ID: Date: Thu, 6 Apr 2023 11:54:59 +0800 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.5.1 MIME-Version: 1.0 In-Reply-To: <20230404134225.13408-32-Jonathan.Cameron@huawei.com> Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit X-Originating-IP: [10.67.102.169] X-ClientProxiedBy: dggems706-chm.china.huawei.com (10.3.19.183) To canpemm500009.china.huawei.com (7.192.105.203) X-CFilter-Loop: Reflected X-Spam-Status: No, score=-3.7 required=5.0 tests=NICE_REPLY_A, RCVD_IN_DNSWL_MED,SPF_HELO_NONE,SPF_PASS autolearn=unavailable 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 On 2023/4/4 21:42, Jonathan Cameron wrote: > To allow for assigning a suitable parent to the struct pmu device > update the documentation to describe the device via the event_source > bus where it will remain accessible. > > For the ABI documention file also rename the file as it is named > after the path. > > Signed-off-by: Jonathan Cameron Reviewed-by: Yicong Yang > --- > ...i_ptt => sysfs-bus-event_source-devices-hisi_ptt} | 12 ++++++------ > Documentation/trace/hisi-ptt.rst | 4 ++-- > MAINTAINERS | 2 +- > 3 files changed, 9 insertions(+), 9 deletions(-) > > diff --git a/Documentation/ABI/testing/sysfs-devices-hisi_ptt b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hisi_ptt > similarity index 83% > rename from Documentation/ABI/testing/sysfs-devices-hisi_ptt > rename to Documentation/ABI/testing/sysfs-bus-event_source-devices-hisi_ptt > index 82de6d710266..f2f48f7ce887 100644 > --- a/Documentation/ABI/testing/sysfs-devices-hisi_ptt > +++ b/Documentation/ABI/testing/sysfs-bus-event_source-devices-hisi_ptt > @@ -1,4 +1,4 @@ > -What: /sys/devices/hisi_ptt_/tune > +What: /sys/bus/event_source/devices/hisi_ptt_/tune > Date: October 2022 > KernelVersion: 6.1 > Contact: Yicong Yang > @@ -8,7 +8,7 @@ Description: This directory contains files for tuning the PCIe link > > See Documentation/trace/hisi-ptt.rst for more information. > > -What: /sys/devices/hisi_ptt_/tune/qos_tx_cpl > +What: /sys/bus/event_source/devices/hisi_ptt_/tune/qos_tx_cpl > Date: October 2022 > KernelVersion: 6.1 > Contact: Yicong Yang > @@ -18,7 +18,7 @@ Description: (RW) Controls the weight of Tx completion TLPs, which influence > will return an error, and out of range values will be converted > to 2. The value indicates a probable level of the event. > > -What: /sys/devices/hisi_ptt_/tune/qos_tx_np > +What: /sys/bus/event_source/devices/hisi_ptt_/tune/qos_tx_np > Date: October 2022 > KernelVersion: 6.1 > Contact: Yicong Yang > @@ -28,7 +28,7 @@ Description: (RW) Controls the weight of Tx non-posted TLPs, which influence > will return an error, and out of range values will be converted > to 2. The value indicates a probable level of the event. > > -What: /sys/devices/hisi_ptt_/tune/qos_tx_p > +What: /sys/bus/event_source/devices/hisi_ptt_/tune/qos_tx_p > Date: October 2022 > KernelVersion: 6.1 > Contact: Yicong Yang > @@ -38,7 +38,7 @@ Description: (RW) Controls the weight of Tx posted TLPs, which influence the > will return an error, and out of range values will be converted > to 2. The value indicates a probable level of the event. > > -What: /sys/devices/hisi_ptt_/tune/rx_alloc_buf_level > +What: /sys/bus/event_source/devices/hisi_ptt_/tune/rx_alloc_buf_level > Date: October 2022 > KernelVersion: 6.1 > Contact: Yicong Yang > @@ -49,7 +49,7 @@ Description: (RW) Control the allocated buffer watermark for inbound packets. > will return an error, and out of range values will be converted > to 2. The value indicates a probable level of the event. > > -What: /sys/devices/hisi_ptt_/tune/tx_alloc_buf_level > +What: /sys/bus/event_source/devices/hisi_ptt_/tune/tx_alloc_buf_level > Date: October 2022 > KernelVersion: 6.1 > Contact: Yicong Yang > diff --git a/Documentation/trace/hisi-ptt.rst b/Documentation/trace/hisi-ptt.rst > index 4f87d8e21065..d923e09fcbaa 100644 > --- a/Documentation/trace/hisi-ptt.rst > +++ b/Documentation/trace/hisi-ptt.rst > @@ -40,7 +40,7 @@ IO dies (SICL, Super I/O Cluster), where there's one PCIe Root > Complex for each SICL. > :: > > - /sys/devices/hisi_ptt_ > + /sys/bus/event_source/devices/hisi_ptt_ > > Tune > ==== > @@ -53,7 +53,7 @@ Each event is presented as a file under $(PTT PMU dir)/tune, and > a simple open/read/write/close cycle will be used to tune the event. > :: > > - $ cd /sys/devices/hisi_ptt_/tune > + $ cd /sys/bus/event_source/devices/hisi_ptt_/tune > $ ls > qos_tx_cpl qos_tx_np qos_tx_p > tx_path_rx_req_alloc_buf_level > diff --git a/MAINTAINERS b/MAINTAINERS > index d8ebab595b2a..75019f62b1df 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -9266,7 +9266,7 @@ M: Yicong Yang > M: Jonathan Cameron > L: linux-kernel@vger.kernel.org > S: Maintained > -F: Documentation/ABI/testing/sysfs-devices-hisi_ptt > +F: Documentation/ABI/testing/sysfs-bus-event_source-devices-hisi_ptt > F: Documentation/trace/hisi-ptt.rst > F: drivers/hwtracing/ptt/ > F: tools/perf/arch/arm64/util/hisi-ptt.c >