sravan/system76-edk2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add more comments for IntelFramework's header files.

Browse Source 
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@5003 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
klu2
2008-04-08 06:29:25 +00:00
parent f42be64210
commit 4a71b21a63
16 changed files with 79 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
IntelFrameworkPkg/Include/Ppi/BootScriptExecuter.h
View File

@@ -1,6 +1,13 @@
/** @file
This file declares Boot Script Executer PPI.
This PPI is published by a PEIM upon dispatch and provides an execution engine for the
Framework boot script. This PEIM should be platform neutral and have no specific knowledge of
platform instructions and other information. The ability to interpret the boot script depends on the
abundance of other PPIs that are available. For example, if the script requests an SMBus command
execution, the PEIM looks for a relevant PPI that is available to execute it, rather than executing it
by issuing the native IA-32 instruction.
Copyright (c) 2007, 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

7
IntelFrameworkPkg/Include/Ppi/DeviceRecoveryModule.h
View File

@@ -1,5 +1,12 @@
/** @file
This file declares Device Recovery Module PPI.
The interface of this PPI does the following:
- Reports the number of recovery DXE capsules that exist on the associated device(s)
- Finds the requested firmware binary capsule
- Loads that capsule into memory
A device can be either a group of devices, such as a block device, or an individual device.T he
module determines the internal search order, with capsule number 1 as the highest load priority and
number N as the lowest priority.
Copyright (c) 2007, Intel Corporation
All rights reserved. This program and the accompanying materials

5
IntelFrameworkPkg/Include/Ppi/ReadOnlyVariable.h
View File

@@ -1,5 +1,10 @@
/** @file
This file declares Read-only Variable Service PPI
These services provide a lightweight, read-only variant of the full EFI variable services. The
reason that these services are read-only is to reduce the complexity of flash management. Also,
some implementation of the PEI may use the same physical flash part for variable and PEIM
storage; as such, a write command to certain technologies would alter the contents of the entire part,
thus making the in situ PEIM execution not follow the required flow.
Copyright (c) 2006, Intel Corporation
All rights reserved. This program and the accompanying materials

3
IntelFrameworkPkg/Include/Ppi/RecoveryModule.h
View File

@@ -1,5 +1,6 @@
/** @file
This file declares Recovery Module PPI.
This file declares Recovery Module PPI.
This PPI is used to find and load the recovery files.
Copyright (c) 2007, Intel Corporation
All rights reserved. This program and the accompanying materials

20
IntelFrameworkPkg/Include/Ppi/S3Resume.h
View File

@@ -1,6 +1,22 @@
/** @file
This file declares S3 Resume PPI.
This file declares S3 Resume PPI which accomplishes the firmware S3 resume boot path
and transfers control to OS.
This PPI is published by the S3 resume PEIM and can be used on the S3 resume boot path to
restore the platform to its preboot configuration and transfer control to OS. The information that is
required for an S3 resume can be saved during the normal boot path using
EFI_ACPI_S3_SAVE_PROTOCOL. This presaved information can then be restored in the S3
resume boot path using EFI_PEI_S3_RESUME_PPI. Architecturally, the S3 resume PEIM is the
last PEIM to be dispatched in the S3 resume boot path.
Before using this PPI, the caller has to ensure the necessary information for the S3 resume, such as
the following, is available for the S3 resume boot path:
- EFI_ACPI_S3_RESUME_SCRIPT_TABLE script table. Type
EFI_ACPI_S3_RESUME_SCRIPT_TABLE is defined in the Intel<65> Platform Innovation
Framework for EFI Boot Script Specification.
- OS waking vector.
- The reserved memory range to be used for the S3 resume.
Otherwise, the S3 resume boot path may fail.
Copyright (c) 2007, 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

2
IntelFrameworkPkg/Include/Ppi/SectionExtraction.h
View File

@@ -1,5 +1,7 @@
/** @file
This file declares Section Extraction PPI.
This PPI supports encapsulating sections, such as GUIDed sections used to authenticate the file
encapsulation of other domain-specific wrapping.
Copyright (c) 2006, Intel Corporation
All rights reserved. This program and the accompanying materials

6
IntelFrameworkPkg/Include/Ppi/Security.h
View File

@@ -1,6 +1,10 @@
/** @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<49><4D>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

3
IntelFrameworkPkg/Include/Ppi/Smbus.h
View File

@@ -1,5 +1,6 @@
/** @file
This file declares Smbus PPI.
This file declares Smbus PPI which provides the basic I/O interfaces that a PEIM
uses to access its SMBus controller and the slave devices attached to it.
Copyright (c) 2007, Intel Corporation
All rights reserved. This program and the accompanying materials