Commit 09719a01b1 (OvmfPkg/QemuFwCfgLib: Implement SEV internal function
for Dxe phase) uses IOMMU protocol to allocate and free FW_CFG_DMA_ACCESS
buffer when SEV is active. During initial commits we made assumption that
IOMMU.AllocateBuffer() will provide PlainTextAddress (i.e C-bit cleared).
This assumption was wrong, the AllocateBuffer() protocol member is not
expected to produce a buffer that is immediatly usable, and client is
required to call Map() uncondtionally with BusMasterCommonBuffer[64] to
get a mapping which is accessable by both host and device.
The patch refactors code a bit and add the support to Map()
FW_CFG_DMA_ACCESS buffer using BusMasterCommonBuffer operation after
allocation and Unamp() before free.
The complete discussion about this and recommendation from Laszlo can be
found here [1]
[1] https://lists.01.org/pipermail/edk2-devel/2017-July/012652.html
Suggested-by: Laszlo Ersek <lersek@redhat.com>
Cc: Jordan Justen <jordan.l.justen@intel.com>
Cc: Laszlo Ersek <lersek@redhat.com>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Brijesh Singh <brijesh.singh@amd.com>
[lersek@redhat.com: convert pointers to UINTN before converting to UINT64]
[lersek@redhat.com: fix argument indentation in multi-line function call]
[lersek@redhat.com: explicitly compare pointers to NULL]
Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Regression-tested-by: Laszlo Ersek <lersek@redhat.com>
Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Laszlo Ersek <lersek@redhat.com>
		
	
		
			
				
	
	
		
			70 lines
		
	
	
		
			2.1 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			70 lines
		
	
	
		
			2.1 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/** @file
 | 
						|
  Internal interfaces specific to the QemuFwCfgLib instances in OvmfPkg.
 | 
						|
 | 
						|
  Copyright (C) 2016, Red Hat, Inc.
 | 
						|
  Copyright (C) 2017, Advanced Micro Devices. All rights reserved
 | 
						|
 | 
						|
  This program and the accompanying materials are licensed and made available
 | 
						|
  under the terms and conditions of the BSD License which accompanies this
 | 
						|
  distribution.  The full text of the license may be found at
 | 
						|
  http://opensource.org/licenses/bsd-license.php
 | 
						|
 | 
						|
  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT
 | 
						|
  WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 | 
						|
 | 
						|
**/
 | 
						|
 | 
						|
#ifndef __QEMU_FW_CFG_LIB_INTERNAL_H__
 | 
						|
#define __QEMU_FW_CFG_LIB_INTERNAL_H__
 | 
						|
 | 
						|
/**
 | 
						|
  Returns a boolean indicating if the firmware configuration interface is
 | 
						|
  available for library-internal purposes.
 | 
						|
 | 
						|
  This function never changes fw_cfg state.
 | 
						|
 | 
						|
  @retval    TRUE   The interface is available internally.
 | 
						|
  @retval    FALSE  The interface is not available internally.
 | 
						|
**/
 | 
						|
BOOLEAN
 | 
						|
InternalQemuFwCfgIsAvailable (
 | 
						|
  VOID
 | 
						|
  );
 | 
						|
 | 
						|
 | 
						|
/**
 | 
						|
  Returns a boolean indicating whether QEMU provides the DMA-like access method
 | 
						|
  for fw_cfg.
 | 
						|
 | 
						|
  @retval    TRUE   The DMA-like access method is available.
 | 
						|
  @retval    FALSE  The DMA-like access method is unavailable.
 | 
						|
**/
 | 
						|
BOOLEAN
 | 
						|
InternalQemuFwCfgDmaIsAvailable (
 | 
						|
  VOID
 | 
						|
  );
 | 
						|
 | 
						|
/**
 | 
						|
  Transfer an array of bytes, or skip a number of bytes, using the DMA
 | 
						|
  interface.
 | 
						|
 | 
						|
  @param[in]     Size     Size in bytes to transfer or skip.
 | 
						|
 | 
						|
  @param[in,out] Buffer   Buffer to read data into or write data from. Ignored,
 | 
						|
                          and may be NULL, if Size is zero, or Control is
 | 
						|
                          FW_CFG_DMA_CTL_SKIP.
 | 
						|
 | 
						|
  @param[in]     Control  One of the following:
 | 
						|
                          FW_CFG_DMA_CTL_WRITE - write to fw_cfg from Buffer.
 | 
						|
                          FW_CFG_DMA_CTL_READ  - read from fw_cfg into Buffer.
 | 
						|
                          FW_CFG_DMA_CTL_SKIP  - skip bytes in fw_cfg.
 | 
						|
**/
 | 
						|
VOID
 | 
						|
InternalQemuFwCfgDmaBytes (
 | 
						|
  IN     UINT32   Size,
 | 
						|
  IN OUT VOID     *Buffer OPTIONAL,
 | 
						|
  IN     UINT32   Control
 | 
						|
  );
 | 
						|
 | 
						|
#endif
 |