]> git.proxmox.com Git - mirror_edk2.git/commitdiff
Add more comments for IntelFramework's header files.
authorklu2 <klu2@6f19259b-4bc3-4df7-8a09-765794883524>
Tue, 8 Apr 2008 06:29:25 +0000 (06:29 +0000)
committerklu2 <klu2@6f19259b-4bc3-4df7-8a09-765794883524>
Tue, 8 Apr 2008 06:29:25 +0000 (06:29 +0000)
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@5003 6f19259b-4bc3-4df7-8a09-765794883524

16 files changed:
IntelFrameworkPkg/Include/Framework/DataHubRecords.h
IntelFrameworkPkg/Include/Framework/FrameworkInternalFormRepresentation.h
IntelFrameworkPkg/Include/Library/FrameworkHiiLib.h
IntelFrameworkPkg/Include/Library/FrameworkIfrSupportLib.h
IntelFrameworkPkg/Include/Library/SmmLib.h
IntelFrameworkPkg/Include/Ppi/BootScriptExecuter.h
IntelFrameworkPkg/Include/Ppi/DeviceRecoveryModule.h
IntelFrameworkPkg/Include/Ppi/ReadOnlyVariable.h
IntelFrameworkPkg/Include/Ppi/RecoveryModule.h
IntelFrameworkPkg/Include/Ppi/S3Resume.h
IntelFrameworkPkg/Include/Ppi/SectionExtraction.h
IntelFrameworkPkg/Include/Ppi/Security.h
IntelFrameworkPkg/Include/Ppi/Smbus.h
IntelFrameworkPkg/Include/Protocol/AcpiS3Save.h
IntelFrameworkPkg/Include/Protocol/AcpiSupport.h
IntelFrameworkPkg/Include/Protocol/BootScriptSave.h

index 1c2e598359aefb293e4c0c64f3497342785ba729..4ea9e50c4a705107904ff796bdd33e65a6a9b4f9 100644 (file)
@@ -1,4 +1,4 @@
-  /** @file\r
+/** @file\r
   This file defines GUIDs and associated data structures for records posted to the Data Hub.\r
   The producers of these records use these definitions to construct records.\r
   The consumers of these records use these definitions to retrieve, filter and parse records.\r
index 828011774504ccee315281a617f5a1adce40cade..cb632df21540e443baf22f822e0fd79b9e86b259 100644 (file)
@@ -21,8 +21,6 @@
 #ifndef __FRAMEWORK_INTERNAL_FORMREPRESENTATION_H__\r
 #define __FRAMEWORK_INTERNAL_FORMREPRESENTATION_H__\r
 \r
-\r
-\r
 //\r
 // IFR Op codes\r
 //\r
index ceb91cf8b94b2f54b1fb0ab51fa49c9dab18adea..771d70cad0092fbf63d91bd6c07494859d49d6d5 100644 (file)
@@ -1,6 +1,11 @@
 /** @file\r
-  Public include file for the HII Library\r
-\r
+  Library class name: FrameworkHiiLib.\r
+  \r
+  FrameworkHiiLib is designed for produce interfaces to access\r
+  framework HII things. It firstly also produce all interfaces define\r
+  in HiiLib library class in MdePkg/Include/HiiLib.h. It also produce\r
+  framework's old interface PreparePackages to keep compatiblity.\r
+     \r
   Copyright (c) 2006, 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
@@ -10,8 +15,6 @@
   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
 \r
-  Module Name:  HiiLib.h\r
-\r
 **/\r
 \r
 #ifndef __FRAMEWORK_HII_LIB_H__\r
@@ -34,8 +37,7 @@
   @param  NumberOfPackages The number of HII packages to prepare.\r
   @param  Guid Package GUID.\r
 \r
-  @return\r
-  The allocated and initialized packages.\r
+  @return The allocated and initialized packages.\r
 \r
 **/\r
 EFI_HII_PACKAGES *\r
index d8c507d5b2367aa9a11cd9de113428f08d921949..a062f87177c78e554b23f6ece946a346b1233163 100644 (file)
@@ -1,5 +1,9 @@
 /** @file\r
+  Library class name: FrameworkIfrSupportLib\r
 \r
+  FrameworkIfrSupportLib is designed for produce IFR operation interface .\r
+  The IFR format follows framework specification.\r
+  \r
 Copyright (c) 2006, 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
@@ -9,14 +13,6 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
 \r
-Module Name:\r
-\r
-  IfrSupportLib.h\r
-\r
-Abstract:\r
-\r
-  The file contain all library function for Ifr Operations.\r
-\r
 **/\r
 \r
 #ifndef _IFRSUPPORTLIBRARY_H\r
