xref: /linux/Documentation/ABI/testing/sysfs-bus-event_source-devices-format (revision 827634added7f38b7d724cab1dccdb2b004c13c3)
1Where:		/sys/bus/event_source/devices/<dev>/format
2Date:		January 2012
3Kernel Version: 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			attr1 = 'config:0-23'
15			attr2 = 'config:0-7'
16			attr3 = 'config:12-35'
17
18		Example: 'config1:1,6-10,44'
19		Defines contents of attribute that occupies bits 1,6-10,44 of
20		perf_event_attr::config1.
21