Linux 6.7-rc7
[linux-modified.git] / Documentation / ABI / testing / sysfs-bus-event_source-devices-iommu
1 What:           /sys/bus/event_source/devices/dmar*/format
2 Date:           Jan 2023
3 KernelVersion:  6.3
4 Contact:        Kan Liang <kan.liang@linux.intel.com>
5 Description:    Read-only.  Attribute group to describe the magic bits
6                 that go into perf_event_attr.config,
7                 perf_event_attr.config1 or perf_event_attr.config2 for
8                 the IOMMU pmu.  (See also
9                 ABI/testing/sysfs-bus-event_source-devices-format).
10
11                 Each attribute in this group defines a bit range in
12                 perf_event_attr.config, perf_event_attr.config1,
13                 or perf_event_attr.config2. All supported attributes
14                 are listed below (See the VT-d Spec 4.0 for possible
15                 attribute values)::
16
17                     event               = "config:0-27"   - event ID
18                     event_group         = "config:28-31"  - event group ID
19
20                     filter_requester_en = "config1:0"     - Enable Requester ID filter
21                     filter_domain_en    = "config1:1"     - Enable Domain ID filter
22                     filter_pasid_en     = "config1:2"     - Enable PASID filter
23                     filter_ats_en       = "config1:3"     - Enable Address Type filter
24                     filter_page_table_en= "config1:4"     - Enable Page Table Level filter
25                     filter_requester_id = "config1:16-31" - Requester ID filter
26                     filter_domain       = "config1:32-47" - Domain ID filter
27                     filter_pasid        = "config2:0-21"  - PASID filter
28                     filter_ats          = "config2:24-28" - Address Type filter
29                     filter_page_table   = "config2:32-36" - Page Table Level filter
30
31 What:           /sys/bus/event_source/devices/dmar*/cpumask
32 Date:           Jan 2023
33 KernelVersion:  6.3
34 Contact:        Kan Liang <kan.liang@linux.intel.com>
35 Description:    Read-only. This file always returns the CPU to which the
36                 IOMMU pmu is bound for access to all IOMMU pmu performance
37                 monitoring events.