Merge tag 'for-5.3/dm-changes-2' of git://git.kernel.org/pub/scm/linux/kernel/git...
[sfrench/cifs-2.6.git] / Documentation / ABI / testing / sysfs-bus-event_source-devices-format
1 What:           /sys/bus/event_source/devices/<dev>/format
2 Date:           January 2012
3 KernelVersion: 3.3
4 Contact:        Jiri Olsa <jolsa@redhat.com>
5 Description:
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.