This patch series implements JEDEC UFSHCI specification compliance for
Task Management Requests (TMR) and Multi-Circular Queue (MCQ) runtime
status and interrupt registers in the QEMU UFS emulator.
Why:
In QEMU UFS emulation, Linux guest error recovery paths (such as SCSI
abort during command timeout) issue Task Management Requests (TMR) via
the UTP Task Management Request List (UTMRL). Furthermore, when MCQ
is enabled, the Linux driver initializes and accesses per-queue runtime
registers (SQnRTC, SQnRTS, SQnIS, CQnIS, etc.). Currently, QEMU treats
UTMRLDBR and MCQ operational registers as unsupported, triggering
"invalid register offset" warnings and causing SCSI EH aborts to time out
and escalate unnecessarily to full controller resets. Additionally,
pending SCSI requests in the block layer were not cancelled when requests
were cleared or aborted in ufs_clear_req(), posing Use-After-Free
hazards upon asynchronous AIO callbacks.
What:
- Patch 1: Tracks SCSIRequest in UfsRequest and cancels pending requests
via scsi_req_cancel() in ufs_clear_req(), ensuring clean Block AIO
teardown.
- Patch 2: Implements MCQ runtime operational registers (queue lifecycle
control, per-queue interrupt status/enable, global CQES sync) and HCE=0
MMIO read protection.
- Patch 3: Implements Task Management Request handling for UTMRLDBR
(supporting UFS_QUERY_TASK and UFS_ABORT_TASK for both legacy UTRL
and MCQ queues).
Differences from v1:
- Split into two independent series: this series contains production
specification compliance and memory safety fixes; experimental fault
injection properties (x-hold-tag, x-hold-mode) have been moved to a
separate follow-up patch based on this series.
- Separated scsi_req_cancel() into Patch 1 to isolate the block layer
memory safety fix.
- Added HCE=0 operational register read guard (returning 0xffffffff) in
Patch 2 per JEDEC UFSHCI specification.
- Cleaned up TMR completion handling and trace events in Patch 3.
Tested:
- Verified on ARM64 Linux guest (linux-next) running on QEMU.
- Verified ufshcd_mcq_make_queues_operational() succeeds without invalid
register offset warnings.
- Verified SCSI command aborts and Task Management Requests via Linux
SCSI error handling escalation.
- Verified 100% data integrity (cmp) on /dev/sda after abort and reset
recovery.
- Passes ./scripts/checkpatch.pl with 0 errors and 0 warnings.
Stanley Jhu (3):
hw/ufs: Track SCSIRequest and cancel pending requests in ufs_clear_req
hw/ufs: Support MCQ runtime interrupt and queue status registers
hw/ufs: Implement Task Management Request (TMR) handling
hw/ufs/lu.c | 12 +++
hw/ufs/trace-events | 2 +
hw/ufs/ufs.c | 196 +++++++++++++++++++++++++++++++++++++++++++-
hw/ufs/ufs.h | 1 +
include/block/ufs.h | 9 ++
5 files changed, 217 insertions(+), 3 deletions(-)
--
2.55.0.1007.g17ff1f9808-goog