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/bus/event_source/devices/hv_24x7/event_descs/<event-name>
  47 Date:           February 2014
  48 Contact:        Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
  49 Description:
  50                 Provides the description of a particular event as provided by
  51                 the firmware. If firmware does not provide a description, no
  52                 file will be created.
  53
  54                 Note that the event-name lacks the domain suffix appended for
  55                 events in the events/ dir.
  56
  57 What:           /sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name>
  58 Date:           February 2014
  59 Contact:        Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
  60 Description:
  61                 Provides the "long" description of a particular event as
  62                 provided by the firmware. If firmware does not provide a
  63                 description, no file will be created.
  64
  65                 Note that the event-name lacks the domain suffix appended for
  66                 events in the events/ dir.