| Andrew Scull | b4b6d4a | 2019-01-02 15:54:55 +0000 | [diff] [blame] | 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: |
| Olivier Deprez | 157378f | 2022-04-04 15:47:50 +0200 | [diff] [blame^] | 12 | |
| Andrew Scull | b4b6d4a | 2019-01-02 15:54:55 +0000 | [diff] [blame] | 13 | - "single", for contiguous buffer mode (high-order alloc); |
| 14 | - "multi", for multiblock mode; |
| 15 | - "ExI", for DCI handler mode; |
| David Brazdil | 0f672f6 | 2019-12-10 10:32:29 +0000 | [diff] [blame] | 16 | - "debug", for debug mode; |
| 17 | - any of the currently loaded buffer sinks. |
| Olivier Deprez | 157378f | 2022-04-04 15:47:50 +0200 | [diff] [blame^] | 18 | |
| Andrew Scull | b4b6d4a | 2019-01-02 15:54:55 +0000 | [diff] [blame] | 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. |
| Olivier Deprez | 157378f | 2022-04-04 15:47:50 +0200 | [diff] [blame^] | 28 | |
| Andrew Scull | b4b6d4a | 2019-01-02 15:54:55 +0000 | [diff] [blame] | 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. |
| Olivier Deprez | 157378f | 2022-04-04 15:47:50 +0200 | [diff] [blame^] | 33 | |
| Andrew Scull | b4b6d4a | 2019-01-02 15:54:55 +0000 | [diff] [blame] | 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 | |
| David Brazdil | 0f672f6 | 2019-12-10 10:32:29 +0000 | [diff] [blame] | 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". |
| Andrew Scull | b4b6d4a | 2019-01-02 15:54:55 +0000 | [diff] [blame] | 46 | |
| Olivier Deprez | 157378f | 2022-04-04 15:47:50 +0200 | [diff] [blame^] | 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 | |