^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) What: /sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/wrap
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) Date: June 2015
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) KernelVersion: 4.3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Contact: Alexander Shishkin <alexander.shishkin@linux.intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) Description: (RW) Configure MSC buffer wrapping. 1 == wrapping enabled.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) What: /sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/mode
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) Date: June 2015
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) KernelVersion: 4.3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) Contact: Alexander Shishkin <alexander.shishkin@linux.intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) Description: (RW) Configure MSC operating mode:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) - "single", for contiguous buffer mode (high-order alloc);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) - "multi", for multiblock mode;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) - "ExI", for DCI handler mode;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) - "debug", for debug mode;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) - any of the currently loaded buffer sinks.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) If operating mode changes, existing buffer is deallocated,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) provided there are no active users and tracing is not enabled,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) otherwise the write will fail.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) What: /sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/nr_pages
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) Date: June 2015
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) KernelVersion: 4.3
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) Contact: Alexander Shishkin <alexander.shishkin@linux.intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) Description: (RW) Configure MSC buffer size for "single" or "multi" modes.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) In single mode, this is a single number of pages, has to be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) power of 2. In multiblock mode, this is a comma-separated list
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) of numbers of pages for each window to be allocated. Number of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) windows is not limited.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) Writing to this file deallocates existing buffer (provided
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) there are no active users and tracing is not enabled) and then
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) allocates a new one.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) What: /sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/win_switch
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) Date: May 2019
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) KernelVersion: 5.2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) Contact: Alexander Shishkin <alexander.shishkin@linux.intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) Description: (RW) Trigger window switch for the MSC's buffer, in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) multi-window mode. In "multi" mode, accepts writes of "1", thereby
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) triggering a window switch for the buffer. Returns an error in any
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) other operating mode or attempts to write something other than "1".
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) What: /sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/stop_on_full
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) Date: March 2020
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) KernelVersion: 5.7
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) Contact: Alexander Shishkin <alexander.shishkin@linux.intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) Description: (RW) Configure whether trace stops when the last available window
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) becomes full (1/y/Y) or wraps around and continues until the next
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) window becomes available again (0/n/N).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54)