xref: /linux/Documentation/ABI/testing/sysfs-bus-event_source-devices-format (revision a4eb44a6435d6d8f9e642407a4a06f65eb90ca04)
1What:		/sys/bus/event_source/devices/<dev>/format
2Date:		January 2012
3KernelVersion: 3.3
4Contact:	Jiri Olsa <jolsa@redhat.com>
5Description:
6		Attribute group to describe the magic bits that go into
7		perf_event_attr::config[012] for a particular pmu.
8		Each attribute of this group defines the 'hardware' bitmask
9		we want to export, so that userspace can deal with sane
10		name/value pairs.
11
12		Userspace must be prepared for the possibility that attributes
13		define overlapping bit ranges. For example::
14
15			attr1 = 'config:0-23'
16			attr2 = 'config:0-7'
17			attr3 = 'config:12-35'
18
19		Example: 'config1:1,6-10,44'
20		Defines contents of attribute that occupies bits 1,6-10,44 of
21		perf_event_attr::config1.
22