1264a0340SKajol JainWhat: /sys/bus/event_source/devices/hv_24x7/format 2264a0340SKajol JainDate: September 2020 3264a0340SKajol JainContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 4264a0340SKajol JainDescription: Read-only. Attribute group to describe the magic bits 5264a0340SKajol Jain that go into perf_event_attr.config for a particular pmu. 6264a0340SKajol Jain (See ABI/testing/sysfs-bus-event_source-devices-format). 7264a0340SKajol Jain 8264a0340SKajol Jain Each attribute under this group defines a bit range of the 9264a0340SKajol Jain perf_event_attr.config. All supported attributes are listed 10264a0340SKajol Jain below. 11264a0340SKajol Jain 12264a0340SKajol Jain chip = "config:16-31" 13264a0340SKajol Jain core = "config:16-31" 14264a0340SKajol Jain domain = "config:0-3" 15264a0340SKajol Jain lpar = "config:0-15" 16264a0340SKajol Jain offset = "config:32-63" 17264a0340SKajol Jain vcpu = "config:16-31" 18264a0340SKajol Jain 19264a0340SKajol Jain For example, 20264a0340SKajol Jain 21264a0340SKajol Jain PM_PB_CYC = "domain=1,offset=0x80,chip=?,lpar=0x0" 22264a0340SKajol Jain 23264a0340SKajol Jain In this event, '?' after chip specifies that 24264a0340SKajol Jain this value will be provided by user while running this event. 25264a0340SKajol Jain 26ad0a02b8SCody P SchaferWhat: /sys/bus/event_source/devices/hv_24x7/interface/catalog 27ad0a02b8SCody P SchaferDate: February 2014 28dfdac393Ssukadev@linux.vnet.ibm.comContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 29ad0a02b8SCody P SchaferDescription: 30ad0a02b8SCody P Schafer Provides access to the binary "24x7 catalog" provided by the 31ad0a02b8SCody P Schafer hypervisor on POWER7 and 8 systems. This catalog lists events 3208559657SKees Cook available from the powerpc "hv_24x7" pmu. Its format is 33ad0a02b8SCody P Schafer documented here: 34ad0a02b8SCody P Schafer https://raw.githubusercontent.com/jmesmon/catalog-24x7/master/hv-24x7-catalog.h 35ad0a02b8SCody P Schafer 36ad0a02b8SCody P SchaferWhat: /sys/bus/event_source/devices/hv_24x7/interface/catalog_length 37ad0a02b8SCody P SchaferDate: February 2014 38dfdac393Ssukadev@linux.vnet.ibm.comContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 39ad0a02b8SCody P SchaferDescription: 40ad0a02b8SCody P Schafer A number equal to the length in bytes of the catalog. This is 41ad0a02b8SCody P Schafer also extractable from the provided binary "catalog" sysfs entry. 42ad0a02b8SCody P Schafer 43ad0a02b8SCody P SchaferWhat: /sys/bus/event_source/devices/hv_24x7/interface/catalog_version 44ad0a02b8SCody P SchaferDate: February 2014 45dfdac393Ssukadev@linux.vnet.ibm.comContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 46ad0a02b8SCody P SchaferDescription: 47ad0a02b8SCody P Schafer Exposes the "version" field of the 24x7 catalog. This is also 48ad0a02b8SCody P Schafer extractable from the provided binary "catalog" sysfs entry. 495c65670cSCody P Schafer 5015cd1d35SKajol JainWhat: /sys/devices/hv_24x7/interface/sockets 5115cd1d35SKajol JainDate: May 2020 5215cd1d35SKajol JainContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 5315cd1d35SKajol JainDescription: read only 5415cd1d35SKajol Jain This sysfs interface exposes the number of sockets present in the 5515cd1d35SKajol Jain system. 5615cd1d35SKajol Jain 5715cd1d35SKajol JainWhat: /sys/devices/hv_24x7/interface/chipspersocket 5815cd1d35SKajol JainDate: May 2020 5915cd1d35SKajol JainContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 6015cd1d35SKajol JainDescription: read only 6115cd1d35SKajol Jain This sysfs interface exposes the number of chips per socket 6215cd1d35SKajol Jain present in the system. 6315cd1d35SKajol Jain 6415cd1d35SKajol JainWhat: /sys/devices/hv_24x7/interface/coresperchip 6515cd1d35SKajol JainDate: May 2020 6615cd1d35SKajol JainContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 6715cd1d35SKajol JainDescription: read only 6815cd1d35SKajol Jain This sysfs interface exposes the number of cores per chip 6915cd1d35SKajol Jain present in the system. 7015cd1d35SKajol Jain 7164ef8f2cSKajol JainWhat: /sys/devices/hv_24x7/cpumask 72792f73f7SKajol JainDate: July 2020 73792f73f7SKajol JainContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 74792f73f7SKajol JainDescription: read only 75792f73f7SKajol Jain This sysfs file exposes the cpumask which is designated to make 76792f73f7SKajol Jain HCALLs to retrieve hv-24x7 pmu event counter data. 77792f73f7SKajol Jain 785c65670cSCody P SchaferWhat: /sys/bus/event_source/devices/hv_24x7/event_descs/<event-name> 795c65670cSCody P SchaferDate: February 2014 805c65670cSCody P SchaferContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 815c65670cSCody P SchaferDescription: 825c65670cSCody P Schafer Provides the description of a particular event as provided by 835c65670cSCody P Schafer the firmware. If firmware does not provide a description, no 845c65670cSCody P Schafer file will be created. 855c65670cSCody P Schafer 865c65670cSCody P Schafer Note that the event-name lacks the domain suffix appended for 875c65670cSCody P Schafer events in the events/ dir. 885c65670cSCody P Schafer 895c65670cSCody P SchaferWhat: /sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name> 905c65670cSCody P SchaferDate: February 2014 915c65670cSCody P SchaferContact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> 925c65670cSCody P SchaferDescription: 935c65670cSCody P Schafer Provides the "long" description of a particular event as 945c65670cSCody P Schafer provided by the firmware. If firmware does not provide a 955c65670cSCody P Schafer description, no file will be created. 965c65670cSCody P Schafer 975c65670cSCody P Schafer Note that the event-name lacks the domain suffix appended for 985c65670cSCody P Schafer events in the events/ dir. 99