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