99 lines
		
	
	
		
			3.8 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			99 lines
		
	
	
		
			3.8 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
What:           /sys/bus/event_source/devices/hv_24x7/format
 | 
						|
Date:           September 2020
 | 
						|
Contact:        Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
 | 
						|
Description:    Read-only. Attribute group to describe the magic bits
 | 
						|
                that go into perf_event_attr.config for a particular pmu.
 | 
						|
                (See ABI/testing/sysfs-bus-event_source-devices-format).
 | 
						|
 | 
						|
                Each attribute under this group defines a bit range of the
 | 
						|
                perf_event_attr.config. All supported attributes are listed
 | 
						|
                below::
 | 
						|
 | 
						|
				chip = "config:16-31"
 | 
						|
				core  = "config:16-31"
 | 
						|
				domain = "config:0-3"
 | 
						|
				lpar = "config:0-15"
 | 
						|
				offset = "config:32-63"
 | 
						|
				vcpu = "config:16-31"
 | 
						|
 | 
						|
                For example::
 | 
						|
 | 
						|
		  PM_PB_CYC =  "domain=1,offset=0x80,chip=?,lpar=0x0"
 | 
						|
 | 
						|
		In this event, '?' after chip specifies that
 | 
						|
		this value will be provided by user while running this event.
 | 
						|
 | 
						|
What:		/sys/bus/event_source/devices/hv_24x7/interface/catalog
 | 
						|
Date:		February 2014
 | 
						|
Contact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
 | 
						|
Description:
 | 
						|
		Provides access to the binary "24x7 catalog" provided by the
 | 
						|
		hypervisor on POWER7 and 8 systems. This catalog lists events
 | 
						|
		available from the powerpc "hv_24x7" pmu. Its format is
 | 
						|
		documented here:
 | 
						|
		https://raw.githubusercontent.com/jmesmon/catalog-24x7/master/hv-24x7-catalog.h
 | 
						|
 | 
						|
What:		/sys/bus/event_source/devices/hv_24x7/interface/catalog_length
 | 
						|
Date:		February 2014
 | 
						|
Contact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
 | 
						|
Description:
 | 
						|
		A number equal to the length in bytes of the catalog. This is
 | 
						|
		also extractable from the provided binary "catalog" sysfs entry.
 | 
						|
 | 
						|
What:		/sys/bus/event_source/devices/hv_24x7/interface/catalog_version
 | 
						|
Date:		February 2014
 | 
						|
Contact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
 | 
						|
Description:
 | 
						|
		Exposes the "version" field of the 24x7 catalog. This is also
 | 
						|
		extractable from the provided binary "catalog" sysfs entry.
 | 
						|
 | 
						|
What:		/sys/devices/hv_24x7/interface/sockets
 | 
						|
Date:		May 2020
 | 
						|
Contact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
 | 
						|
Description:	read only
 | 
						|
		This sysfs interface exposes the number of sockets present in the
 | 
						|
		system.
 | 
						|
 | 
						|
What:		/sys/devices/hv_24x7/interface/chipspersocket
 | 
						|
Date:		May 2020
 | 
						|
Contact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
 | 
						|
Description:	read only
 | 
						|
		This sysfs interface exposes the number of chips per socket
 | 
						|
		present in the system.
 | 
						|
 | 
						|
What:		/sys/devices/hv_24x7/interface/coresperchip
 | 
						|
Date:		May 2020
 | 
						|
Contact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
 | 
						|
Description:	read only
 | 
						|
		This sysfs interface exposes the number of cores per chip
 | 
						|
		present in the system.
 | 
						|
 | 
						|
What:		/sys/devices/hv_24x7/cpumask
 | 
						|
Date:		July 2020
 | 
						|
Contact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
 | 
						|
Description:	read only
 | 
						|
		This sysfs file exposes the cpumask which is designated to make
 | 
						|
		HCALLs to retrieve hv-24x7 pmu event counter data.
 | 
						|
 | 
						|
What:		/sys/bus/event_source/devices/hv_24x7/event_descs/<event-name>
 | 
						|
Date:		February 2014
 | 
						|
Contact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
 | 
						|
Description:
 | 
						|
		Provides the description of a particular event as provided by
 | 
						|
		the firmware. If firmware does not provide a description, no
 | 
						|
		file will be created.
 | 
						|
 | 
						|
		Note that the event-name lacks the domain suffix appended for
 | 
						|
		events in the events/ dir.
 | 
						|
 | 
						|
What:		/sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name>
 | 
						|
Date:		February 2014
 | 
						|
Contact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
 | 
						|
Description:
 | 
						|
		Provides the "long" description of a particular event as
 | 
						|
		provided by the firmware. If firmware does not provide a
 | 
						|
		description, no file will be created.
 | 
						|
 | 
						|
		Note that the event-name lacks the domain suffix appended for
 | 
						|
		events in the events/ dir.
 |