1ad0a02b8SCody P SchaferWhat: /sys/bus/event_source/devices/hv_24x7/interface/catalog 2ad0a02b8SCody P SchaferDate: February 2014 3dfdac393Ssukadev@linux.vnet.ibm.comContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 4ad0a02b8SCody P SchaferDescription: 5ad0a02b8SCody P Schafer Provides access to the binary "24x7 catalog" provided by the 6ad0a02b8SCody P Schafer hypervisor on POWER7 and 8 systems. This catalog lists events 708559657SKees Cook available from the powerpc "hv_24x7" pmu. Its format is 8ad0a02b8SCody P Schafer documented here: 9ad0a02b8SCody P Schafer https://raw.githubusercontent.com/jmesmon/catalog-24x7/master/hv-24x7-catalog.h 10ad0a02b8SCody P Schafer 11ad0a02b8SCody P SchaferWhat: /sys/bus/event_source/devices/hv_24x7/interface/catalog_length 12ad0a02b8SCody P SchaferDate: February 2014 13dfdac393Ssukadev@linux.vnet.ibm.comContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 14ad0a02b8SCody P SchaferDescription: 15ad0a02b8SCody P Schafer A number equal to the length in bytes of the catalog. This is 16ad0a02b8SCody P Schafer also extractable from the provided binary "catalog" sysfs entry. 17ad0a02b8SCody P Schafer 18ad0a02b8SCody P SchaferWhat: /sys/bus/event_source/devices/hv_24x7/interface/catalog_version 19ad0a02b8SCody P SchaferDate: February 2014 20dfdac393Ssukadev@linux.vnet.ibm.comContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 21ad0a02b8SCody P SchaferDescription: 22ad0a02b8SCody P Schafer Exposes the "version" field of the 24x7 catalog. This is also 23ad0a02b8SCody P Schafer extractable from the provided binary "catalog" sysfs entry. 245c65670cSCody P Schafer 2515cd1d35SKajol JainWhat: /sys/devices/hv_24x7/interface/sockets 2615cd1d35SKajol JainDate: May 2020 2715cd1d35SKajol JainContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 2815cd1d35SKajol JainDescription: read only 2915cd1d35SKajol Jain This sysfs interface exposes the number of sockets present in the 3015cd1d35SKajol Jain system. 3115cd1d35SKajol Jain 3215cd1d35SKajol JainWhat: /sys/devices/hv_24x7/interface/chipspersocket 3315cd1d35SKajol JainDate: May 2020 3415cd1d35SKajol JainContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 3515cd1d35SKajol JainDescription: read only 3615cd1d35SKajol Jain This sysfs interface exposes the number of chips per socket 3715cd1d35SKajol Jain present in the system. 3815cd1d35SKajol Jain 3915cd1d35SKajol JainWhat: /sys/devices/hv_24x7/interface/coresperchip 4015cd1d35SKajol JainDate: May 2020 4115cd1d35SKajol JainContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 4215cd1d35SKajol JainDescription: read only 4315cd1d35SKajol Jain This sysfs interface exposes the number of cores per chip 4415cd1d35SKajol Jain present in the system. 4515cd1d35SKajol Jain 46792f73f7SKajol JainWhat: /sys/devices/hv_24x7/interface/cpumask 47792f73f7SKajol JainDate: July 2020 48792f73f7SKajol JainContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 49792f73f7SKajol JainDescription: read only 50792f73f7SKajol Jain This sysfs file exposes the cpumask which is designated to make 51792f73f7SKajol Jain HCALLs to retrieve hv-24x7 pmu event counter data. 52792f73f7SKajol Jain 535c65670cSCody P SchaferWhat: /sys/bus/event_source/devices/hv_24x7/event_descs/<event-name> 545c65670cSCody P SchaferDate: February 2014 555c65670cSCody P SchaferContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 565c65670cSCody P SchaferDescription: 575c65670cSCody P Schafer Provides the description of a particular event as provided by 585c65670cSCody P Schafer the firmware. If firmware does not provide a description, no 595c65670cSCody P Schafer file will be created. 605c65670cSCody P Schafer 615c65670cSCody P Schafer Note that the event-name lacks the domain suffix appended for 625c65670cSCody P Schafer events in the events/ dir. 635c65670cSCody P Schafer 645c65670cSCody P SchaferWhat: /sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name> 655c65670cSCody P SchaferDate: February 2014 665c65670cSCody P SchaferContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 675c65670cSCody P SchaferDescription: 685c65670cSCody P Schafer Provides the "long" description of a particular event as 695c65670cSCody P Schafer provided by the firmware. If firmware does not provide a 705c65670cSCody P Schafer description, no file will be created. 715c65670cSCody P Schafer 725c65670cSCody P Schafer Note that the event-name lacks the domain suffix appended for 735c65670cSCody P Schafer events in the events/ dir. 74