xref: /linux/Documentation/ABI/testing/sysfs-bus-intel_th-devices-msc (revision cdd38c5f1ce4398ec58fec95904b75824daab7b5)
1ba82664cSAlexander ShishkinWhat:		/sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/wrap
2ba82664cSAlexander ShishkinDate:		June 2015
3ba82664cSAlexander ShishkinKernelVersion:	4.3
4ba82664cSAlexander ShishkinContact:	Alexander Shishkin <alexander.shishkin@linux.intel.com>
5ba82664cSAlexander ShishkinDescription:	(RW) Configure MSC buffer wrapping. 1 == wrapping enabled.
6ba82664cSAlexander Shishkin
7ba82664cSAlexander ShishkinWhat:		/sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/mode
8ba82664cSAlexander ShishkinDate:		June 2015
9ba82664cSAlexander ShishkinKernelVersion:	4.3
10ba82664cSAlexander ShishkinContact:	Alexander Shishkin <alexander.shishkin@linux.intel.com>
11ba82664cSAlexander ShishkinDescription:	(RW) Configure MSC operating mode:
12*34433332SMauro Carvalho Chehab
13ba82664cSAlexander Shishkin		  - "single", for contiguous buffer mode (high-order alloc);
14ba82664cSAlexander Shishkin		  - "multi", for multiblock mode;
15ba82664cSAlexander Shishkin		  - "ExI", for DCI handler mode;
16615c164dSAlexander Shishkin		  - "debug", for debug mode;
17615c164dSAlexander Shishkin		  - any of the currently loaded buffer sinks.
18*34433332SMauro Carvalho Chehab
19ba82664cSAlexander Shishkin		If operating mode changes, existing buffer is deallocated,
20ba82664cSAlexander Shishkin		provided there are no active users and tracing is not enabled,
21ba82664cSAlexander Shishkin		otherwise the write will fail.
22ba82664cSAlexander Shishkin
23ba82664cSAlexander ShishkinWhat:		/sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/nr_pages
24ba82664cSAlexander ShishkinDate:		June 2015
25ba82664cSAlexander ShishkinKernelVersion:	4.3
26ba82664cSAlexander ShishkinContact:	Alexander Shishkin <alexander.shishkin@linux.intel.com>
27ba82664cSAlexander ShishkinDescription:	(RW) Configure MSC buffer size for "single" or "multi" modes.
28*34433332SMauro Carvalho Chehab
29ba82664cSAlexander Shishkin		In single mode, this is a single number of pages, has to be
30ba82664cSAlexander Shishkin		power of 2. In multiblock mode, this is a comma-separated list
31ba82664cSAlexander Shishkin		of numbers of pages for each window to be allocated. Number of
32ba82664cSAlexander Shishkin		windows is not limited.
33*34433332SMauro Carvalho Chehab
34ba82664cSAlexander Shishkin		Writing to this file deallocates existing buffer (provided
35ba82664cSAlexander Shishkin		there are no active users and tracing is not enabled) and then
36ba82664cSAlexander Shishkin		allocates a new one.
37ba82664cSAlexander Shishkin
386cac7866SAlexander ShishkinWhat:		/sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/win_switch
396cac7866SAlexander ShishkinDate:		May 2019
406cac7866SAlexander ShishkinKernelVersion:	5.2
416cac7866SAlexander ShishkinContact:	Alexander Shishkin <alexander.shishkin@linux.intel.com>
426cac7866SAlexander ShishkinDescription:	(RW) Trigger window switch for the MSC's buffer, in
436cac7866SAlexander Shishkin		multi-window mode. In "multi" mode, accepts writes of "1", thereby
446cac7866SAlexander Shishkin		triggering a window switch for the buffer. Returns an error in any
456cac7866SAlexander Shishkin		other operating mode or attempts to write something other than "1".
46ba82664cSAlexander Shishkin
478622dfefSAlexander ShishkinWhat:		/sys/bus/intel_th/devices/<intel_th_id>-msc<msc-id>/stop_on_full
488622dfefSAlexander ShishkinDate:		March 2020
498622dfefSAlexander ShishkinKernelVersion:	5.7
508622dfefSAlexander ShishkinContact:	Alexander Shishkin <alexander.shishkin@linux.intel.com>
518622dfefSAlexander ShishkinDescription:	(RW) Configure whether trace stops when the last available window
528622dfefSAlexander Shishkin		becomes full (1/y/Y) or wraps around and continues until the next
538622dfefSAlexander Shishkin		window becomes available again (0/n/N).
548622dfefSAlexander Shishkin
55