Code Scrub for Protocol and Ppi Definition

[mirror_edk2.git] / MdePkg / Include / Ppi / Security2.h

diff --git a/MdePkg/Include/Ppi/Security2.h b/MdePkg/Include/Ppi/Security2.h
index f1eafab8d5009d6b2971476203235a75d61c1c44..5dbcd1a12325a7fc80115c890f5e1d7e5f2a5997 100644 (file)
--- a/MdePkg/Include/Ppi/Security2.h
+++ b/MdePkg/Include/Ppi/Security2.h
@@ -1,7 +1,11 @@
 /** @file\r
-  This file declares Security2 Architectural PPI.\r
+  This file declares Pei Security2 PPI.\r
 \r
-  Copyright (c) 2006 - 2007, Intel Corporation\r
+  This PPI is installed by some platform PEIM that abstracts the security \r
+  policy to the PEI Foundation, namely the case of a PEIM's authentication \r
+  state being returned during the PEI section extraction process.\r
+\r
+  Copyright (c) 2006 - 2008, Intel Corporation\r
   All rights reserved. This program and the accompanying materials                          \r
   are licensed and made available under the terms and conditions of the BSD License         \r
   which accompanies this distribution.  The full text of the license may be found at        \r
@@ -26,7 +30,9 @@
 typedef struct _EFI_PEI_SECURITY2_PPI  EFI_PEI_SECURITY2_PPI;\r
 \r
 /**\r
-   \r
+  Allows the platform builder to implement a security policy \r
+  in response to varying file authentication states.\r
+\r
   This service is published by some platform PEIM. The purpose of\r
   this service is to expose a given platform's policy-based\r
   response to the PEI Foundation. For example, if there is a PEIM\r
@@ -58,6 +64,8 @@ typedef struct _EFI_PEI_SECURITY2_PPI  EFI_PEI_SECURITY2_PPI;
   PEIM being discovered. These latter behaviors are platform-\r
   and market-specific and thus outside the scope of the PEI CIS.\r
 \r
+  @param PeiServices   An indirect pointer to the PEI Services Table published by the PEI Foundation.\r
+\r
   @param This   Interface pointer that implements the particular\r
                 EFI_PEI_SECURITY2_PPI instance.\r
 \r
@@ -97,7 +105,7 @@ EFI_STATUS
 );\r
 \r
 /**\r
-   \r
+  @par Ppi Description: \r
   This PPI is a means by which the platform builder can indicate\r
   a response to a PEIM's authentication state. This can be in\r
   the form of a requirement for the PEI Foundation to skip a\r