Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7

   1 What:           /sys/bus/event_source/devices/hv_24x7/interface/catalog
   2 Date:           February 2014
   3 Contact:        Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
   4 Description:
   5                 Provides access to the binary "24x7 catalog" provided by the
   6                 hypervisor on POWER7 and 8 systems. This catalog lists events
   7                 available from the powerpc "hv_24x7" pmu. Its format is
   8                 documented here:
   9                 https://raw.githubusercontent.com/jmesmon/catalog-24x7/master/hv-24x7-catalog.h
  10
  11 What:           /sys/bus/event_source/devices/hv_24x7/interface/catalog_length
  12 Date:           February 2014
  13 Contact:        Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
  14 Description:
  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
  18 What:           /sys/bus/event_source/devices/hv_24x7/interface/catalog_version
  19 Date:           February 2014
  20 Contact:        Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
  21 Description:
  22                 Exposes the "version" field of the 24x7 catalog. This is also
  23                 extractable from the provided binary "catalog" sysfs entry.
  24
  25 What:           /sys/devices/hv_24x7/interface/sockets
  26 Date:           May 2020
  27 Contact:        Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
  28 Description:    read only
  29                 This sysfs interface exposes the number of sockets present in the
  30                 system.
  31
  32 What:           /sys/devices/hv_24x7/interface/chipspersocket
  33 Date:           May 2020
  34 Contact:        Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
  35 Description:    read only
  36                 This sysfs interface exposes the number of chips per socket
  37                 present in the system.
  38
  39 What:           /sys/devices/hv_24x7/interface/coresperchip
  40 Date:           May 2020
  41 Contact:        Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
  42 Description:    read only
  43                 This sysfs interface exposes the number of cores per chip
  44                 present in the system.
  45
  46 What:           /sys/devices/hv_24x7/interface/cpumask
  47 Date:           July 2020
  48 Contact:        Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
  49 Description:    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
  53 What:           /sys/bus/event_source/devices/hv_24x7/event_descs/<event-name>
  54 Date:           February 2014
  55 Contact:        Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
  56 Description:
  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
  64 What:           /sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name>
  65 Date:           February 2014
  66 Contact:        Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
  67 Description:
  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.