mirror of https://lore.kernel.org/lkml/
 help / color / mirror / Atom feed
From: Jonathan Cameron <Jonathan.Cameron@huawei.com>
To: Mark Rutland <mark.rutland@arm.com>,
	Peter Zijlstra <peterz@infradead.org>,
	Ingo Molnar <mingo@redhat.com>,
	Arnaldo Carvalho de Melo <acme@kernel.org>,
	Will Deacon <will@kernel.org>, <linux-kernel@vger.kernel.org>,
	<linux-arm-kernel@lists.infradead.org>,
	<gregkh@linuxfoundation.org>
Cc: <linuxarm@huawei.com>, Shaokun Zhang <zhangshaokun@hisilicon.com>,
	Yicong Yang <yangyicong@hisilicon.com>,
	Jiucheng Xu <jiucheng.xu@amlogic.com>,
	Khuong Dinh <khuong@os.amperecomputing.com>,
	Atish Patra <atishp@atishpatra.org>,
	Anup Patel <anup@brainfault.org>, Andy Gross <agross@kernel.org>,
	Bjorn Andersson <andersson@kernel.org>,
	Frank Li <Frank.li@nxp.com>,
	Shuai Xue <xueshuai@linux.alibaba.com>,
	Vineet Gupta <vgupta@kernel.org>, Shawn Guo <shawnguo@kernel.org>,
	Fenghua Yu <fenghua.yu@intel.com>,
	Dave Jiang <dave.jiang@intel.com>, Wu Hao <hao.wu@intel.com>,
	Tom Rix <trix@redhat.com>, <linux-fpga@vger.kernel.org>,
	Suzuki K Poulose <suzuki.poulose@arm.com>,
	Liang Kan <kan.liang@linux.intel.com>
Subject: [PATCH v2 29/30] Documentation: ABI + trace: hisi_ptt: update paths to bus/event_source
Date: Fri, 12 Apr 2024 17:10:56 +0100	[thread overview]
Message-ID: <20240412161057.14099-30-Jonathan.Cameron@huawei.com> (raw)
In-Reply-To: <20240412161057.14099-1-Jonathan.Cameron@huawei.com>

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.

Reviewed-by: Yicong Yang <yangyicong@hisilicon.com>
Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
---
 ...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 90%
rename from Documentation/ABI/testing/sysfs-devices-hisi_ptt
rename to Documentation/ABI/testing/sysfs-bus-event_source-devices-hisi_ptt
index d7e206b4901c..1119766564d7 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<sicl_id>_<core_id>/tune
+What:		/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune
 Date:		October 2022
 KernelVersion:	6.1
 Contact:	Yicong Yang <yangyicong@hisilicon.com>
@@ -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<sicl_id>_<core_id>/tune/qos_tx_cpl
+What:		/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/qos_tx_cpl
 Date:		October 2022
 KernelVersion:	6.1
 Contact:	Yicong Yang <yangyicong@hisilicon.com>
@@ -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<sicl_id>_<core_id>/tune/qos_tx_np
+What:		/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/qos_tx_np
 Date:		October 2022
 KernelVersion:	6.1
 Contact:	Yicong Yang <yangyicong@hisilicon.com>
@@ -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<sicl_id>_<core_id>/tune/qos_tx_p
+What:		/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/qos_tx_p
 Date:		October 2022
 KernelVersion:	6.1
 Contact:	Yicong Yang <yangyicong@hisilicon.com>
@@ -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<sicl_id>_<core_id>/tune/rx_alloc_buf_level
+What:		/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/rx_alloc_buf_level
 Date:		October 2022
 KernelVersion:	6.1
 Contact:	Yicong Yang <yangyicong@hisilicon.com>
@@ -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<sicl_id>_<core_id>/tune/tx_alloc_buf_level
+What:		/sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/tune/tx_alloc_buf_level
 Date:		October 2022
 KernelVersion:	6.1
 Contact:	Yicong Yang <yangyicong@hisilicon.com>
diff --git a/Documentation/trace/hisi-ptt.rst b/Documentation/trace/hisi-ptt.rst
index 989255eb5622..6eef28ebb0c7 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<sicl_id>_<core_id>
+    /sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>
 
 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<sicl_id>_<core_id>/tune
+    $ cd /sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>/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 aea47e04c3a5..2f0a97aa1e60 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -9796,7 +9796,7 @@ M:	Yicong Yang <yangyicong@hisilicon.com>
 M:	Jonathan Cameron <jonathan.cameron@huawei.com>
 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
