Commit ecc569639a for qemu.org

commit ecc569639aeb5b702f1098d3eb5b28d3168604c8
Author: Miao Wang <shankerwangmiao@gmail.com>
Date:   Fri Jul 10 03:21:40 2026 +0800

    hw/scsi/vmw_pvscsi: add a comment to explain the endianness

    Add a comment to explain the endianness of the pvscsi device. We have
    no information about the endianness should be little-endian or CPU
    native endian because the current driver code is designed to work only
    on x86 and is not endianness aware. We assume that the pvscsi device is
    implicitly little-endian.

    Signed-off-by: Miao Wang <shankerwangmiao@gmail.com>
    Reviewed-by: Philippe Mathieu-Daudé <philmd@oss.qualcomm.com>
    Message-ID: <20260710-pvscsi-endianness-v3-2-27fe1c4d1f6e@gmail.com>
    Signed-off-by: Philippe Mathieu-Daudé <philmd@oss.qualcomm.com>

diff --git a/hw/scsi/vmw_pvscsi.h b/hw/scsi/vmw_pvscsi.h
index a3ae517e19..defff9e179 100644
--- a/hw/scsi/vmw_pvscsi.h
+++ b/hw/scsi/vmw_pvscsi.h
@@ -108,6 +108,20 @@ enum PVSCSICommands {
 #define PVSCSI_COMMAND_PROCESSING_FAILED     (-1)
 #define PVSCSI_COMMAND_NOT_ENOUGH_DATA       (-2)

+/*
+ * About endianess for the below structs:
+ *
+ * These structs are used to describe the data that is exchanged between the
+ * guest and the PVSCSI device. The endianess of the fields in these structs
+ * is not defined by any standard. The current implemented drivers are designed
+ * to only work on x86 architecture, so there is no endianess awareness in the
+ * drivers and thus we have no idea whether the fields should be in little-
+ * endian or target native endian format.
+ *
+ * Considering the above, we assume that PVSCSI is implicitly little-endian and
+ * expect the fields in these structs to be in little-endian format.
+ */
+
 /*
  * Command descriptor for PVSCSI_CMD_RESET_DEVICE --
  */