1ed66bcd0SMauro Carvalho ChehabWhat:		/sys/bus/event_source/devices/<dev>/format
2641cc938SJiri OlsaDate:		January 2012
3641cc938SJiri OlsaKernelVersion: 3.3
4641cc938SJiri OlsaContact:	Jiri Olsa <jolsa@redhat.com>
5641cc938SJiri OlsaDescription:
6641cc938SJiri Olsa		Attribute group to describe the magic bits that go into
7641cc938SJiri Olsa		perf_event_attr::config[012] for a particular pmu.
8641cc938SJiri Olsa		Each attribute of this group defines the 'hardware' bitmask
9641cc938SJiri Olsa		we want to export, so that userspace can deal with sane
10641cc938SJiri Olsa		name/value pairs.
11641cc938SJiri Olsa
12fd851780SMichael Ellerman		Userspace must be prepared for the possibility that attributes
1334433332SMauro Carvalho Chehab		define overlapping bit ranges. For example::
1434433332SMauro Carvalho Chehab
15fd851780SMichael Ellerman			attr1 = 'config:0-23'
16fd851780SMichael Ellerman			attr2 = 'config:0-7'
17fd851780SMichael Ellerman			attr3 = 'config:12-35'
18fd851780SMichael Ellerman
19641cc938SJiri Olsa		Example: 'config1:1,6-10,44'
20641cc938SJiri Olsa		Defines contents of attribute that occupies bits 1,6-10,44 of
21641cc938SJiri Olsa		perf_event_attr::config1.
22