index b0d8d891e18fd050ccff3f00f07f35b6b4e79c10..76605fbb6f96fc1407318f326eff16617a231b46 100644 (file)
@@ -1,4 +1,6 @@
 /** @file\r
+  Library class name: SmmLib\r
+  \r
   SMM Library Services that abstracts both S/W SMI generation and detection. \r
 \r
   Copyright (c) 2007, Intel Corporation                                                         \r
index 0cb81040beef533842e9b2d54920ecbd41a73ca7..c98f3821ebd61bc78d6d3c09ade0447b2ed90b75 100644 (file)
@@ -1,6 +1,13 @@
 /** @file\r
   This file declares Boot Script Executer PPI.\r
 \r
+  This PPI is published by a PEIM upon dispatch and provides an execution engine for the\r
+  Framework boot script. This PEIM should be platform neutral and have no specific knowledge of\r
+  platform instructions and other information. The ability to interpret the boot script depends on the\r
+  abundance of other PPIs that are available. For example, if the script requests an SMBus command\r
+  execution, the PEIM looks for a relevant PPI that is available to execute it, rather than executing it\r
+  by issuing the native IA-32 instruction.\r
+\r
   Copyright (c) 2007, 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
index 7ed3217134e5f19f568e8ea3387cdd954a9ed9be..2139d158bf1847c5189cf0092cf3e7ad2b068056 100644 (file)
@@ -1,5 +1,12 @@
 /** @file\r
   This file declares Device Recovery Module PPI.\r
+  The interface of this PPI does the following:\r
+    - Reports the number of recovery DXE capsules that exist on the associated device(s)\r
+    - Finds the requested firmware binary capsule\r
+    - Loads that capsule into memory\r
+  A device can be either a group of devices, such as a block device, or an individual device.T he\r
+  module determines the internal search order, with capsule number 1 as the highest load priority and\r
+  number N as the lowest priority.\r
 \r
   Copyright (c) 2007, Intel Corporation\r
   All rights reserved. This program and the accompanying materials\r
index 7c1c65470d8e8fd36aff7437a854b2ec06ffbcd0..6e6c0873a52764e49f656ecbe71d78d50347abb9 100644 (file)
@@ -1,5 +1,10 @@
 /** @file\r
   This file declares Read-only Variable Service PPI\r
+  These services provide a lightweight, read-only variant of the full EFI variable services. The\r
+  reason that these services are read-only is to reduce the complexity of flash management. Also,\r
+  some implementation of the PEI may use the same physical flash part for variable and PEIM\r
+  storage; as such, a write command to certain technologies would alter the contents of the entire part,\r
+  thus making the in situ PEIM execution not follow the required flow.\r
 \r
   Copyright (c) 2006, Intel Corporation\r
   All rights reserved. This program and the accompanying materials\r
index 02b71837fe50182d5c063fc8cfbe3750622af51c..adfe436d5fba9e6f964074b428f7ccb9afa14ee2 100644 (file)
@@ -1,5 +1,6 @@
 /** @file\r
-  This file declares Recovery Module PPI.\r
+  This file declares Recovery Module PPI. \r
+  This PPI is used to find and load the recovery files.\r
 \r
   Copyright (c) 2007, Intel Corporation\r
   All rights reserved. This program and the accompanying materials\r
index cbb38f5722d6f892037f5071c48906dd4e15697b..b04a62ab792c4ca0179fb3a778f9654e92d9b53f 100644 (file)
@@ -1,6 +1,22 @@
 /** @file\r
-  This file declares S3 Resume PPI.\r
-\r
+  This file declares S3 Resume PPI which accomplishes the firmware S3 resume boot path\r
+  and transfers control to OS.\r
+  \r
+  This PPI is published by the S3 resume PEIM and can be used on the S3 resume boot path to\r
+  restore the platform to its preboot configuration and transfer control to OS. The information that is\r
+  required for an S3 resume can be saved during the normal boot path using\r
+  EFI_ACPI_S3_SAVE_PROTOCOL. This presaved information can then be restored in the S3\r
+  resume boot path using EFI_PEI_S3_RESUME_PPI. Architecturally, the S3 resume PEIM is the\r
+  last PEIM to be dispatched in the S3 resume boot path.\r
+  Before using this PPI, the caller has to ensure the necessary information for the S3 resume, such as\r
+  the following, is available for the S3 resume boot path:\r
+  - EFI_ACPI_S3_RESUME_SCRIPT_TABLE script table. Type\r
+    EFI_ACPI_S3_RESUME_SCRIPT_TABLE is defined in the Intel® Platform Innovation\r
+    Framework for EFI Boot Script Specification.\r
+  - OS waking vector.\r
+  - The reserved memory range to be used for the S3 resume.\r
+  Otherwise, the S3 resume boot path may fail.\r
+  \r
   Copyright (c) 2007, 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
index e872bf78c9235e61c36cb4aec7e2c8f3dfdd2265..7d2ea98e0a05d739bcf75232d746c74998844ab9 100644 (file)
@@ -1,5 +1,7 @@
 /** @file\r
   This file declares Section Extraction PPI.\r
+  This PPI supports encapsulating sections, such as GUIDed sections used to authenticate the file\r
+  encapsulation of other domain-specific wrapping.\r
 \r
   Copyright (c) 2006, Intel Corporation\r
   All rights reserved. This program and the accompanying materials\r
index 4656e577743d437a81cb2dee9f7c183df1d47967..8c7adb6fa01356890b45779bcaac2860cdc45d38 100644 (file)
@@ -1,6 +1,10 @@
 /** @file\r
   This file declares Security Architectural PPI.\r
-\r
+  \r
+  This PPI is installed by some platform PEIM that abstracts the security policy to the PEI\r
+  Foundation, namely the case of a PEIM¡¯s authentication state being returned during the PEI section\r
+  extraction process.\r
+  \r
   Copyright (c) 2006, 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
index e179d0ceb36f050491f2aa459eab047ce9626143..afb2491086520b8a19e2f005bbd190bd28b5548e 100644 (file)
@@ -1,5 +1,6 @@
 /** @file\r
-  This file declares Smbus PPI.\r
+  This file declares Smbus PPI which provides the basic I/O interfaces that a PEIM \r
+  uses to access its SMBus controller and the slave devices attached to it.\r
 \r
   Copyright (c) 2007, Intel Corporation\r
   All rights reserved. This program and the accompanying materials\r
index a64ffd45315ef61ebf7de1d665db7f56e7c871f2..0ef70175b67755e126dae0ec91cdbe2aa22539ad 100644 (file)
@@ -1,5 +1,8 @@
 /** @file\r
-\r
+  This protocol is used to prepare all information that is needed for the S3 resume boot path. This\r
+  protocol is not required for all platforms.\r
+  This protocol is defined in framework S3Resume v0.9, page 21.\r
+  \r
 Copyright (c) 2006, 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
@@ -9,13 +12,6 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
 \r
-Module Name:\r
-\r
-  AcpiS3Save.h\r
-\r
-Abstract:\r
-\r
-\r
 **/\r
 \r
 #ifndef _ACPI_S3_SAVE_PROTOCOL_H\r
