Add missing descriptions for vmw_event_fence_action_seq_passed.

This fixes the following warnings:
drivers/gpu/drm/vmwgfx/vmwgfx_fence.c:526 function parameter 'f'
	not described in 'vmw_event_fence_action_seq_passed'
drivers/gpu/drm/vmwgfx/vmwgfx_fence.c:526 function parameter 'cb'
	not described in 'vmw_event_fence_action_seq_passed'

Reported-by: kernel test robot <lkp@intel.com>
Closes: https://lore.kernel.org/oe-kbuild-all/202507040807.jKTxWGVQ-lkp@intel.com/

Signed-off-by: Bartlomiej Kubik <kubik.bartlomiej@gmail.com>
---
 drivers/gpu/drm/vmwgfx/vmwgfx_fence.c | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/drivers/gpu/drm/vmwgfx/vmwgfx_fence.c b/drivers/gpu/drm/vmwgfx/vmwgfx_fence.c
index 00be92da5509..85795082fef9 100644
--- a/drivers/gpu/drm/vmwgfx/vmwgfx_fence.c
+++ b/drivers/gpu/drm/vmwgfx/vmwgfx_fence.c
@@ -515,12 +515,12 @@ int vmw_fence_obj_unref_ioctl(struct drm_device *dev, void *data,
 /**
  * vmw_event_fence_action_seq_passed
  *
- * @action: The struct vmw_fence_action embedded in a struct
- * vmw_event_fence_action.
+ * @f: The struct dma_fence which provides timestamp for the action event
+ * @cb: The struct dma_fence_cb callback for the action event.
  *
- * This function is called when the seqno of the fence where @action is
- * attached has passed. It queues the event on the submitter's event list.
- * This function is always called from atomic context.
+ * This function is called when the seqno of the fence has passed
+ * and it is always called from atomic context.
+ * It queues the event on the submitter's event list.
  */
 static void vmw_event_fence_action_seq_passed(struct dma_fence *f,
 					      struct dma_fence_cb *cb)
--
2.39.5

On Thu, Dec 11, 2025 at 1:11 PM Bartlomiej Kubik
<kubik.bartlomiej@gmail.com> wrote:
>
> Add missing descriptions for vmw_event_fence_action_seq_passed.
>
> This fixes the following warnings:
> drivers/gpu/drm/vmwgfx/vmwgfx_fence.c:526 function parameter 'f'
>         not described in 'vmw_event_fence_action_seq_passed'
> drivers/gpu/drm/vmwgfx/vmwgfx_fence.c:526 function parameter 'cb'
>         not described in 'vmw_event_fence_action_seq_passed'
>
> Reported-by: kernel test robot <lkp@intel.com>
> Closes: https://lore.kernel.org/oe-kbuild-all/202507040807.jKTxWGVQ-lkp@intel.com/
>
> Signed-off-by: Bartlomiej Kubik <kubik.bartlomiej@gmail.com>
> ---
>  drivers/gpu/drm/vmwgfx/vmwgfx_fence.c | 10 +++++-----
>  1 file changed, 5 insertions(+), 5 deletions(-)
>
> diff --git a/drivers/gpu/drm/vmwgfx/vmwgfx_fence.c b/drivers/gpu/drm/vmwgfx/vmwgfx_fence.c
> index 00be92da5509..85795082fef9 100644
> --- a/drivers/gpu/drm/vmwgfx/vmwgfx_fence.c
> +++ b/drivers/gpu/drm/vmwgfx/vmwgfx_fence.c
> @@ -515,12 +515,12 @@ int vmw_fence_obj_unref_ioctl(struct drm_device *dev, void *data,
>  /**
>   * vmw_event_fence_action_seq_passed
>   *
> - * @action: The struct vmw_fence_action embedded in a struct
> - * vmw_event_fence_action.
> + * @f: The struct dma_fence which provides timestamp for the action event
> + * @cb: The struct dma_fence_cb callback for the action event.
>   *
> - * This function is called when the seqno of the fence where @action is
> - * attached has passed. It queues the event on the submitter's event list.
> - * This function is always called from atomic context.
> + * This function is called when the seqno of the fence has passed
> + * and it is always called from atomic context.
> + * It queues the event on the submitter's event list.
>   */
>  static void vmw_event_fence_action_seq_passed(struct dma_fence *f,
>                                               struct dma_fence_cb *cb)
> --
> 2.39.5
>

Thanks, I pushed it to drm-misc-fixes, it will land during the next
drm-misc-fixes merge.

z

Hi,

I submitted this patch about two weeks ago but haven't received any
feedback yet.
I wanted to check if there are any concerns with the patch or if any
changes are needed.

Please let me know if you need any additional information.

Best regards
Bartłomiej Kubik

On Thu, 11 Dec 2025 at 19:11, Bartlomiej Kubik
<kubik.bartlomiej@gmail.com> wrote:
>
> Add missing descriptions for vmw_event_fence_action_seq_passed.
>
> This fixes the following warnings:
> drivers/gpu/drm/vmwgfx/vmwgfx_fence.c:526 function parameter 'f'
>         not described in 'vmw_event_fence_action_seq_passed'
> drivers/gpu/drm/vmwgfx/vmwgfx_fence.c:526 function parameter 'cb'
>         not described in 'vmw_event_fence_action_seq_passed'
>
> Reported-by: kernel test robot <lkp@intel.com>
> Closes: https://lore.kernel.org/oe-kbuild-all/202507040807.jKTxWGVQ-lkp@intel.com/
>
> Signed-off-by: Bartlomiej Kubik <kubik.bartlomiej@gmail.com>
> ---
>  drivers/gpu/drm/vmwgfx/vmwgfx_fence.c | 10 +++++-----
>  1 file changed, 5 insertions(+), 5 deletions(-)
>
> diff --git a/drivers/gpu/drm/vmwgfx/vmwgfx_fence.c b/drivers/gpu/drm/vmwgfx/vmwgfx_fence.c
> index 00be92da5509..85795082fef9 100644
> --- a/drivers/gpu/drm/vmwgfx/vmwgfx_fence.c
> +++ b/drivers/gpu/drm/vmwgfx/vmwgfx_fence.c
> @@ -515,12 +515,12 @@ int vmw_fence_obj_unref_ioctl(struct drm_device *dev, void *data,
>  /**
>   * vmw_event_fence_action_seq_passed
>   *
> - * @action: The struct vmw_fence_action embedded in a struct
> - * vmw_event_fence_action.
> + * @f: The struct dma_fence which provides timestamp for the action event
> + * @cb: The struct dma_fence_cb callback for the action event.
>   *
> - * This function is called when the seqno of the fence where @action is
> - * attached has passed. It queues the event on the submitter's event list.
> - * This function is always called from atomic context.
> + * This function is called when the seqno of the fence has passed
> + * and it is always called from atomic context.
> + * It queues the event on the submitter's event list.
>   */
>  static void vmw_event_fence_action_seq_passed(struct dma_fence *f,
>                                               struct dma_fence_cb *cb)
> --
> 2.39.5
>