xref: /linux/Documentation/ABI/testing/sysfs-bus-event_source-devices (revision 7685b334d1e4927cc73b62c65293ba65748d9c52)
1What: /sys/bus/event_source/devices/<pmu>
2Date: 2014/02/24
3Contact:	Linux kernel mailing list <linux-kernel@vger.kernel.org>
4Description:	Performance Monitoring Unit (<pmu>)
5
6		Each <pmu> directory, for a PMU device, is a name
7		optionally followed by an underscore and then either a
8		decimal or hexadecimal number. For example, cpu is a
9		PMU name without a suffix as is intel_bts,
10		uncore_imc_0 is a PMU name with a 0 numeric suffix,
11		ddr_pmu_87e1b0000000 is a PMU name with a hex
12		suffix. The hex suffix must be more than two
13		characters long to avoid ambiguity with PMUs like the
14		S390 cpum_cf.
15
16		Tools can treat PMUs with the same name that differ by
17		suffix as instances of the same PMU for the sake of,
18		for example, opening an event. For example, the PMUs
19		uncore_imc_free_running_0 and
20		uncore_imc_free_running_1 have an event data_read;
21		opening the data_read event on a PMU specified as
22		uncore_imc_free_running should be treated as opening
23		the data_read event on PMU uncore_imc_free_running_0
24		and PMU uncore_imc_free_running_1.
25