[linux-next:master 939/1400] drivers/dma/at_hdmac.c:255: warning: Enum value 'ATC_IS_PAUSED' not described in enum 'atc_status'

[kernel test robot <lkp@intel.com>]

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@intel.com/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@intel.com/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@intel.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202401231518.8q9LD8n7-lkp@intel.com/

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@microchip.com>
:::::: CC: Vinod Koul <vkoul@kernel.org>

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