git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8908 6f19259b-4bc3-4df7-8a09-765794883524
		
			
				
	
	
		
			66 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			66 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/** @file
 | 
						|
  This file declares Security Architectural PPI.
 | 
						|
  
 | 
						|
  This PPI is installed by some 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, Intel Corporation
 | 
						|
  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.
 | 
						|
 | 
						|
  @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             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           Pointer to the file under review.
 | 
						|
  @param  DeferExecution          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
 |