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
next prev 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®