0001 What: /sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/wrap
0002 Date: June 2015
0003 KernelVersion: 4.3
0004 Contact: Alexander Shishkin <alexander.shishkin@linux.intel.com>
0005 Description: (RW) Configure MSC buffer wrapping. 1 == wrapping enabled.
0006
0007 What: /sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/mode
0008 Date: June 2015
0009 KernelVersion: 4.3
0010 Contact: Alexander Shishkin <alexander.shishkin@linux.intel.com>
0011 Description: (RW) Configure MSC operating mode:
0012
0013 - "single", for contiguous buffer mode (high-order alloc);
0014 - "multi", for multiblock mode;
0015 - "ExI", for DCI handler mode;
0016 - "debug", for debug mode;
0017 - any of the currently loaded buffer sinks.
0018
0019 If operating mode changes, existing buffer is deallocated,
0020 provided there are no active users and tracing is not enabled,
0021 otherwise the write will fail.
0022
0023 What: /sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/nr_pages
0024 Date: June 2015
0025 KernelVersion: 4.3
0026 Contact: Alexander Shishkin <alexander.shishkin@linux.intel.com>
0027 Description: (RW) Configure MSC buffer size for "single" or "multi" modes.
0028
0029 In single mode, this is a single number of pages, has to be
0030 power of 2. In multiblock mode, this is a comma-separated list
0031 of numbers of pages for each window to be allocated. Number of
0032 windows is not limited.
0033
0034 Writing to this file deallocates existing buffer (provided
0035 there are no active users and tracing is not enabled) and then
0036 allocates a new one.
0037
0038 What: /sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/win_switch
0039 Date: May 2019
0040 KernelVersion: 5.2
0041 Contact: Alexander Shishkin <alexander.shishkin@linux.intel.com>
0042 Description: (RW) Trigger window switch for the MSC's buffer, in
0043 multi-window mode. In "multi" mode, accepts writes of "1", thereby
0044 triggering a window switch for the buffer. Returns an error in any
0045 other operating mode or attempts to write something other than "1".
0046
0047 What: /sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/stop_on_full
0048 Date: March 2020
0049 KernelVersion: 5.7
0050 Contact: Alexander Shishkin <alexander.shishkin@linux.intel.com>
0051 Description: (RW) Configure whether trace stops when the last available window
0052 becomes full (1/y/Y) or wraps around and continues until the next
0053 window becomes available again (0/n/N).
0054
