[anolis-intel-cloud:devel-6.6 50/50] kernel/dma/swiotlb.c:1461: warning: Function parameter or member 'pool' not described in 'swiotlb_del_transient'

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

Hi Michael,

FYI, the error/warning was bisected to this commit, please ignore it if it's irrelevant.

tree:   https://gitee.com/anolis/intel-cloud-kernel.git devel-6.6
head:   5d719013902eb006756873427de3fc5cc5566531
commit: 2f831790e2636c9b6820ca88cb47acb24a88e1c0 [50/50] swiotlb: reduce swiotlb pool lookups
config: x86_64-allnoconfig-bpf (https://download.01.org/0day-ci/archive/20251218/202512181433.4BDW2ph5-lkp@intel.com/config)
compiler: gcc-14 (Debian 14.2.0-19) 14.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20251218/202512181433.4BDW2ph5-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/202512181433.4BDW2ph5-lkp@intel.com/

All warnings (new ones prefixed by >>):

>> kernel/dma/swiotlb.c:1461: warning: Function parameter or member 'pool' not described in 'swiotlb_del_transient'


vim +1461 kernel/dma/swiotlb.c

79636caad3618e Petr Tesarik   2023-08-01  1448  
79636caad3618e Petr Tesarik   2023-08-01  1449  /**
79636caad3618e Petr Tesarik   2023-08-01  1450   * swiotlb_del_transient() - delete a transient memory pool
79636caad3618e Petr Tesarik   2023-08-01  1451   * @dev:	Device which mapped the buffer.
79636caad3618e Petr Tesarik   2023-08-01  1452   * @tlb_addr:	Physical address within a bounce buffer.
79636caad3618e Petr Tesarik   2023-08-01  1453   *
79636caad3618e Petr Tesarik   2023-08-01  1454   * Check whether the address belongs to a transient SWIOTLB memory pool.
79636caad3618e Petr Tesarik   2023-08-01  1455   * If yes, then delete the pool.
79636caad3618e Petr Tesarik   2023-08-01  1456   *
79636caad3618e Petr Tesarik   2023-08-01  1457   * Return: %true if @tlb_addr belonged to a transient pool that was released.
79636caad3618e Petr Tesarik   2023-08-01  1458   */
2f831790e2636c Michael Kelley 2024-07-08  1459  static bool swiotlb_del_transient(struct device *dev, phys_addr_t tlb_addr,
2f831790e2636c Michael Kelley 2024-07-08  1460  		struct io_tlb_pool *pool)
79636caad3618e Petr Tesarik   2023-08-01 @1461  {
79636caad3618e Petr Tesarik   2023-08-01  1462  	if (!pool->transient)
79636caad3618e Petr Tesarik   2023-08-01  1463  		return false;
79636caad3618e Petr Tesarik   2023-08-01  1464  
79636caad3618e Petr Tesarik   2023-08-01  1465  	dec_used(dev->dma_io_tlb_mem, pool->nslabs);
79636caad3618e Petr Tesarik   2023-08-01  1466  	swiotlb_del_pool(dev, pool);
79636caad3618e Petr Tesarik   2023-08-01  1467  	return true;
79636caad3618e Petr Tesarik   2023-08-01  1468  }
79636caad3618e Petr Tesarik   2023-08-01  1469  

:::::: The code at line 1461 was first introduced by commit
:::::: 79636caad3618e2b38457f6e298c9b31ba82b489 swiotlb: if swiotlb is full, fall back to a transient memory pool

:::::: TO: Petr Tesarik <petr.tesarik.ext@huawei.com>
:::::: CC: Christoph Hellwig <hch@lst.de>

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