Re: [PATCH v2 1/1] MdePkg/UefiScsiLib: Set FUA bit for synchronous SCSI Write operations

["Zurcher, Christopher J" <christopher.j.zurcher@intel.com>]

This change has been validated on an internal development platform; I will share the details offline.

Thanks,
Christopher Zurcher

> -----Original Message-----
> From: Gao, Liming <liming.gao@intel.com>
> Sent: Monday, March 30, 2020 06:51
> To: Liu, Zhiguang <zhiguang.liu@intel.com>; Zurcher, Christopher J
> <christopher.j.zurcher@intel.com>; devel@edk2.groups.io
> Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Wang, Jian J
> <jian.j.wang@intel.com>
> Subject: RE: [PATCH v2 1/1] MdePkg/UefiScsiLib: Set FUA bit for synchronous
> SCSI Write operations
> 
> Zurcher:
>   What functionality test has been done for this test?
> 
> Thanks
> Liming
> > -----Original Message-----
> > From: Liu, Zhiguang <zhiguang.liu@intel.com>
> > Sent: Monday, March 30, 2020 9:52 AM
> > To: Zurcher, Christopher J <christopher.j.zurcher@intel.com>;
> devel@edk2.groups.io
> > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Wang, Jian J
> <jian.j.wang@intel.com>; Gao, Liming <liming.gao@intel.com>
> > Subject: RE: [PATCH v2 1/1] MdePkg/UefiScsiLib: Set FUA bit for synchronous
> SCSI Write operations
> >
> > Reviewed-by: Zhiguang Liu <zhiguang.liu@intel.com>
> >
> > > -----Original Message-----
> > > From: Zurcher, Christopher J
> > > Sent: Thursday, March 26, 2020 3:34 PM
> > > To: devel@edk2.groups.io
> > > Cc: Kinney, Michael D <michael.d.kinney@intel.com>; Wang, Jian J
> > > <jian.j.wang@intel.com>; Gao, Liming <liming.gao@intel.com>; Liu,
> Zhiguang
> > > <zhiguang.liu@intel.com>
> > > Subject: [PATCH v2 1/1] MdePkg/UefiScsiLib: Set FUA bit for synchronous
> > > SCSI Write operations
> > >
> > > The FUA (Force Unit Access) bit forces data to be written directly to
> > > disk instead of the write cache. This prevents data from being lost if a
> > > shutdown or reset is requested immediately after a SCSI write operation.
> > >
> > > Cc: Michael D Kinney <michael.d.kinney@intel.com>
> > > Cc: Jian J Wang <jian.j.wang@intel.com>
> > > Cc: Liming Gao <liming.gao@intel.com>
> > > Cc: Zhiguang Liu <zhiguang.liu@intel.com>
> > > Signed-off-by: Christopher J Zurcher <christopher.j.zurcher@intel.com>
> > > ---
> > >  MdePkg/Include/IndustryStandard/Scsi.h   |  8 +++++++-
> > >  MdePkg/Library/UefiScsiLib/UefiScsiLib.c | 14 ++++++++------
> > >  2 files changed, 15 insertions(+), 7 deletions(-)
> > >
> > > diff --git a/MdePkg/Include/IndustryStandard/Scsi.h
> > > b/MdePkg/Include/IndustryStandard/Scsi.h
> > > index 3e966520a1..64b9918b82 100644
> > > --- a/MdePkg/Include/IndustryStandard/Scsi.h
> > > +++ b/MdePkg/Include/IndustryStandard/Scsi.h
> > > @@ -1,7 +1,7 @@
> > >  /** @file
> > >    Support for SCSI-2 standard
> > >
> > > -  Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>
> > > +  Copyright (c) 2006 - 2020, Intel Corporation. All rights reserved.<BR>
> > >    SPDX-License-Identifier: BSD-2-Clause-Patent
> > >
> > >  **/
> > > @@ -175,6 +175,12 @@
> > >  #define EFI_SCSI_DATA_IN  0
> > >  #define EFI_SCSI_DATA_OUT 1
> > >
> > > +//
> > > +// SCSI Block Command Cache Control Parameters
> > > +//
> > > +#define EFI_SCSI_BLOCK_FUA  BIT3  ///< Force Unit Access
> > > +#define EFI_SCSI_BLOCK_DPO  BIT4  ///< Disable Page Out
> > > +
> > >  //
> > >  // Peripheral Device Type Definitions
> > >  //
> > > diff --git a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
> > > b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
> > > index 13a2a1912c..512bec500c 100644
> > > --- a/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
> > > +++ b/MdePkg/Library/UefiScsiLib/UefiScsiLib.c
> > > @@ -1,7 +1,7 @@
> > >  /** @file
> > >    UEFI SCSI Library implementation
> > >
> > > -  Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>
> > > +  Copyright (c) 2006 - 2020, Intel Corporation. All rights reserved.<BR>
> > >    SPDX-License-Identifier: BSD-2-Clause-Patent
> > >
> > >  **/
> > > @@ -1055,15 +1055,16 @@ ScsiWrite10Command (
> > >    ZeroMem (&CommandPacket, sizeof
> > > (EFI_SCSI_IO_SCSI_REQUEST_PACKET));
> > >    ZeroMem (Cdb, EFI_SCSI_OP_LENGTH_TEN);
> > >
> > > -  CommandPacket.Timeout         = Timeout;
> > > -  CommandPacket.OutDataBuffer    = DataBuffer;
> > > -  CommandPacket.SenseData       = SenseData;
> > > -  CommandPacket.OutTransferLength= *DataLength;
> > > -  CommandPacket.Cdb             = Cdb;
> > > +  CommandPacket.Timeout           = Timeout;
> > > +  CommandPacket.OutDataBuffer     = DataBuffer;
> > > +  CommandPacket.SenseData         = SenseData;
> > > +  CommandPacket.OutTransferLength = *DataLength;
> > > +  CommandPacket.Cdb               = Cdb;
> > >    //
> > >    // Fill Cdb for Write (10) Command
> > >    //
> > >    Cdb[0]                        = EFI_SCSI_OP_WRITE10;
> > > +  Cdb[1]                        = EFI_SCSI_BLOCK_FUA;
> > >    WriteUnaligned32 ((UINT32 *)&Cdb[2], SwapBytes32 (StartLba));
> > >    WriteUnaligned16 ((UINT16 *)&Cdb[7], SwapBytes16 ((UINT16)
> > > SectorSize));
> > >
> > > @@ -1263,6 +1264,7 @@ ScsiWrite16Command (
> > >    // Fill Cdb for Write (16) Command
> > >    //
> > >    Cdb[0]                        = EFI_SCSI_OP_WRITE16;
> > > +  Cdb[1]                        = EFI_SCSI_BLOCK_FUA;
> > >    WriteUnaligned64 ((UINT64 *)&Cdb[2], SwapBytes64 (StartLba));
> > >    WriteUnaligned32 ((UINT32 *)&Cdb[10], SwapBytes32 (SectorSize));
> > >
> > > --
> > > 2.16.2.windows.1
>