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