Skip to content

Commit 04190ec

Browse files
virtuosogregkh
authored andcommitted
intel_th: msu: Fix less trivial kernel-doc warnings
Correct function comments to prevent kernel-doc warnings found when using "W=1" that the drive-by fixers had trouble documenting and skipped over. msu.c:168: warning: Function parameter or struct member 'msu_base' not described in 'msc' msu.c:168: warning: Function parameter or struct member 'work' not described in 'msc' msu.c:168: warning: Function parameter or struct member 'switch_on_unlock' not described in 'msc' msu.c:168: warning: Function parameter or struct member 'iter_list' not described in 'msc' msu.c:168: warning: Function parameter or struct member 'stop_on_full' not described in 'msc' msu.c:168: warning: Function parameter or struct member 'do_irq' not described in 'msc' msu.c:168: warning: Function parameter or struct member 'multi_is_broken' not described in 'msc' Signed-off-by: Alexander Shishkin <alexander.shishkin@linux.intel.com> Reviewed-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com> Link: https://lore.kernel.org/r/20250211185017.1759193-3-alexander.shishkin@linux.intel.com Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
1 parent 4738d3d commit 04190ec

File tree

1 file changed

+8
-1
lines changed
  • drivers/hwtracing/intel_th

1 file changed

+8
-1
lines changed

drivers/hwtracing/intel_th/msu.c

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -105,13 +105,16 @@ struct msc_iter {
105105

106106
/**
107107
* struct msc - MSC device representation
108-
* @reg_base: register window base address
108+
* @reg_base: register window base address for the entire MSU
109+
* @msu_base: register window base address for this MSC
109110
* @thdev: intel_th_device pointer
110111
* @mbuf: MSU buffer, if assigned
111112
* @mbuf_priv: MSU buffer's private data, if @mbuf
113+
* @work: a work to stop the trace when the buffer is full
112114
* @win_list: list of windows in multiblock mode
113115
* @single_sgt: single mode buffer
114116
* @cur_win: current window
117+
* @switch_on_unlock: window to switch to when it becomes available
115118
* @nr_pages: total number of pages allocated for this buffer
116119
* @single_sz: amount of data in single mode
117120
* @single_wrap: single mode wrap occurred
@@ -122,8 +125,12 @@ struct msc_iter {
122125
* @user_count: number of users of the buffer
123126
* @mmap_count: number of mappings
124127
* @buf_mutex: mutex to serialize access to buffer-related bits
128+
* @iter_list: list of open file descriptor iterators
129+
* @stop_on_full: stop the trace if the current window is full
125130
* @enabled: MSC is enabled
126131
* @wrap: wrapping is enabled
132+
* @do_irq: IRQ resource is available, handle interrupts
133+
* @multi_is_broken: multiblock mode enabled (not disabled by PCI drvdata)
127134
* @mode: MSC operating mode
128135
* @burst_len: write burst length
129136
* @index: number of this MSC in the MSU

0 commit comments

Comments
 (0)