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