summaryrefslogtreecommitdiff
path: root/Documentation/ABI/testing/sysfs-bus-event_source-devices-caps
blob: a5f506f7d4819ecee67f4dcdb62f19d3b34e8473 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
What:		/sys/bus/event_source/devices/<dev>/caps
Date:		May 2022
KernelVersion:	5.19
Contact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
Description:
		Attribute group to describe the capabilities exposed
		for a particular pmu. Each attribute of this group can
		expose information specific to a PMU, say pmu_name, so that
		userspace can understand some of the feature which the
		platform specific PMU supports.

		One of the example available capability in supported platform
		like Intel is pmu_name, which exposes underlying CPU name known
		to the PMU driver.

		Example output in powerpc:
		grep . /sys/bus/event_source/devices/cpu/caps/*
		/sys/bus/event_source/devices/cpu/caps/pmu_name:POWER9

		The "branch_counter_nr" in the supported platform exposes the
		maximum number of counters which can be shown in the u64 counters
		of PERF_SAMPLE_BRANCH_COUNTERS, while the "branch_counter_width"
		exposes the width of each counter. Both of them can be used by
		the perf tool to parse the logged counters in each branch.