virt: acrn: split acrn_mmio_dev_res out of acrn_mmiodev

Add struct acrn_mmio_dev_res before struct acrn_mmio_dev.
The former is used in the latter and breaking them up provides
better kernel-doc documentation for the struct members.

Suggested-by: Fei Li <fei1.li@intel.com>
Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Acked-by: Fei Li <fei1.li@intel.com>
Link: https://patch.msgid.link/20251028040409.868254-1-rdunlap@infradead.org
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

diff --git a/include/uapi/linux/acrn.h b/include/uapi/linux/acrn.h
index 7b714c1902eb292b5235ab7333c7ed6153549963..79e7855a8c42edecc3a4a2be563b730ad539fe8d 100644 (file)
--- a/include/uapi/linux/acrn.h
+++ b/include/uapi/linux/acrn.h
@@ -418,26 +418,32 @@ struct acrn_pcidev {
 };
 
 /**
- * struct acrn_mmiodev - Info for assigning or de-assigning a MMIO device
- * @name:                      Name of the MMIO device.
- * @res[].user_vm_pa:          Physical address of User VM of the MMIO region
- *                             for the MMIO device.
- * @res[].service_vm_pa:       Physical address of Service VM of the MMIO
- *                             region for the MMIO device.
- * @res[].size:                        Size of the MMIO region for the MMIO device.
- * @res[].mem_type:            Memory type of the MMIO region for the MMIO
- *                             device.
+ * struct acrn_mmio_dev_res - MMIO device resource description
+ * @user_vm_pa:                Physical address of User VM of the MMIO region
+ *                     for the MMIO device.
+ * @service_vm_pa:     Physical address of Service VM of the MMIO
+ *                     region for the MMIO device.
+ * @size:              Size of the MMIO region for the MMIO device.
+ * @mem_type:          Memory type of the MMIO region for the MMIO
+ *                     device.
+ */
+struct acrn_mmio_dev_res {
+       __u64   user_vm_pa;
+       __u64   service_vm_pa;
+       __u64   size;
+       __u64   mem_type;
+};
+
+/**
+ * struct acrn_mmiodev - Info for assigning or de-assigning an MMIO device
+ * @name:      Name of the MMIO device.
+ * @res:       Array of MMIO device descriptions
  *
  * This structure will be passed to hypervisor directly.
  */
 struct acrn_mmiodev {
        __u8    name[8];
-       struct {
-               __u64   user_vm_pa;
-               __u64   service_vm_pa;
-               __u64   size;
-               __u64   mem_type;
-       } res[ACRN_MMIODEV_RES_NUM];
+       struct acrn_mmio_dev_res res[ACRN_MMIODEV_RES_NUM];
 };
 
 /**