tree: https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git master head: 774551425799cb5bbac94e1768fd69eec4f78dd4 commit: e4cec073b7755a78030f30cf627141c759035b50 [939/1400] dmaengine: at_hdmac: fix some kernel-doc warnings config: arm-multi_v5_defconfig (https://download.01.org/0day-ci/archive/20240123/202401231518.8q9LD8n7-lkp@xxxxxxxxx/config) compiler: arm-linux-gnueabi-gcc (GCC) 13.2.0 reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20240123/202401231518.8q9LD8n7-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/202401231518.8q9LD8n7-lkp@xxxxxxxxx/ All warnings (new ones prefixed by >>): drivers/dma/at_hdmac.c:243: warning: Function parameter or struct member 'boundary' not described in 'at_desc' drivers/dma/at_hdmac.c:243: warning: Function parameter or struct member 'dst_hole' not described in 'at_desc' drivers/dma/at_hdmac.c:243: warning: Function parameter or struct member 'src_hole' not described in 'at_desc' drivers/dma/at_hdmac.c:243: warning: Function parameter or struct member 'memset_buffer' not described in 'at_desc' drivers/dma/at_hdmac.c:243: warning: Function parameter or struct member 'memset_paddr' not described in 'at_desc' drivers/dma/at_hdmac.c:243: warning: Function parameter or struct member 'memset_vaddr' not described in 'at_desc' >> drivers/dma/at_hdmac.c:255: warning: Enum value 'ATC_IS_PAUSED' not described in enum 'atc_status' >> drivers/dma/at_hdmac.c:255: warning: Enum value 'ATC_IS_CYCLIC' not described in enum 'atc_status' drivers/dma/at_hdmac.c:287: warning: Function parameter or struct member 'cyclic' not described in 'at_dma_chan' drivers/dma/at_hdmac.c:350: warning: Function parameter or struct member 'memset_pool' not described in 'at_dma' vim +255 drivers/dma/at_hdmac.c ac803b56860f65 Tudor Ambarus 2022-10-25 219 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 220 /** 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 221 * struct at_desc - software descriptor ac803b56860f65 Tudor Ambarus 2022-10-25 222 * @vd: pointer to the virtual dma descriptor. ac803b56860f65 Tudor Ambarus 2022-10-25 223 * @atchan: pointer to the atmel dma channel. 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 224 * @total_len: total transaction byte count e4cec073b7755a Randy Dunlap 2024-01-20 225 * @sglen: number of sg entries. ac803b56860f65 Tudor Ambarus 2022-10-25 226 * @sg: array of sgs. 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 227 */ 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 228 struct at_desc { ac803b56860f65 Tudor Ambarus 2022-10-25 229 struct virt_dma_desc vd; ac803b56860f65 Tudor Ambarus 2022-10-25 230 struct at_dma_chan *atchan; 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 231 size_t total_len; ac803b56860f65 Tudor Ambarus 2022-10-25 232 unsigned int sglen; 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 233 /* Interleaved data */ 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 234 size_t boundary; 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 235 size_t dst_hole; 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 236 size_t src_hole; 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 237 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 238 /* Memset temporary buffer */ 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 239 bool memset_buffer; 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 240 dma_addr_t memset_paddr; 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 241 int *memset_vaddr; 81cd3cb3b3dd37 Kees Cook 2023-08-17 242 struct atdma_sg sg[] __counted_by(sglen); 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 @243 }; 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 244 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 245 /*-- Channels --------------------------------------------------------*/ 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 246 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 247 /** e4cec073b7755a Randy Dunlap 2024-01-20 248 * enum atc_status - information bits stored in channel status flag 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 249 * 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 250 * Manipulated with atomic operations. 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 251 */ 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 252 enum atc_status { 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 253 ATC_IS_PAUSED = 1, 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 254 ATC_IS_CYCLIC = 24, 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 @255 }; 5cecadc3e2a4fb Tudor Ambarus 2022-10-25 256 :::::: The code at line 255 was first introduced by commit :::::: 5cecadc3e2a4fb72ab37d9420df0a9e1179b8a3e dmaengine: at_hdmac: Keep register definitions and structures private to at_hdmac.c :::::: TO: Tudor Ambarus <tudor.ambarus@xxxxxxxxxxxxx> :::::: CC: Vinod Koul <vkoul@xxxxxxxxxx> -- 0-DAY CI Kernel Test Service https://github.com/intel/lkp-tests/wiki
