kernel/dma/debug.c:95: warning: Function parameter or member 'stack_len' not described in 'dma_debug_entry'

From: kernel test robot
Date: Mon Dec 18 2023 - 02:25:45 EST


tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: ceb6a6f023fd3e8b07761ed900352ef574010bcb
commit: 746017ed8d4d3c2070bb03aee9536f24da43c778 dma/debug: Simplify stracktrace retrieval
date: 4 years, 8 months ago
config: x86_64-buildonly-randconfig-006-20230830 (https://download.01.org/0day-ci/archive/20231218/202312181548.9Xq6Tt63-lkp@xxxxxxxxx/config)
compiler: gcc-12 (Debian 12.2.0-14) 12.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231218/202312181548.9Xq6Tt63-lkp@xxxxxxxxx/reproduce)

If you fix the issue in a separate patch/commit (i.e. not just a new version of
the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <lkp@xxxxxxxxx>
| Closes: https://lore.kernel.org/oe-kbuild-all/202312181548.9Xq6Tt63-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

kernel/dma/debug.c:95: warning: Function parameter or member 'dev_addr' not described in 'dma_debug_entry'
>> kernel/dma/debug.c:95: warning: Function parameter or member 'stack_len' not described in 'dma_debug_entry'
>> kernel/dma/debug.c:95: warning: Function parameter or member 'stack_entries' not described in 'dma_debug_entry'


vim +95 kernel/dma/debug.c

6c132d1bcdc716 lib/dma-debug.c David Woodhouse 2009-01-19 64
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 65 /**
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 66 * struct dma_debug_entry - track a dma_map* or dma_alloc_coherent mapping
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 67 * @list: node on pre-allocated free_entries list
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 68 * @dev: 'dev' argument to dma_map_{page|single|sg} or dma_alloc_coherent
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 69 * @type: single, page, sg, coherent
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 70 * @pfn: page frame of the start address
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 71 * @offset: offset of mapping relative to pfn
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 72 * @size: length of the mapping
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 73 * @direction: enum dma_data_direction
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 74 * @sg_call_ents: 'nents' from dma_map_sg
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 75 * @sg_mapped_ents: 'mapped_ents' from dma_map_sg
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 76 * @map_err_type: track whether dma_mapping_error() was checked
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 77 * @stacktrace: support backtraces when a violation is detected
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 78 */
f2f45e5f3c921c lib/dma-debug.c Joerg Roedel 2009-01-09 79 struct dma_debug_entry {
f2f45e5f3c921c lib/dma-debug.c Joerg Roedel 2009-01-09 80 struct list_head list;
f2f45e5f3c921c lib/dma-debug.c Joerg Roedel 2009-01-09 81 struct device *dev;
f2f45e5f3c921c lib/dma-debug.c Joerg Roedel 2009-01-09 82 int type;
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 83 unsigned long pfn;
0abdd7a81b7e3f lib/dma-debug.c Dan Williams 2014-01-21 84 size_t offset;
f2f45e5f3c921c lib/dma-debug.c Joerg Roedel 2009-01-09 85 u64 dev_addr;
f2f45e5f3c921c lib/dma-debug.c Joerg Roedel 2009-01-09 86 u64 size;
f2f45e5f3c921c lib/dma-debug.c Joerg Roedel 2009-01-09 87 int direction;
f2f45e5f3c921c lib/dma-debug.c Joerg Roedel 2009-01-09 88 int sg_call_ents;
f2f45e5f3c921c lib/dma-debug.c Joerg Roedel 2009-01-09 89 int sg_mapped_ents;
6c9c6d6301287e lib/dma-debug.c Shuah Khan 2012-10-08 90 enum map_err_types map_err_type;
6c132d1bcdc716 lib/dma-debug.c David Woodhouse 2009-01-19 91 #ifdef CONFIG_STACKTRACE
746017ed8d4d3c kernel/dma/debug.c Thomas Gleixner 2019-04-25 92 unsigned int stack_len;
746017ed8d4d3c kernel/dma/debug.c Thomas Gleixner 2019-04-25 93 unsigned long stack_entries[DMA_DEBUG_STACKTRACE_ENTRIES];
6c132d1bcdc716 lib/dma-debug.c David Woodhouse 2009-01-19 94 #endif
f2f45e5f3c921c lib/dma-debug.c Joerg Roedel 2009-01-09 @95 };
f2f45e5f3c921c lib/dma-debug.c Joerg Roedel 2009-01-09 96

:::::: The code at line 95 was first introduced by commit
:::::: f2f45e5f3c921c73c913e9a9c00f21ec01c86b4d dma-debug: add header file and core data structures

:::::: TO: Joerg Roedel <joerg.roedel@xxxxxxx>
:::::: CC: Joerg Roedel <joerg.roedel@xxxxxxx>

--
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki