Documentation: ABI + trace: hisi_ptt: update paths to bus/event_source

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>
Signed-off-by: Suzuki K Poulose <suzuki.poulose@arm.com>
Link: https://lore.kernel.org/r/20240412161057.14099-30-Jonathan.Cameron@huawei.com
This commit is contained in:
Jonathan Cameron 2024-04-12 17:10:56 +01:00 committed by Suzuki K Poulose
parent 8877ef45ef
commit 1f82d58ddb
3 changed files with 9 additions and 9 deletions

View File

@ -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 Date: October 2022
KernelVersion: 6.1 KernelVersion: 6.1
Contact: Yicong Yang <yangyicong@hisilicon.com> 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. 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 Date: October 2022
KernelVersion: 6.1 KernelVersion: 6.1
Contact: Yicong Yang <yangyicong@hisilicon.com> 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 will return an error, and out of range values will be converted
to 2. The value indicates a probable level of the event. 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 Date: October 2022
KernelVersion: 6.1 KernelVersion: 6.1
Contact: Yicong Yang <yangyicong@hisilicon.com> 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 will return an error, and out of range values will be converted
to 2. The value indicates a probable level of the event. 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 Date: October 2022
KernelVersion: 6.1 KernelVersion: 6.1
Contact: Yicong Yang <yangyicong@hisilicon.com> 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 will return an error, and out of range values will be converted
to 2. The value indicates a probable level of the event. 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 Date: October 2022
KernelVersion: 6.1 KernelVersion: 6.1
Contact: Yicong Yang <yangyicong@hisilicon.com> 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 will return an error, and out of range values will be converted
to 2. The value indicates a probable level of the event. 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 Date: October 2022
KernelVersion: 6.1 KernelVersion: 6.1
Contact: Yicong Yang <yangyicong@hisilicon.com> Contact: Yicong Yang <yangyicong@hisilicon.com>

View File

@ -40,7 +40,7 @@ IO dies (SICL, Super I/O Cluster), where there's one PCIe Root
Complex for each SICL. Complex for each SICL.
:: ::
/sys/devices/hisi_ptt<sicl_id>_<core_id> /sys/bus/event_source/devices/hisi_ptt<sicl_id>_<core_id>
Tune 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. 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 $ ls
qos_tx_cpl qos_tx_np qos_tx_p qos_tx_cpl qos_tx_np qos_tx_p
tx_path_rx_req_alloc_buf_level tx_path_rx_req_alloc_buf_level

View File

@ -9790,7 +9790,7 @@ M: Yicong Yang <yangyicong@hisilicon.com>
M: Jonathan Cameron <jonathan.cameron@huawei.com> M: Jonathan Cameron <jonathan.cameron@huawei.com>
L: linux-kernel@vger.kernel.org L: linux-kernel@vger.kernel.org
S: Maintained 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: Documentation/trace/hisi-ptt.rst
F: drivers/hwtracing/ptt/ F: drivers/hwtracing/ptt/
F: tools/perf/arch/arm64/util/hisi-ptt.c F: tools/perf/arch/arm64/util/hisi-ptt.c