Commit 38e4614c authored by Simon Horman's avatar Simon Horman Committed by Alex Williamson

vfio: correct kdoc for ops structures

Address minor omissions from kdoc for ops structures flagged by check-kdoc:

  ./scripts/kernel-doc -Werror -none include/linux/vfio.h

  include/linux/vfio.h:114: warning: Function parameter or member 'name' not described in 'vfio_device_ops'
  include/linux/vfio.h:143: warning: Cannot understand  * @migration_set_state: Optional callback to change the migration state for
   on line 143 - I thought it was a doc line
  include/linux/vfio.h:168: warning: Cannot understand  * @log_start: Optional callback to ask the device start DMA logging.
   on line 168 - I thought it was a doc line
Signed-off-by: default avatarSimon Horman <horms@kernel.org>
Link: https://lore.kernel.org/r/20230329120603.468031-1-horms@kernel.orgSigned-off-by: default avatarAlex Williamson <alex.williamson@redhat.com>
parent 6467d074
...@@ -68,6 +68,7 @@ struct vfio_device { ...@@ -68,6 +68,7 @@ struct vfio_device {
/** /**
* struct vfio_device_ops - VFIO bus driver device callbacks * struct vfio_device_ops - VFIO bus driver device callbacks
* *
* @name: Name of the device driver.
* @init: initialize private fields in device structure * @init: initialize private fields in device structure
* @release: Reclaim private fields in device structure * @release: Reclaim private fields in device structure
* @bind_iommufd: Called when binding the device to an iommufd * @bind_iommufd: Called when binding the device to an iommufd
...@@ -140,6 +141,8 @@ int vfio_iommufd_emulated_attach_ioas(struct vfio_device *vdev, u32 *pt_id); ...@@ -140,6 +141,8 @@ int vfio_iommufd_emulated_attach_ioas(struct vfio_device *vdev, u32 *pt_id);
#endif #endif
/** /**
* struct vfio_migration_ops - VFIO bus device driver migration callbacks
*
* @migration_set_state: Optional callback to change the migration state for * @migration_set_state: Optional callback to change the migration state for
* devices that support migration. It's mandatory for * devices that support migration. It's mandatory for
* VFIO_DEVICE_FEATURE_MIGRATION migration support. * VFIO_DEVICE_FEATURE_MIGRATION migration support.
...@@ -165,6 +168,8 @@ struct vfio_migration_ops { ...@@ -165,6 +168,8 @@ struct vfio_migration_ops {
}; };
/** /**
* struct vfio_log_ops - VFIO bus device driver logging callbacks
*
* @log_start: Optional callback to ask the device start DMA logging. * @log_start: Optional callback to ask the device start DMA logging.
* @log_stop: Optional callback to ask the device stop DMA logging. * @log_stop: Optional callback to ask the device stop DMA logging.
* @log_read_and_clear: Optional callback to ask the device read * @log_read_and_clear: Optional callback to ask the device read
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment