powerpc/hv-24x7: Add sysfs files inside hv-24x7 device to show cpumask
[linux-block.git] / Documentation / ABI / testing / sysfs-bus-event_source-devices-hv_24x7
CommitLineData
ad0a02b8
CS
1What: /sys/bus/event_source/devices/hv_24x7/interface/catalog
2Date: February 2014
dfdac393 3Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
ad0a02b8
CS
4Description:
5 Provides access to the binary "24x7 catalog" provided by the
6 hypervisor on POWER7 and 8 systems. This catalog lists events
08559657 7 available from the powerpc "hv_24x7" pmu. Its format is
ad0a02b8
CS
8 documented here:
9 https://raw.githubusercontent.com/jmesmon/catalog-24x7/master/hv-24x7-catalog.h
10
11What: /sys/bus/event_source/devices/hv_24x7/interface/catalog_length
12Date: February 2014
dfdac393 13Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
ad0a02b8
CS
14Description:
15 A number equal to the length in bytes of the catalog. This is
16 also extractable from the provided binary "catalog" sysfs entry.
17
18What: /sys/bus/event_source/devices/hv_24x7/interface/catalog_version
19Date: February 2014
dfdac393 20Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
ad0a02b8
CS
21Description:
22 Exposes the "version" field of the 24x7 catalog. This is also
23 extractable from the provided binary "catalog" sysfs entry.
5c65670c 24
15cd1d35
KJ
25What: /sys/devices/hv_24x7/interface/sockets
26Date: May 2020
27Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
28Description: read only
29 This sysfs interface exposes the number of sockets present in the
30 system.
31
32What: /sys/devices/hv_24x7/interface/chipspersocket
33Date: May 2020
34Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
35Description: read only
36 This sysfs interface exposes the number of chips per socket
37 present in the system.
38
39What: /sys/devices/hv_24x7/interface/coresperchip
40Date: May 2020
41Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
42Description: read only
43 This sysfs interface exposes the number of cores per chip
44 present in the system.
45
792f73f7
KJ
46What: /sys/devices/hv_24x7/interface/cpumask
47Date: July 2020
48Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
49Description: read only
50 This sysfs file exposes the cpumask which is designated to make
51 HCALLs to retrieve hv-24x7 pmu event counter data.
52
5c65670c
CS
53What: /sys/bus/event_source/devices/hv_24x7/event_descs/<event-name>
54Date: February 2014
55Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
56Description:
57 Provides the description of a particular event as provided by
58 the firmware. If firmware does not provide a description, no
59 file will be created.
60
61 Note that the event-name lacks the domain suffix appended for
62 events in the events/ dir.
63
64What: /sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name>
65Date: February 2014
66Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
67Description:
68 Provides the "long" description of a particular event as
69 provided by the firmware. If firmware does not provide a
70 description, no file will be created.
71
72 Note that the event-name lacks the domain suffix appended for
73 events in the events/ dir.