========== kdoc - FAILED Warnings before patch: files: ['Documentation/core-api/dma-api-howto.rst', 'Documentation/core-api/dma-attributes.rst', 'Documentation/userspace-api/vduse.rst', 'drivers/char/hw_random/virtio-rng.c', 'drivers/gpio/gpio-virtio.c', 'drivers/scsi/virtio_scsi.c', 'drivers/vdpa/mlx5/net/mlx5_vnet.c', 'drivers/vdpa/vdpa_sim/vdpa_sim.c', 'drivers/vdpa/vdpa_user/iova_domain.c', 'drivers/vdpa/vdpa_user/iova_domain.h', 'drivers/vdpa/vdpa_user/vduse_dev.c', 'drivers/vhost/vdpa.c', 'drivers/vhost/vhost.c', 'drivers/virtio/virtio_input.c', 'drivers/virtio/virtio_ring.c', 'include/linux/dma-mapping.h', 'include/linux/vdpa.h', 'include/linux/virtio.h', 'include/uapi/linux/vduse.h', 'include/uapi/linux/virtio_ring.h', 'kernel/dma/debug.c', 'net/vmw_vsock/virtio_transport.c', 'scripts/checkpatch.pl'] : * List of possible attributes associated with a DMA mapping. The semantics Warning: drivers/scsi/virtio_scsi.c:497 No description found for return value of 'virtscsi_add_cmd' Warning: drivers/scsi/virtio_scsi.c:694 No description found for return value of 'virtscsi_change_queue_depth' Warning: drivers/virtio/virtio_ring.c:2308 No description found for return value of 'virtqueue_add_sgs' Warning: drivers/virtio/virtio_ring.c:2340 No description found for return value of 'virtqueue_add_outbuf' Warning: drivers/virtio/virtio_ring.c:2385 No description found for return value of 'virtqueue_add_inbuf' Warning: drivers/virtio/virtio_ring.c:2409 No description found for return value of 'virtqueue_add_inbuf_ctx' Warning: drivers/virtio/virtio_ring.c:2446 No description found for return value of 'virtqueue_dma_dev' Warning: drivers/virtio/virtio_ring.c:2468 No description found for return value of 'virtqueue_kick_prepare' Warning: drivers/virtio/virtio_ring.c:2485 No description found for return value of 'virtqueue_notify' Warning: drivers/virtio/virtio_ring.c:2513 No description found for return value of 'virtqueue_kick' Warning: drivers/virtio/virtio_ring.c:2539 No description found for return value of 'virtqueue_get_buf_ctx' Warning: drivers/virtio/virtio_ring.c:2585 No description found for return value of 'virtqueue_enable_cb_prepare' Warning: drivers/virtio/virtio_ring.c:2606 No description found for return value of 'virtqueue_poll' Warning: drivers/virtio/virtio_ring.c:2630 No description found for return value of 'virtqueue_enable_cb' Warning: drivers/virtio/virtio_ring.c:2651 No description found for return value of 'virtqueue_enable_cb_delayed' Warning: drivers/virtio/virtio_ring.c:2671 No description found for return value of 'virtqueue_detach_unused_buf' Warning: drivers/virtio/virtio_ring.c:2693 No description found for return value of 'vring_interrupt' Warning: drivers/virtio/virtio_ring.c:2801 No description found for return value of 'virtqueue_resize' Warning: drivers/virtio/virtio_ring.c:2851 No description found for return value of 'virtqueue_reset' Warning: drivers/virtio/virtio_ring.c:3010 No description found for return value of 'virtqueue_get_vring_size' Warning: drivers/virtio/virtio_ring.c:3153 No description found for return value of 'virtqueue_map_alloc_coherent' Warning: drivers/virtio/virtio_ring.c:3201 No description found for return value of 'virtqueue_map_page_attrs' Warning: drivers/virtio/virtio_ring.c:3258 No description found for return value of 'virtqueue_map_single_attrs' Warning: drivers/virtio/virtio_ring.c:3309 No description found for return value of 'virtqueue_map_mapping_error' Warning: drivers/virtio/virtio_ring.c:3327 No description found for return value of 'virtqueue_map_need_sync' Warning: include/linux/dma-mapping.h:11 This comment starts with '/**', but isn't a kernel-doc comment. Refer to Documentation/doc-guide/kernel-doc.rst * List of possible attributes associated with a DMA mapping. The semantics Warning: include/linux/dma-mapping.h:337 No description found for return value of 'dma_use_iova' Warning: include/linux/dma-mapping.h:667 No description found for return value of 'dma_get_seg_boundary_nr_pages' Warning: include/linux/virtio.h:183 struct member 'map' not described in 'virtio_device' Warning: include/linux/virtio.h:183 struct member 'VIRTIO_DECLARE_FEATURES(features' not described in 'virtio_device' Warning: include/linux/virtio.h:183 struct member 'vmap' not described in 'virtio_device' Warning: drivers/scsi/virtio_scsi.c:497 No description found for return value of 'virtscsi_add_cmd' Warning: drivers/scsi/virtio_scsi.c:694 No description found for return value of 'virtscsi_change_queue_depth' Warning: drivers/virtio/virtio_ring.c:2308 No description found for return value of 'virtqueue_add_sgs' Warning: drivers/virtio/virtio_ring.c:2340 No description found for return value of 'virtqueue_add_outbuf' Warning: drivers/virtio/virtio_ring.c:2385 No description found for return value of 'virtqueue_add_inbuf' Warning: drivers/virtio/virtio_ring.c:2409 No description found for return value of 'virtqueue_add_inbuf_ctx' Warning: drivers/virtio/virtio_ring.c:2446 No description found for return value of 'virtqueue_dma_dev' Warning: drivers/virtio/virtio_ring.c:2468 No description found for return value of 'virtqueue_kick_prepare' Warning: drivers/virtio/virtio_ring.c:2485 No description found for return value of 'virtqueue_notify' Warning: drivers/virtio/virtio_ring.c:2513 No description found for return value of 'virtqueue_kick' Warning: drivers/virtio/virtio_ring.c:2539 No description found for return value of 'virtqueue_get_buf_ctx' Warning: drivers/virtio/virtio_ring.c:2585 No description found for return value of 'virtqueue_enable_cb_prepare' Warning: drivers/virtio/virtio_ring.c:2606 No description found for return value of 'virtqueue_poll' Warning: drivers/virtio/virtio_ring.c:2630 No description found for return value of 'virtqueue_enable_cb' Warning: drivers/virtio/virtio_ring.c:2651 No description found for return value of 'virtqueue_enable_cb_delayed' Warning: drivers/virtio/virtio_ring.c:2671 No description found for return value of 'virtqueue_detach_unused_buf' Warning: drivers/virtio/virtio_ring.c:2693 No description found for return value of 'vring_interrupt' Warning: drivers/virtio/virtio_ring.c:2801 No description found for return value of 'virtqueue_resize' Warning: drivers/virtio/virtio_ring.c:2851 No description found for return value of 'virtqueue_reset' Warning: drivers/virtio/virtio_ring.c:3010 No description found for return value of 'virtqueue_get_vring_size' Warning: drivers/virtio/virtio_ring.c:3153 No description found for return value of 'virtqueue_map_alloc_coherent' Warning: drivers/virtio/virtio_ring.c:3201 No description found for return value of 'virtqueue_map_page_attrs' Warning: drivers/virtio/virtio_ring.c:3258 No description found for return value of 'virtqueue_map_single_attrs' Warning: drivers/virtio/virtio_ring.c:3309 No description found for return value of 'virtqueue_map_mapping_error' Warning: drivers/virtio/virtio_ring.c:3327 No description found for return value of 'virtqueue_map_need_sync' Warning: include/linux/dma-mapping.h:337 No description found for return value of 'dma_use_iova' Warning: include/linux/dma-mapping.h:667 No description found for return value of 'dma_get_seg_boundary_nr_pages' Warning: include/linux/virtio.h:183 struct member 'map' not described in 'virtio_device' Warning: include/linux/virtio.h:183 struct member 'VIRTIO_DECLARE_FEATURES(features' not described in 'virtio_device' Warning: include/linux/virtio.h:183 struct member 'vmap' not described in 'virtio_device' Current warnings: files: ['Documentation/core-api/dma-api-howto.rst', 'Documentation/core-api/dma-attributes.rst', 'Documentation/userspace-api/vduse.rst', 'drivers/char/hw_random/virtio-rng.c', 'drivers/gpio/gpio-virtio.c', 'drivers/scsi/virtio_scsi.c', 'drivers/vdpa/mlx5/net/mlx5_vnet.c', 'drivers/vdpa/vdpa_sim/vdpa_sim.c', 'drivers/vdpa/vdpa_user/iova_domain.c', 'drivers/vdpa/vdpa_user/iova_domain.h', 'drivers/vdpa/vdpa_user/vduse_dev.c', 'drivers/vhost/vdpa.c', 'drivers/vhost/vhost.c', 'drivers/virtio/virtio_input.c', 'drivers/virtio/virtio_ring.c', 'include/linux/dma-mapping.h', 'include/linux/vdpa.h', 'include/linux/virtio.h', 'include/uapi/linux/vduse.h', 'include/uapi/linux/virtio_ring.h', 'kernel/dma/debug.c', 'net/vmw_vsock/virtio_transport.c', 'scripts/checkpatch.pl'] : * List of possible attributes associated with a DMA mapping. The semantics Warning: drivers/scsi/virtio_scsi.c:504 No description found for return value of 'virtscsi_add_cmd' Warning: drivers/scsi/virtio_scsi.c:701 No description found for return value of 'virtscsi_change_queue_depth' Warning: drivers/virtio/virtio_ring.c:2825 No description found for return value of 'virtqueue_add_sgs' Warning: drivers/virtio/virtio_ring.c:2857 No description found for return value of 'virtqueue_add_outbuf' Warning: drivers/virtio/virtio_ring.c:2902 No description found for return value of 'virtqueue_add_inbuf' Warning: drivers/virtio/virtio_ring.c:2929 No description found for return value of 'virtqueue_add_inbuf_cache_clean' Warning: drivers/virtio/virtio_ring.c:2954 No description found for return value of 'virtqueue_add_inbuf_ctx' Warning: drivers/virtio/virtio_ring.c:2991 No description found for return value of 'virtqueue_dma_dev' Warning: drivers/virtio/virtio_ring.c:3013 No description found for return value of 'virtqueue_kick_prepare' Warning: drivers/virtio/virtio_ring.c:3029 No description found for return value of 'virtqueue_notify' Warning: drivers/virtio/virtio_ring.c:3057 No description found for return value of 'virtqueue_kick' Warning: drivers/virtio/virtio_ring.c:3083 No description found for return value of 'virtqueue_get_buf_ctx' Warning: drivers/virtio/virtio_ring.c:3125 No description found for return value of 'virtqueue_enable_cb_prepare' Warning: drivers/virtio/virtio_ring.c:3145 No description found for return value of 'virtqueue_poll' Warning: drivers/virtio/virtio_ring.c:3169 No description found for return value of 'virtqueue_enable_cb' Warning: drivers/virtio/virtio_ring.c:3190 No description found for return value of 'virtqueue_enable_cb_delayed' Warning: drivers/virtio/virtio_ring.c:3209 No description found for return value of 'virtqueue_detach_unused_buf' Warning: drivers/virtio/virtio_ring.c:3230 No description found for return value of 'vring_interrupt' Warning: drivers/virtio/virtio_ring.c:3338 No description found for return value of 'virtqueue_resize' Warning: drivers/virtio/virtio_ring.c:3385 No description found for return value of 'virtqueue_reset' Warning: drivers/virtio/virtio_ring.c:3543 No description found for return value of 'virtqueue_get_vring_size' Warning: drivers/virtio/virtio_ring.c:3687 No description found for return value of 'virtqueue_map_alloc_coherent' Warning: drivers/virtio/virtio_ring.c:3735 No description found for return value of 'virtqueue_map_page_attrs' Warning: drivers/virtio/virtio_ring.c:3792 No description found for return value of 'virtqueue_map_single_attrs' Warning: drivers/virtio/virtio_ring.c:3843 No description found for return value of 'virtqueue_map_mapping_error' Warning: drivers/virtio/virtio_ring.c:3861 No description found for return value of 'virtqueue_map_need_sync' Warning: include/linux/dma-mapping.h:12 This comment starts with '/**', but isn't a kernel-doc comment. Refer to Documentation/doc-guide/kernel-doc.rst * List of possible attributes associated with a DMA mapping. The semantics Warning: include/linux/dma-mapping.h:345 No description found for return value of 'dma_use_iova' Warning: include/linux/dma-mapping.h:675 No description found for return value of 'dma_get_seg_boundary_nr_pages' Warning: include/linux/virtio.h:188 struct member 'map' not described in 'virtio_device' Warning: include/linux/virtio.h:188 struct member 'VIRTIO_DECLARE_FEATURES(features' not described in 'virtio_device' Warning: include/linux/virtio.h:188 struct member 'vmap' not described in 'virtio_device' Warning: include/uapi/linux/vduse.h:302 struct member 'offset' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'start' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'last' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'perm' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'padding' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:372 struct member 'padding' not described in 'vduse_iova_range_v2' Warning: drivers/scsi/virtio_scsi.c:504 No description found for return value of 'virtscsi_add_cmd' Warning: drivers/scsi/virtio_scsi.c:701 No description found for return value of 'virtscsi_change_queue_depth' Warning: drivers/virtio/virtio_ring.c:2825 No description found for return value of 'virtqueue_add_sgs' Warning: drivers/virtio/virtio_ring.c:2857 No description found for return value of 'virtqueue_add_outbuf' Warning: drivers/virtio/virtio_ring.c:2902 No description found for return value of 'virtqueue_add_inbuf' Warning: drivers/virtio/virtio_ring.c:2929 No description found for return value of 'virtqueue_add_inbuf_cache_clean' Warning: drivers/virtio/virtio_ring.c:2954 No description found for return value of 'virtqueue_add_inbuf_ctx' Warning: drivers/virtio/virtio_ring.c:2991 No description found for return value of 'virtqueue_dma_dev' Warning: drivers/virtio/virtio_ring.c:3013 No description found for return value of 'virtqueue_kick_prepare' Warning: drivers/virtio/virtio_ring.c:3029 No description found for return value of 'virtqueue_notify' Warning: drivers/virtio/virtio_ring.c:3057 No description found for return value of 'virtqueue_kick' Warning: drivers/virtio/virtio_ring.c:3083 No description found for return value of 'virtqueue_get_buf_ctx' Warning: drivers/virtio/virtio_ring.c:3125 No description found for return value of 'virtqueue_enable_cb_prepare' Warning: drivers/virtio/virtio_ring.c:3145 No description found for return value of 'virtqueue_poll' Warning: drivers/virtio/virtio_ring.c:3169 No description found for return value of 'virtqueue_enable_cb' Warning: drivers/virtio/virtio_ring.c:3190 No description found for return value of 'virtqueue_enable_cb_delayed' Warning: drivers/virtio/virtio_ring.c:3209 No description found for return value of 'virtqueue_detach_unused_buf' Warning: drivers/virtio/virtio_ring.c:3230 No description found for return value of 'vring_interrupt' Warning: drivers/virtio/virtio_ring.c:3338 No description found for return value of 'virtqueue_resize' Warning: drivers/virtio/virtio_ring.c:3385 No description found for return value of 'virtqueue_reset' Warning: drivers/virtio/virtio_ring.c:3543 No description found for return value of 'virtqueue_get_vring_size' Warning: drivers/virtio/virtio_ring.c:3687 No description found for return value of 'virtqueue_map_alloc_coherent' Warning: drivers/virtio/virtio_ring.c:3735 No description found for return value of 'virtqueue_map_page_attrs' Warning: drivers/virtio/virtio_ring.c:3792 No description found for return value of 'virtqueue_map_single_attrs' Warning: drivers/virtio/virtio_ring.c:3843 No description found for return value of 'virtqueue_map_mapping_error' Warning: drivers/virtio/virtio_ring.c:3861 No description found for return value of 'virtqueue_map_need_sync' Warning: include/linux/dma-mapping.h:345 No description found for return value of 'dma_use_iova' Warning: include/linux/dma-mapping.h:675 No description found for return value of 'dma_get_seg_boundary_nr_pages' Warning: include/linux/virtio.h:188 struct member 'map' not described in 'virtio_device' Warning: include/linux/virtio.h:188 struct member 'VIRTIO_DECLARE_FEATURES(features' not described in 'virtio_device' Warning: include/linux/virtio.h:188 struct member 'vmap' not described in 'virtio_device' Warning: include/uapi/linux/vduse.h:302 struct member 'offset' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'start' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'last' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'perm' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'padding' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:372 struct member 'padding' not described in 'vduse_iova_range_v2' Warnings before: 62 after: 76 (add: 14) New warnings added: Warning: drivers/virtio/virtio_ring.c:2929 No description found for return value of 'virtqueue_add_inbuf_cache_clean' Warning: include/uapi/linux/vduse.h:302 struct member 'offset' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'start' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'last' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'perm' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'padding' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:372 struct member 'padding' not described in 'vduse_iova_range_v2' Warning: drivers/virtio/virtio_ring.c:2929 No description found for return value of 'virtqueue_add_inbuf_cache_clean' Warning: include/uapi/linux/vduse.h:302 struct member 'offset' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'start' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'last' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'perm' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:302 struct member 'padding' not described in 'vduse_iotlb_entry_v2' Warning: include/uapi/linux/vduse.h:372 struct member 'padding' not described in 'vduse_iova_range_v2' Per-file breakdown: 2 drivers/virtio/virtio_ring.c 12 include/uapi/linux/vduse.h