drivers/virtio/virtio_dma_buf.c:41: warning: Function parameter or member 'dma_buf' not described in 'virtio_dma_buf_attach'

From: kernel test robot
Date: Sun Dec 10 2023 - 16:05:14 EST


tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 3a87498869d6d1e7347cd01f337a77984604eb5e
commit: a0308938ec81cd0dca9d75833ec0dd1b8708917e virtio: add dma-buf support for exported objects
date: 3 years, 4 months ago
config: parisc-randconfig-m041-20230821 (https://download.01.org/0day-ci/archive/20231211/202312110445.z6bDltrY-lkp@xxxxxxxxx/config)
compiler: hppa-linux-gcc (GCC) 12.3.0
reproduce: (https://download.01.org/0day-ci/archive/20231211/202312110445.z6bDltrY-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/202312110445.z6bDltrY-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

>> drivers/virtio/virtio_dma_buf.c:41: warning: Function parameter or member 'dma_buf' not described in 'virtio_dma_buf_attach'
>> drivers/virtio/virtio_dma_buf.c:41: warning: Function parameter or member 'attach' not described in 'virtio_dma_buf_attach'


vim +41 drivers/virtio/virtio_dma_buf.c

35
36 /**
37 * virtio_dma_buf_attach - mandatory attach callback for virtio dma-bufs
38 */
39 int virtio_dma_buf_attach(struct dma_buf *dma_buf,
40 struct dma_buf_attachment *attach)
> 41 {
42 int ret;
43 const struct virtio_dma_buf_ops *ops =
44 container_of(dma_buf->ops,
45 const struct virtio_dma_buf_ops, ops);
46
47 if (ops->device_attach) {
48 ret = ops->device_attach(dma_buf, attach);
49 if (ret)
50 return ret;
51 }
52 return 0;
53 }
54 EXPORT_SYMBOL(virtio_dma_buf_attach);
55

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