-- 
2.39.2


  parent reply	other threads:[~2024-04-12 16:25 UTC|newest]

Thread overview: 38+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-04-12 16:10 [PATCH v2 00/30] Add parents to struct pmu -> dev Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 01/30] perf/hisi-pcie: Assign parent for event_source device Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 02/30] Documentation: hisi-pmu: Drop reference to /sys/devices path Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 03/30] perf/hisi-uncore: Assign parents for event_source devices Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 04/30] Documentation: hns-pmu: Use /sys/bus/event_source/devices paths Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 05/30] perf/hisi-hns3: Assign parents for event_source device Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 06/30] perf/amlogic: Assign parents for event_source devices Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 07/30] perf/arm_cspmu: " Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 08/30] Documentation: xgene-pmu: Use /sys/bus/event_source/devices paths Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 09/30] perf/xgene: Assign parents for event_source devices Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 10/30] Documentation: thunderx2-pmu: Use /sys/bus/event_source/devices paths Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 11/30] perf/thunderx2: Assign parents for event_source devices Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 12/30] perf/riscv: " Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 13/30] Documentation: qcom-pmu: Use /sys/bus/event_source/devices paths Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 14/30] perf/qcom: Assign parents for event_source devices Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 15/30] perf/imx_ddr: " Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 16/30] perf/arm_pmu: " Jonathan Cameron
2024-04-16  9:36   ` Suzuki K Poulose
2024-04-12 16:10 ` [PATCH v2 17/30] perf/alibaba_uncore: Assign parents for event_source device Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 18/30] perf/arm-cci: " Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 19/30] perf/arm-ccn: " Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 20/30] perf/arm-dmc620: " Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 21/30] perf/arm-dsu: " Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 22/30] perf/arm-smmuv3: " Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 23/30] perf/arm-spe: " Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 24/30] arc: Assign parents for event_source devices Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 25/30] ARM: imx: Assign parents for mmdc " Jonathan Cameron
2024-04-22  5:42   ` Shawn Guo
2024-04-12 16:10 ` [PATCH v2 26/30] dmaengine: idxd: Assign parent for event_source device Jonathan Cameron
2024-04-12 16:27   ` Dave Jiang
2024-04-15 19:05   ` Fenghua Yu
2024-04-12 16:10 ` [PATCH v2 27/30] fpga: dfl: " Jonathan Cameron
2024-04-12 16:10 ` [PATCH v2 28/30] drivers/nvdimm: " Jonathan Cameron
2024-04-12 16:10 ` Jonathan Cameron [this message]
2024-04-12 16:10 ` [PATCH v2 30/30] hwtracing: hisi_ptt: " Jonathan Cameron
2024-04-16  9:38   ` Suzuki K Poulose
2024-04-19 15:33 ` [PATCH v2 00/30] Add parents to struct pmu -> dev Will Deacon
2024-05-02 11:09 ` [PATCH v2 00/30] (subset) " Suzuki K Poulose

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20240412161057.14099-30-Jonathan.Cameron@huawei.com \
    --to=jonathan.cameron@huawei.com \
    --cc=Frank.li@nxp.com \
    --cc=acme@kernel.org \
    --cc=agross@kernel.org \
    --cc=andersson@kernel.org \
    --cc=anup@brainfault.org \
    --cc=atishp@atishpatra.org \
    --cc=dave.jiang@intel.com \
    --cc=fenghua.yu@intel.com \
    --cc=gregkh@linuxfoundation.org \
    --cc=hao.wu@intel.com \
    --cc=jiucheng.xu@amlogic.com \
    --cc=kan.liang@linux.intel.com \
    --cc=khuong@os.amperecomputing.com \
    --cc=linux-arm-kernel@lists.infradead.org \
    --cc=linux-fpga@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linuxarm@huawei.com \
    --cc=mark.rutland@arm.com \
    --cc=mingo@redhat.com \
    --cc=peterz@infradead.org \
    --cc=shawnguo@kernel.org \
    --cc=suzuki.poulose@arm.com \
    --cc=trix@redhat.com \
    --cc=vgupta@kernel.org \
    --cc=will@kernel.org \
    --cc=xueshuai@linux.alibaba.com \
    --cc=yangyicong@hisilicon.com \
    --cc=zhangshaokun@hisilicon.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox

all inboxes | Powered by JetHome®