hc
2024-10-12 a5969cabbb4660eab42b6ef0412cbbd1200cf14d
kernel/Documentation/ABI/testing/sysfs-bus-intel_th-devices-msc
....@@ -9,10 +9,13 @@
99 KernelVersion: 4.3
1010 Contact: Alexander Shishkin <alexander.shishkin@linux.intel.com>
1111 Description: (RW) Configure MSC operating mode:
12
+
1213 - "single", for contiguous buffer mode (high-order alloc);
1314 - "multi", for multiblock mode;
1415 - "ExI", for DCI handler mode;
15
- - "debug", for debug mode.
16
+ - "debug", for debug mode;
17
+ - any of the currently loaded buffer sinks.
18
+
1619 If operating mode changes, existing buffer is deallocated,
1720 provided there are no active users and tracing is not enabled,
1821 otherwise the write will fail.
....@@ -22,12 +25,30 @@
2225 KernelVersion: 4.3
2326 Contact: Alexander Shishkin <alexander.shishkin@linux.intel.com>
2427 Description: (RW) Configure MSC buffer size for "single" or "multi" modes.
28
+
2529 In single mode, this is a single number of pages, has to be
2630 power of 2. In multiblock mode, this is a comma-separated list
2731 of numbers of pages for each window to be allocated. Number of
2832 windows is not limited.
33
+
2934 Writing to this file deallocates existing buffer (provided
3035 there are no active users and tracing is not enabled) and then
3136 allocates a new one.
3237
38
+What: /sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/win_switch
39
+Date: May 2019
40
+KernelVersion: 5.2
41
+Contact: Alexander Shishkin <alexander.shishkin@linux.intel.com>
42
+Description: (RW) Trigger window switch for the MSC's buffer, in
43
+ multi-window mode. In "multi" mode, accepts writes of "1", thereby
44
+ triggering a window switch for the buffer. Returns an error in any
45
+ other operating mode or attempts to write something other than "1".
46
+
47
+What: /sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/stop_on_full
48
+Date: March 2020
49
+KernelVersion: 5.7
50
+Contact: Alexander Shishkin <alexander.shishkin@linux.intel.com>
51
+Description: (RW) Configure whether trace stops when the last available window
52
+ becomes full (1/y/Y) or wraps around and continues until the next
53
+ window becomes available again (0/n/N).
3354