index 8955e8e028ab5dc63ed2ab4b77e32092bf9363d1..c22f63745115830e69b7798287077e093f129c16 100644 (file)
@@ -1,6 +1,15 @@
 /** @file\r
-  Definition of the ACPI Support protocol.\r
+  This protocol provides some basic services to support publishing ACPI system tables. The\r
+  services handle many of the more mundane tasks that are required to publish a set of tables. The\r
+  services will do the following:\r
+       - Generate common tables.\r
+       - Update the table links.\r
+       - Ensure that tables are properly aligned and use correct types of memory.\r
+       - Update checksum values and IDs.\r
+       - Complete the final installation of the tables.\r
 \r
+  This is defined in the ACPI Specification 0.9.\r
+  \r
   Copyright (c) 2007, 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
   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
 \r
-  Module Name:  AcpiSupport.h\r
-\r
-  @par Revision Reference:\r
-  This is defined in the ACPI Specification 0.9.\r
-\r
 **/\r
 \r
 #ifndef _ACPI_SUPPORT_PROTOCOL_H_\r
index cb1a9c98af0dc35fa3fd75d4f9d76c27b2e9d902..828cb8c46e8c6dc7cb89b9443b628b455d51572d 100644 (file)
@@ -1,5 +1,6 @@
 /** @file\r
-  Definition of the Boot Script Save protocol.\r
+  This protocol is used to store or record various boot scripts into boot \r
+  script tables.\r
 \r
   Copyright (c) 2007, Intel Corporation\r
   All rights reserved. This program and the accompanying materials\r
@@ -10,8 +11,6 @@
   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
 \r
-  Module Name:  BootScriptSave.h\r
-\r
   @par Revision Reference:\r
   This protocol defined in the Boot Script Specification, Version 0.91.\r
 \r