git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@10404 6f19259b-4bc3-4df7-8a09-765794883524
		
			
				
	
	
		
			69 lines
		
	
	
		
			2.6 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			69 lines
		
	
	
		
			2.6 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/** @file
 | 
						|
  This file declares the Security Architectural PPI.
 | 
						|
  
 | 
						|
  This PPI is installed by a platform PEIM that abstracts the security policy to the PEI
 | 
						|
  Foundation, namely the case of a PEIM's authentication state being returned during the PEI section
 | 
						|
  extraction process.
 | 
						|
  
 | 
						|
Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
 | 
						|
This program and the accompanying materials are licensed and made available under 
 | 
						|
the terms and conditions of the BSD License that 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.
 | 
						|
 | 
						|
  @par Revision Reference:
 | 
						|
  This PPI is defined in PEI CIS.
 | 
						|
  Version 0.91.
 | 
						|
 | 
						|
**/
 | 
						|
 | 
						|
#ifndef __SECURITY_PPI_H__
 | 
						|
#define __SECURITY_PPI_H__
 | 
						|
 | 
						|
#define EFI_PEI_SECURITY_PPI_GUID \
 | 
						|
  { \
 | 
						|
    0x1388066e, 0x3a57, 0x4efa, {0x98, 0xf3, 0xc1, 0x2f, 0x3a, 0x95, 0x8a, 0x29 } \
 | 
						|
  }
 | 
						|
 | 
						|
typedef struct _EFI_PEI_SECURITY_PPI  EFI_PEI_SECURITY_PPI;
 | 
						|
 | 
						|
/**
 | 
						|
  Allows the platform builder to implement a security policy in response
 | 
						|
  to varying file authentication states.
 | 
						|
 | 
						|
  @param  PeiServices             The pointer to the PEI Services Table.
 | 
						|
  @param  This                    Interface pointer that implements the particular 
 | 
						|
                                  EFI_PEI_SECURITY_PPI instance.
 | 
						|
  @param  AuthenticationStatus    Status returned by the verification service as 
 | 
						|
                                  part of section extraction.
 | 
						|
  @param  FfsFileHeader           The pointer to the file under review.
 | 
						|
  @param  DeferExecution          The pointer to a variable that alerts the PEI 
 | 
						|
                                  Foundation to defer execution of a PEIM.
 | 
						|
 | 
						|
  @retval EFI_SUCCESS             The service performed its action successfully.
 | 
						|
  @retval EFI_SECURITY_VIOLATION  The object cannot be trusted.
 | 
						|
**/
 | 
						|
typedef
 | 
						|
EFI_STATUS
 | 
						|
(EFIAPI *FRAMEWORK_EFI_PEI_SECURITY_AUTHENTICATION_STATE)(
 | 
						|
  IN EFI_PEI_SERVICES             **PeiServices,
 | 
						|
  IN EFI_PEI_SECURITY_PPI         *This,
 | 
						|
  IN UINT32                       AuthenticationStatus,
 | 
						|
  IN EFI_FFS_FILE_HEADER          *FfsFileHeader,
 | 
						|
  IN OUT BOOLEAN                  *DeferExecution
 | 
						|
  );
 | 
						|
 | 
						|
//
 | 
						|
// PPI interface structure of Security PPI
 | 
						|
//
 | 
						|
struct _EFI_PEI_SECURITY_PPI {
 | 
						|
  FRAMEWORK_EFI_PEI_SECURITY_AUTHENTICATION_STATE  AuthenticationState;
 | 
						|
};
 | 
						|
 | 
						|
extern EFI_GUID gEfiPeiSecurityPpiGuid;
 | 
						|
 | 
						|
#endif
 |