tyler.durden
/
audk
mirror of https://github.com/acidanthera/audk.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Second set of changes based on a review of the code comments in the Include directory for typos, grammar issues, and language clarity. 

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@8467 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
pkandel 2009-06-04 16:16:15 +00:00
parent 7076244ef4
commit 1a2f870c9b
38 changed files with 268 additions and 307 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
MdePkg/Include/Base.h
View File

@ -333,18 +333,9 @@ struct _LIST_ENTRY {
// }
//
/**
Return the size of argument that has been aligned to sizeof (UINTN).
@param n The parameter size is to be aligned.
@return The aligned size
**/
#define _INT_SIZE_OF(n) ((sizeof (n) + sizeof (UINTN) - 1) &~(sizeof (UINTN) - 1))
#if defined(__GNUC__)
//
// Use GCC builtin macros for variable argument lists.
// Use GCC built-in macros for variable argument lists.
//
typedef __builtin_va_list VA_LIST;
@ -355,6 +346,15 @@ typedef __builtin_va_list VA_LIST;
#define VA_END(Marker) __builtin_va_end (Marker)
#else
/**
Return the size of argument that has been aligned to sizeof (UINTN).
@param n The parameter size to be aligned.
@return The aligned size
**/
#define _INT_SIZE_OF(n) ((sizeof (n) + sizeof (UINTN) - 1) &~(sizeof (UINTN) - 1))
///
/// Pointer to the start of a variable argument list. Same as CHAR8 *.
///
@ -409,29 +409,6 @@ typedef CHAR8 *VA_LIST;
#endif
///
/// Pointer to the start of a variable argument list stored in a memory buffer. Same as UINT8 *.
///
typedef UINTN *BASE_LIST;
/**
Returns an argument of a specified type from a variable argument list and updates
the pointer to the variable argument list to point to the next argument.
This function returns an argument of the type specified by TYPE from the beginning
of the variable argument list specified by Marker. Marker is then updated to point
to the next argument in the variable argument list. The method for computing the
pointer to the next argument in the argument list is CPU specific following the EFIAPI ABI.
@param Marker Pointer to the beginning of a variable argument list.
@param TYPE The type of argument to retrieve from the beginning
of the variable argument list.
@return An argument of the type specified by TYPE.
**/
#define BASE_ARG(Marker, TYPE) (*(TYPE *)((UINT8 *)(Marker = (BASE_LIST)((UINT8 *)Marker + _INT_SIZE_OF (TYPE))) - _INT_SIZE_OF (TYPE)))
/**
Macro that returns the byte offset of a field in a data structure.
@ -455,7 +432,7 @@ typedef UINTN *BASE_LIST;
This function computes the offset, in bytes, of field specified by Field from the beginning
of the data structure specified by TYPE. This offset is subtracted from Record, and is
used to return a pointer to a data structure of the type specified by TYPE.If the data type
used to return a pointer to a data structure of the type specified by TYPE. If the data type
specified by TYPE does not contain the field specified by Field, then the module will not compile.
@param Record Pointer to the field specified by Field within a data structure of type TYPE.

2
MdePkg/Include/Ebc/ProcessorBind.h
View File

@ -1,7 +1,7 @@
/** @file
Processor or compiler specific defines and types for EBC.
We currently only have one EBC complier so there may be some Intel compiler
We currently only have one EBC compiler so there may be some Intel compiler
specific functions in this file.
Copyright (c) 2006 - 2009, Intel Corporation<BR>

2
MdePkg/Include/Guid/Apriori.h
View File

@ -1,7 +1,7 @@
/** @file
GUID used as an FV filename for A Priori file. The A Priori file contains a
list of FV filenames that the DXE dispatcher will schedule reguardless of
the dependency grammer.
the dependency grammar.
Copyright (c) 2006 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials

2
MdePkg/Include/Guid/FileInfo.h
View File

@ -1,7 +1,7 @@
/** @file
Provides a GUID and a data structure that can be used with EFI_FILE_PROTOCOL.SetInfo()
and EFI_FILE_PROTOCOL.GetInfo() to set or get generic file information.
This guid is defined in UEFI specification.
This GUID is defined in UEFI specification.
Copyright (c) 2006 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials

2
MdePkg/Include/Guid/FileSystemInfo.h
View File

@ -1,7 +1,7 @@
/** @file
Provides a GUID and a data structure that can be used with EFI_FILE_PROTOCOL.GetInfo()
or EFI_FILE_PROTOCOL.SetInfo() to get or set information about the system's volume.
This guid is defined in UEFI specification.
This GUID is defined in UEFI specification.
Copyright (c) 2006 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials

2
MdePkg/Include/Guid/FileSystemVolumeLabelInfo.h
View File

@ -1,7 +1,7 @@
/** @file
Provides a GUID and a data structure that can be used with EFI_FILE_PROTOCOL.GetInfo()
or EFI_FILE_PROTOCOL.SetInfo() to get or set the system's volume label.
This guid is defined in UEFI specification.
This GUID is defined in UEFI specification.
Copyright (c) 2006 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials

2
MdePkg/Include/Guid/Mps.h
View File

@ -1,6 +1,6 @@
/** @file
GUIDs used for MPS entries in the UEFI 2.0 system table
ACPI is the primary means of exporting MP information to the OS. MPS obly was
ACPI is the primary means of exporting MPS information to the OS. MPS only was
included to support Itanium-based platform power on. So don't use it if you don't have too.
Copyright (c) 2006, Intel Corporation

11
MdePkg/Include/Ia32/ProcessorBind.h
View File

@ -1,5 +1,5 @@
/** @file
Processor or Compiler specific defines and types for Ia32 architecture.
Processor or Compiler specific defines and types for IA-32 architecture.
Copyright (c) 2006 - 2009, Intel Corporation<BR>
All rights reserved. This program and the accompanying materials
@ -333,7 +333,7 @@ typedef INT32 INTN;
#endif
//
// Macros for GNU assembly code
// For symbol name in GNU assembly code, an extra "_" is necessary
//
#if defined(__GNUC__)
#if defined(linux)
@ -341,16 +341,11 @@ typedef INT32 INTN;
#else
#define ASM_PFX(name) _##name
#endif
///
/// For GNU assembly code, .global or .globl can declare global symbols.
/// Define this macro to unify the usage.
///
#define ASM_GLOBAL .globl
#endif
/**
Return the pointer to the first instruction of a function given a function pointer.
On IA32 CPU architectures, these two pointer values are the same,
On IA-32 CPU architectures, these two pointer values are the same,
so the implementation of this macro is very simple.
@param FunctionPointer A pointer to a function.

110
MdePkg/Include/IndustryStandard/Pal.h
View File

@ -37,7 +37,7 @@
/**
PAL Procedure - PAL_CACHE_FLUSH.
Flush the instruction or data caches. It is required by IPF.
Flush the instruction or data caches. It is required by Itanium processors.
The PAL procedure supports the Static Registers calling
convention. It could be called at virtual mode and physical
mode.
@ -127,7 +127,7 @@ typedef struct {
PAL Procedure - PAL_CACHE_INFO.
Return detailed instruction or data cache information. It is
required by IPF. The PAL procedure supports the Static
required by Itanium processors. The PAL procedure supports the Static
Registers calling convention. It could be called at virtual
mode and physical mode.
@ -184,7 +184,7 @@ typedef struct {
PAL Procedure - PAL_CACHE_INIT.
Initialize the instruction or data caches. It is required by
IPF. The PAL procedure supports the Static Registers calling
Itanium processors. The PAL procedure supports the Static Registers calling
convention. It could be called at physical mode.
@param Index Index of PAL_CACHE_INIT within the list of PAL
@ -252,7 +252,7 @@ typedef struct {
PAL Procedure - PAL_CACHE_PROT_INFO.
Return instruction or data cache protection information. It is
required by IPF. The PAL procedure supports the Static
required by Itanium processors. The PAL procedure supports the Static
Registers calling convention. It could be called at physical
mode and Virtual mode.
@ -359,7 +359,7 @@ typedef struct {
PAL Procedure - PAL_CACHE_SUMMARY.
Return a summary of the cache hierarchy. It is required by
IPF. The PAL procedure supports the Static Registers calling
Itanium processors. The PAL procedure supports the Static Registers calling
convention. It could be called at physical mode and Virtual
mode.
@ -404,7 +404,7 @@ typedef struct {
PAL Procedure - PAL_MEM_ATTRIB.
Return a list of supported memory attributes.. It is required
by IPF. The PAL procedure supports the Static Registers calling
by Itanium processors. The PAL procedure supports the Static Registers calling
convention. It could be called at physical mode and Virtual
mode.
@ -428,7 +428,7 @@ typedef struct {
Used in architected sequence to transition pages from a
cacheable, speculative attribute to an uncacheable attribute.
It is required by IPF. The PAL procedure supports the Static
It is required by Itanium processors. The PAL procedure supports the Static
Registers calling convention. It could be called at physical
mode and Virtual mode.
@ -452,7 +452,7 @@ typedef struct {
PAL Procedure - PAL_PTCE_INFO.
Return information needed for ptc.e instruction to purge
entire TC. It is required by IPF. The PAL procedure supports
entire TC. It is required by Itanium processors. The PAL procedure supports
the Static Registers calling convention. It could be called at
physical mode and Virtual mode.
@ -507,7 +507,7 @@ typedef struct {
PAL Procedure - PAL_VM_INFO.
Return detailed information about virtual memory features
supported in the processor. It is required by IPF. The PAL
supported in the processor. It is required by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It
could be called at physical mode and Virtual mode.
@ -542,7 +542,7 @@ typedef struct {
PAL Procedure - PAL_VM_PAGE_SIZE.
Return virtual memory TC and hardware walker page sizes
supported in the processor. It is required by IPF. The PAL
supported in the processor. It is required by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It
could be called at physical mode and Virtual mode.
@ -613,7 +613,7 @@ typedef struct {
PAL Procedure - PAL_VM_SUMMARY.
Return summary information about virtual memory features
supported in the processor. It is required by IPF. The PAL
supported in the processor. It is required by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It
could be called at physical mode and Virtual mode.
@ -646,7 +646,7 @@ typedef struct {
PAL Procedure - PAL_VM_TR_READ.
Read contents of a translation register. It is required by
IPF. The PAL procedure supports the Stacked Register calling
Itanium processors. The PAL procedure supports the Stacked Register calling
convention. It could be called at physical mode.
@param Index Index of PAL_VM_TR_READ within the list
@ -838,7 +838,7 @@ typedef struct {
PAL Procedure - PAL_BUS_GET_FEATURES.
Return configurable processor bus interface features and their
current settings. It is required by IPF. The PAL procedure
current settings. It is required by Itanium processors. The PAL procedure
supports the Stacked Register calling convention. It could be
called at physical mode.
@ -862,7 +862,7 @@ typedef struct {
PAL Procedure - PAL_BUS_SET_FEATURES.
Enable or disable configurable features in processor bus
interface. It is required by IPF. It is required by IPF. The PAL procedure
interface. It is required by Itanium processors. The PAL procedure
supports the Static Registers calling convention. It could be
called at physical mode.
@ -883,7 +883,7 @@ typedef struct {
PAL Procedure - PAL_DEBUG_INFO.
Return the number of instruction and data breakpoint
registers. It is required by IPF. It is required by IPF. The
registers. It is required by Itanium processors. The
PAL procedure supports the Static Registers calling
convention. It could be called at physical mode and virtual
mode.
@ -909,7 +909,7 @@ typedef struct {
PAL Procedure - PAL_FIXED_ADDR.
Return the fixed component of a processor's directed address.
It is required by IPF. It is required by IPF. The PAL
It is required by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It
could be called at physical mode and virtual mode.
@ -954,7 +954,7 @@ typedef struct {
Return ratio of processor, bus, and interval time counter to
processor input clock or output clock for platform use, if
generated by the processor. It is required by IPF. The PAL
generated by the processor. It is required by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It
could be called at physical mode and virtual mode.
@ -1081,7 +1081,7 @@ typedef struct {
PAL Procedure - PAL_PERF_MON_INFO.
Return the number and type of performance monitors. It is
required by IPF. The PAL procedure supports the Static
required by Itanium processors. The PAL procedure supports the Static
Registers calling convention. It could be called at physical
mode and virtual mode.
@ -1107,7 +1107,7 @@ typedef struct {
PAL Procedure - PAL_PLATFORM_ADDR.
Specify processor interrupt block address and I/O port space
address. It is required by IPF. The PAL procedure supports the
address. It is required by Itanium processors. The PAL procedure supports the
Static Registers calling convention. It could be called at
physical mode and virtual mode.
@ -1448,7 +1448,7 @@ typedef struct {
PAL Procedure - PAL_PROC_GET_FEATURES.
Return configurable processor features and their current
setting. It is required by IPF. The PAL procedure supports the
setting. It is required by Itanium processors. The PAL procedure supports the
Static Registers calling convention. It could be called at
physical mode and virtual mode.
@ -1482,7 +1482,7 @@ typedef struct {
PAL Procedure - PAL_PROC_SET_FEATURES.
Enable or disable configurable processor features. It is
required by IPF. The PAL procedure supports the Static
required by Itanium processors. The PAL procedure supports the Static
Registers calling convention. It could be called at physical
mode.
@ -1519,7 +1519,7 @@ typedef struct {
/**
PAL Procedure - PAL_REGISTER_INFO.
Return AR and CR register information. It is required by IPF.
Return AR and CR register information. It is required by Itanium processors.
The PAL procedure supports the Static Registers calling
convention. It could be called at physical mode and virtual
mode.
@ -1546,7 +1546,7 @@ typedef struct {
/**
PAL Procedure - PAL_RSE_INFO.
Return RSE information. It is required by IPF. The PAL
Return RSE information. It is required by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It
could be called at physical mode and virtual mode.
@ -1587,7 +1587,7 @@ typedef struct {
/**
PAL Procedure - PAL_VERSION.
Return version of PAL code. It is required by IPF. The PAL
Return version of PAL code. It is required by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It
could be called at physical mode and virtual mode.
@ -1623,7 +1623,7 @@ typedef struct {
PAL Procedure - PAL_MC_CLEAR_LOG.
Clear all error information from processor error logging
registers. It is required by IPF. The PAL procedure supports
registers. It is required by Itanium processors. The PAL procedure supports
the Static Registers calling convention. It could be called at
physical mode and virtual mode.
@ -1644,7 +1644,7 @@ typedef struct {
PAL Procedure - PAL_MC_DRAIN.
Ensure that all operations that could cause an MCA have
completed. It is required by IPF. The PAL procedure supports
completed. It is required by Itanium processors. The PAL procedure supports
the Static Registers calling convention. It could be called at
physical mode and virtual mode.
@ -1916,7 +1916,7 @@ typedef struct {
PAL Procedure - PAL_MC_ERROR_INFO.
Return Processor Machine Check Information and Processor
Static State for logging by SAL. It is required by IPF. The
Static State for logging by SAL. It is required by Itanium processors. The
PAL procedure supports the Static Registers calling
convention. It could be called at physical and virtual mode.
@ -1955,7 +1955,7 @@ typedef struct {
PAL Procedure - PAL_MC_EXPECTED.
Set/Reset Expected Machine Check Indicator. It is required by
IPF. The PAL procedure supports the Static Registers calling
Itanium processors. The PAL procedure supports the Static Registers calling
convention. It could be called at physical mode.
@param Index Index of PAL_MC_EXPECTED within the list of PAL
@ -1979,7 +1979,7 @@ typedef struct {
PAL Procedure - PAL_MC_REGISTER_MEM.
Register min-state save area with PAL for machine checks and
inits. It is required by IPF. The PAL procedure supports the
inits. It is required by Itanium processors. The PAL procedure supports the
Static Registers calling convention. It could be called at
physical mode.
@ -1999,7 +1999,7 @@ typedef struct {
PAL Procedure - PAL_MC_RESUME.
Restore minimal architected state and return to interrupted
process. It is required by IPF. The PAL procedure supports the
process. It is required by Itanium processors. The PAL procedure supports the
Static Registers calling convention. It could be called at
physical mode.
@ -2057,7 +2057,7 @@ typedef struct {
PAL Procedure - PAL_HALT_INFO.
Return the low power capabilities of the processor. It is
required by IPF. The PAL procedure supports the
required by Itanium processors. The PAL procedure supports the
Stacked Registers calling convention. It could be called at
physical and virtual mode.
@ -2078,7 +2078,7 @@ typedef struct {
PAL Procedure - PAL_HALT_LIGHT.
Enter the low power LIGHT HALT state. It is required by
IPF. The PAL procedure supports the Static Registers calling
Itanium processors. The PAL procedure supports the Static Registers calling
convention. It could be called at physical and virtual mode.
@param Index Index of PAL_HALT_LIGHT within the list of PAL
@ -2095,7 +2095,7 @@ typedef struct {
PAL Procedure - PAL_CACHE_LINE_INIT.
Initialize tags and data of a cache line for processor
testing. It is required by IPF. The PAL procedure supports the
testing. It is required by Itanium processors. The PAL procedure supports the
Static Registers calling convention. It could be called at
physical and virtual mode.
@ -2185,7 +2185,7 @@ typedef struct {
Returns alignment and size requirements needed for the memory
buffer passed to the PAL_TEST_PROC procedure as well as
information on self-test control words for the processor self
tests. It is required by IPF. The PAL procedure supports the
tests. It is required by Itanium processors. The PAL procedure supports the
Static Registers calling convention. It could be called at
physical mode.
@ -2347,7 +2347,7 @@ typedef struct {
/**
PAL Procedure - PAL_TEST_PROC.
Perform late processor self test. It is required by IPF. The
Perform late processor self test. It is required by Itanium processors. The
PAL procedure supports the Static Registers calling
convention. It could be called at physical mode.
@ -2391,7 +2391,7 @@ typedef struct {
PAL Procedure - PAL_COPY_INFO.
Return information needed to relocate PAL procedures and PAL
PMI code to memory. It is required by IPF. The PAL procedure
PMI code to memory. It is required by Itanium processors. The PAL procedure
supports the Static Registers calling convention. It could be
called at physical mode.
@ -2425,7 +2425,7 @@ typedef struct {
PAL Procedure - PAL_COPY_PAL.
Relocate PAL procedures and PAL PMI code to memory. It is
required by IPF. The PAL procedure supports the Stacked
required by Itanium processors. The PAL procedure supports the Stacked
Registers calling convention. It could be called at physical
mode.
@ -2524,7 +2524,7 @@ typedef struct {
PAL Procedure - PAL_PMI_ENTRYPOINT.
Register PMI memory entrypoints with processor. It is required
by IPF. The PAL procedure supports the Stacked Registers
by Itanium processors. The PAL procedure supports the Stacked Registers
calling convention. It could be called at physical mode.
@param Index Index of PAL_PMI_ENTRYPOINT within the list of
@ -2558,7 +2558,7 @@ typedef struct {
PAL Procedure - PAL_BRAND_INFO.
Provides processor branding information. It is optional by
IPF. The PAL procedure supports the Stacked Registers calling
Itanium processors. The PAL procedure supports the Stacked Registers calling
convention. It could be called at physical and Virtual mode.
@param Index Index of PAL_BRAND_INFO within the list of PAL
@ -2586,7 +2586,7 @@ typedef struct {
PAL Procedure - PAL_GET_HW_POLICY.
Returns the current hardware resource sharing policy of the
processor. It is optional by IPF. The PAL procedure supports
processor. It is optional by Itanium processors. The PAL procedure supports
the Static Registers calling convention. It could be called at
physical and Virtual mode.
@ -2635,7 +2635,7 @@ typedef struct {
PAL Procedure - PAL_SET_HW_POLICY.
Sets the current hardware resource sharing policy of the
processor. It is optional by IPF. The PAL procedure supports
processor. It is optional by Itanium processors. The PAL procedure supports
the Static Registers calling convention. It could be called at
physical and Virtual mode.
@ -2825,7 +2825,7 @@ typedef struct {
Injects the requested processor error or returns information
on the supported injection capabilities for this particular
processor implementation. It is optional by IPF. The PAL
processor implementation. It is optional by Itanium processors. The PAL
procedure supports the Stacked Registers calling convention.
It could be called at physical and Virtual mode.
@ -2880,7 +2880,7 @@ typedef struct {
PAL Procedure - PAL_GET_PSTATE.
Returns the performance index of the processor. It is optional
by IPF. The PAL procedure supports the Stacked Registers
by Itanium processors. The PAL procedure supports the Stacked Registers
calling convention. It could be called at physical and Virtual
mode.
@ -2928,7 +2928,7 @@ typedef struct {
PAL Procedure - PAL_PSTATE_INFO.
Returns information about the P-states supported by the
processor. It is optional by IPF. The PAL procedure supports
processor. It is optional by Itanium processors. The PAL procedure supports
the Static Registers calling convention. It could be called
at physical and Virtual mode.
@ -2955,7 +2955,7 @@ typedef struct {
PAL Procedure - PAL_SET_PSTATE.
To request a processor transition to a given P-state. It is
optional by IPF. The PAL procedure supports the Stacked
optional by Itanium processors. The PAL procedure supports the Stacked
Registers calling convention. It could be called at physical
and Virtual mode.
@ -2982,7 +2982,7 @@ typedef struct {
PAL Procedure - PAL_SHUTDOWN.
Put the logical processor into a low power state which can be
exited only by a reset event. It is optional by IPF. The PAL
exited only by a reset event. It is optional by Itanium processors. The PAL
procedure supports the Static Registers calling convention. It
could be called at physical mode.
@ -3017,7 +3017,7 @@ typedef struct {
PAL Procedure - PAL_MEMORY_BUFFER.
Provides cacheable memory to PAL for exclusive use during
runtime. It is optional by IPF. The PAL procedure supports the
runtime. It is optional by Itanium processors. The PAL procedure supports the
Static Registers calling convention. It could be called at
physical mode.
@ -3051,7 +3051,7 @@ typedef struct {
PAL Procedure - PAL_VP_CREATE.
Initializes a new vpd for the operation of a new virtual
processor in the virtual environment. It is optional by IPF.
processor in the virtual environment. It is optional by Itanium processors.
The PAL procedure supports the Stacked Registers calling
convention. It could be called at Virtual mode.
@ -3089,7 +3089,7 @@ typedef struct {
PAL Procedure - PAL_VP_ENV_INFO.
Returns the parameters needed to enter a virtual environment.
It is optional by IPF. The PAL procedure supports the Stacked
It is optional by Itanium processors. The PAL procedure supports the Stacked
Registers calling convention. It could be called at Virtual
mode.
@ -3123,7 +3123,7 @@ typedef struct {
PAL Procedure - PAL_VP_EXIT_ENV.
Allows a logical processor to exit a virtual environment.
It is optional by IPF. The PAL procedure supports the Stacked
It is optional by Itanium processors. The PAL procedure supports the Stacked
Registers calling convention. It could be called at Virtual
mode.
@ -3147,7 +3147,7 @@ typedef struct {
PAL Procedure - PAL_VP_INIT_ENV.
Allows a logical processor to enter a virtual environment. It
is optional by IPF. The PAL procedure supports the Stacked
is optional by Itanium processors. The PAL procedure supports the Stacked
Registers calling convention. It could be called at Virtual
mode.
@ -3195,7 +3195,7 @@ typedef struct {
Register a different host IVT and/or a different optional
virtualization intercept handler for the virtual processor
specified by vpd. It is optional by IPF. The PAL procedure
specified by vpd. It is optional by Itanium processors. The PAL procedure
supports the Stacked Registers calling convention. It could be
called at Virtual mode.
@ -3223,7 +3223,7 @@ typedef struct {
PAL Procedure - PAL_VP_RESTORE.
Restores virtual processor state for the specified vpd on the
logical processor. It is optional by IPF. The PAL procedure
logical processor. It is optional by Itanium processors. The PAL procedure
supports the Stacked Registers calling convention. It could be
called at Virtual mode.
@ -3250,7 +3250,7 @@ typedef struct {
PAL Procedure - PAL_VP_SAVE.
Saves virtual processor state for the specified vpd on the
logical processor. It is optional by IPF. The PAL procedure
logical processor. It is optional by Itanium processors. The PAL procedure
supports the Stacked Registers calling convention. It could be
called at Virtual mode.
@ -3278,7 +3278,7 @@ typedef struct {
PAL Procedure - PAL_VP_TERMINATE.
Terminates operation for the specified virtual processor. It
is optional by IPF. The PAL procedure supports the Stacked
is optional by Itanium processors. The PAL procedure supports the Stacked
Registers calling convention. It could be called at Virtual
mode.

2
MdePkg/Include/IndustryStandard/Pci.h
View File

@ -1,5 +1,5 @@
/** @file
Support for The latest PCI standard.
Support for the latest PCI standard.
Copyright (c) 2006 - 2008, Intel Corporation
All rights reserved. This program and the accompanying materials

2
MdePkg/Include/IndustryStandard/Tpm12.h
View File

@ -151,7 +151,7 @@ typedef UINT32 TPM_KEY_CONTROL;
///
typedef UINT32 TPM_NV_INDEX;
///
/// The family ID. Families ID's are automatically assigned a sequence number by the TPM.
/// The family ID. Family IDs are automatically assigned a sequence number by the TPM.
/// A trusted process can set the FamilyID value in an individual row to NULL, which
/// invalidates that row. The family ID resets to NULL on each change of TPM Owner.
///

16
MdePkg/Include/Ipf/ProcessorBind.h
View File

@ -1,5 +1,5 @@
/** @file
Processor or Compiler specific defines and types for Intel Itanium(TM).
Processor or Compiler specific defines and types for Intel Itanium(TM) processors.
Copyright (c) 2006 - 2009, Intel Corporation<BR>
All rights reserved. This program and the accompanying materials
@ -17,7 +17,7 @@
///
/// Define the processor type so other code can make processor based choices
/// Define the processor type so other code can make processor-based choices
///
#define MDE_CPU_IPF
@ -84,7 +84,7 @@
//
// Can not cast a function pointer to a data pointer. We need to do this on
// IPF to get access to the PLABEL.
// Itanium processors to get access to the PLABEL.
//
#pragma warning ( disable : 4514 )
@ -108,7 +108,7 @@
#if defined(_MSC_EXTENSIONS)
//
// use Microsoft C complier dependent integer width types
// use Microsoft C compiler dependent integer width types
//
///
@ -392,12 +392,6 @@ typedef INT64 INTN;
#define GLOBAL_REMOVE_IF_UNREFERENCED
#endif
///
/// For GNU assembly code, .global or .globl can declare global symbols.
/// Define this macro to unify the usage.
///
#define ASM_GLOBAL .globl
///
/// A pointer to a function in IPF points to a plabel.
///
@ -418,7 +412,7 @@ typedef struct {
/**
Return the pointer to the first instruction of a function given a function pointer.
For Itanium CPUs, all function calls are made through a PLABEL, so a pointer to a function
For Itanium processors, all function calls are made through a PLABEL, so a pointer to a function
is actually a pointer to a PLABEL. The pointer to the first instruction of the function
is contained within the PLABEL. This macro may be used to retrieve a pointer to the first
instruction of a function independent of the CPU architecture being used. This is very

162
MdePkg/Include/Library/BaseLib.h
View File

@ -1,6 +1,6 @@
/** @file
Provides string functions, linked list functions, math functions, synchronization
functions, and CPU architecture specific functions.
functions, and CPU architecture-specific functions.
Copyright (c) 2006 - 2008, Intel Corporation<BR>
All rights reserved. This program and the accompanying materials
@ -17,11 +17,11 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
#define __BASE_LIB__
//
// Definitions for architecture specific types
// Definitions for architecture-specific types
//
#if defined (MDE_CPU_IA32)
///
/// IA32 context buffer used by SetJump() and LongJump()
/// IA-32 architecture context buffer used by SetJump() and LongJump()
///
typedef struct {
UINT32 Ebx;
@ -39,7 +39,7 @@ typedef struct {
#if defined (MDE_CPU_IPF)
///
/// IPF context buffer used by SetJump() and LongJump()
/// Itanium architecture context buffer used by SetJump() and LongJump()
///
typedef struct {
UINT64 F2[2];
@ -88,7 +88,7 @@ typedef struct {
#if defined (MDE_CPU_X64)
///
/// x64 context buffer used by SetJump() and LongJump()
/// x64 architecture context buffer used by SetJump() and LongJump()
///
typedef struct {
UINT64 Rbx;
@ -3159,7 +3159,7 @@ MemoryFence (
calls to LongJump() cause a non-zero value to be returned by SetJump().
If JumpBuffer is NULL, then ASSERT().
For IPF CPUs, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().
For Itanium processors, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().
NOTE: The structure BASE_LIBRARY_JUMP_BUFFER is CPU architecture specific.
The same structure must never be used for more than one CPU architecture context.
@ -3186,7 +3186,7 @@ SetJump (
the state of JumpBuffer.
If JumpBuffer is NULL, then ASSERT().
For IPF CPUs, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().
For Itanium processors, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().
If Value is 0, then ASSERT().
@param JumpBuffer A pointer to CPU context buffer.
@ -3311,8 +3311,8 @@ CpuPause (
by Context1 and Context2. Context1 and Context2 are optional and may
be NULL. The function EntryPoint must never return. This function
supports a variable number of arguments following the NewStack parameter.
These additional arguments are ignored on IA-32, x64, and EBC.
IPF CPUs expect one additional parameter of type VOID * that specifies
These additional arguments are ignored on IA-32, x64, and EBC architectures.
Itanium processors expect one additional parameter of type VOID * that specifies
the new backing store pointer.
If EntryPoint is NULL, then ASSERT().
@ -3325,8 +3325,8 @@ CpuPause (
function.
@param NewStack A pointer to the new stack to use for the EntryPoint
function.
@param ... This variable argument list is ignored for IA32, x64, and EBC.
For IPF, this variable argument list is expected to contain
@param ... This variable argument list is ignored for IA-32, x64, and EBC architectures.
For Itanium processors, this variable argument list is expected to contain
a single parameter of type VOID * that specifies the new backing
store pointer.
@ -3384,7 +3384,7 @@ CpuDeadLoop (
line containing Address + Length - 1 is flushed. This function may choose to flush
the entire cache if that is more efficient than flushing the specified range. If
Length is 0, the no cache lines are flushed. Address is returned.
This function is only available on IPF.
This function is only available on Itanium processors.
If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
@ -3410,7 +3410,7 @@ AsmFlushCacheRange (
Executes a FC instruction
Executes a FC instruction on the cache line specified by Address.
The cache line size affected is at least 32-bytes (aligned on a 32-byte boundary).
An implementation may flush a larger region. This function is only available on IPF.
An implementation may flush a larger region. This function is only available on Itanium processors.
@param Address The Address of cache line to be flushed.
@ -3428,7 +3428,7 @@ AsmFc (
Executes a FC.I instruction.
Executes a FC.I instruction on the cache line specified by Address.
The cache line size affected is at least 32-bytes (aligned on a 32-byte boundary).
An implementation may flush a larger region. This function is only available on IPF.
An implementation may flush a larger region. This function is only available on Itanium processors.
@param Address The Address of cache line to be flushed.
@ -3451,7 +3451,7 @@ AsmFci (
No parameter checking is performed on Index. If the Index value is beyond the
implemented CPUID register range, a Reserved Register/Field fault may occur. The caller
must either guarantee that Index is valid, or the caller must set up fault handlers to
catch the faults. This function is only available on IPF.
catch the faults. This function is only available on Itanium processors.
@param Index The 8-bit Processor Identifier Register index to read.
@ -3467,7 +3467,7 @@ AsmReadCpuid (
/**
Reads the current value of 64-bit Processor Status Register (PSR).
This function is only available on IPF.
This function is only available on Itanium processors.
@return The current value of PSR.
@ -3485,7 +3485,7 @@ AsmReadPsr (
No parameter checking is performed on Value. All bits of Value corresponding to
reserved fields of PSR must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults. This function is only available on IPF.
fault handlers to catch the faults. This function is only available on Itanium processors.
@param Value The 64-bit value to write to PSR.
@ -3503,7 +3503,7 @@ AsmWritePsr (
Reads the current value of 64-bit Kernel Register #0 (KR0).
Reads and returns the current value of KR0.
This function is only available on IPF.
This function is only available on Itanium processors.
@return The current value of KR0.
@ -3519,7 +3519,7 @@ AsmReadKr0 (
Reads the current value of 64-bit Kernel Register #1 (KR1).
Reads and returns the current value of KR1.
This function is only available on IPF.
This function is only available on Itanium processors.
@return The current value of KR1.
@ -3535,7 +3535,7 @@ AsmReadKr1 (
Reads the current value of 64-bit Kernel Register #2 (KR2).
Reads and returns the current value of KR2.
This function is only available on IPF.
This function is only available on Itanium processors.
@return The current value of KR2.
@ -3551,7 +3551,7 @@ AsmReadKr2 (
Reads the current value of 64-bit Kernel Register #3 (KR3).
Reads and returns the current value of KR3.
This function is only available on IPF.
This function is only available on Itanium processors.
@return The current value of KR3.
@ -3567,7 +3567,7 @@ AsmReadKr3 (
Reads the current value of 64-bit Kernel Register #4 (KR4).
Reads and returns the current value of KR4.
This function is only available on IPF.
This function is only available on Itanium processors.
@return The current value of KR4.
@ -3583,7 +3583,7 @@ AsmReadKr4 (
Reads the current value of 64-bit Kernel Register #5 (KR5).
Reads and returns the current value of KR5.
This function is only available on IPF.
This function is only available on Itanium processors.
@return The current value of KR5.
@ -3599,7 +3599,7 @@ AsmReadKr5 (
Reads the current value of 64-bit Kernel Register #6 (KR6).
Reads and returns the current value of KR6.
This function is only available on IPF.
This function is only available on Itanium processors.
@return The current value of KR6.
@ -3615,7 +3615,7 @@ AsmReadKr6 (
Reads the current value of 64-bit Kernel Register #7 (KR7).
Reads and returns the current value of KR7.
This function is only available on IPF.
This function is only available on Itanium processors.
@return The current value of KR7.
@ -3631,7 +3631,7 @@ AsmReadKr7 (
Write the current value of 64-bit Kernel Register #0 (KR0).
Writes the current value of KR0. The 64-bit value written to
the KR0 is returned. This function is only available on IPF.
the KR0 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR0.
@ -3649,7 +3649,7 @@ AsmWriteKr0 (
Write the current value of 64-bit Kernel Register #1 (KR1).
Writes the current value of KR1. The 64-bit value written to
the KR1 is returned. This function is only available on IPF.
the KR1 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR1.
@ -3667,7 +3667,7 @@ AsmWriteKr1 (
Write the current value of 64-bit Kernel Register #2 (KR2).
Writes the current value of KR2. The 64-bit value written to
the KR2 is returned. This function is only available on IPF.
the KR2 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR2.
@ -3685,7 +3685,7 @@ AsmWriteKr2 (
Write the current value of 64-bit Kernel Register #3 (KR3).
Writes the current value of KR3. The 64-bit value written to
the KR3 is returned. This function is only available on IPF.
the KR3 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR3.
@ -3703,7 +3703,7 @@ AsmWriteKr3 (
Write the current value of 64-bit Kernel Register #4 (KR4).
Writes the current value of KR4. The 64-bit value written to
the KR4 is returned. This function is only available on IPF.
the KR4 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR4.
@ -3721,7 +3721,7 @@ AsmWriteKr4 (
Write the current value of 64-bit Kernel Register #5 (KR5).
Writes the current value of KR5. The 64-bit value written to
the KR5 is returned. This function is only available on IPF.
the KR5 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR5.
@ -3739,7 +3739,7 @@ AsmWriteKr5 (
Write the current value of 64-bit Kernel Register #6 (KR6).
Writes the current value of KR6. The 64-bit value written to
the KR6 is returned. This function is only available on IPF.
the KR6 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR6.
@ -3757,7 +3757,7 @@ AsmWriteKr6 (
Write the current value of 64-bit Kernel Register #7 (KR7).
Writes the current value of KR7. The 64-bit value written to
the KR7 is returned. This function is only available on IPF.
the KR7 is returned. This function is only available on Itanium processors.
@param Value The 64-bit value to write to KR7.
@ -3775,7 +3775,7 @@ AsmWriteKr7 (
Reads the current value of Interval Timer Counter Register (ITC).
Reads and returns the current value of ITC.
This function is only available on IPF.
This function is only available on Itanium processors.
@return The current value of ITC.
@ -3791,7 +3791,7 @@ AsmReadItc (
Reads the current value of Interval Timer Vector Register (ITV).
Reads and returns the current value of ITV.
This function is only available on IPF.
This function is only available on Itanium processors.
@return The current value of ITV.
@ -3807,7 +3807,7 @@ AsmReadItv (
Reads the current value of Interval Timer Match Register (ITM).
Reads and returns the current value of ITM.
This function is only available on IPF.
This function is only available on Itanium processors.
@return The current value of ITM.
**/
@ -3822,7 +3822,7 @@ AsmReadItm (
Writes the current value of 64-bit Interval Timer Counter Register (ITC).
Writes the current value of ITC. The 64-bit value written to the ITC is returned.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Value The 64-bit value to write to ITC.
@ -3840,7 +3840,7 @@ AsmWriteItc (
Writes the current value of 64-bit Interval Timer Match Register (ITM).
Writes the current value of ITM. The 64-bit value written to the ITM is returned.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Value The 64-bit value to write to ITM.
@ -3862,7 +3862,7 @@ AsmWriteItm (
reserved fields of ITV must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Value The 64-bit value to write to ITV.
@ -3879,7 +3879,7 @@ AsmWriteItv (
/**
Reads the current value of Default Control Register (DCR).
Reads and returns the current value of DCR. This function is only available on IPF.
Reads and returns the current value of DCR. This function is only available on Itanium processors.
@return The current value of DCR.
@ -3894,7 +3894,7 @@ AsmReadDcr (
/**
Reads the current value of Interruption Vector Address Register (IVA).
Reads and returns the current value of IVA. This function is only available on IPF.
Reads and returns the current value of IVA. This function is only available on Itanium processors.
@return The current value of IVA.
**/
@ -3908,7 +3908,7 @@ AsmReadIva (
/**
Reads the current value of Page Table Address Register (PTA).
Reads and returns the current value of PTA. This function is only available on IPF.
Reads and returns the current value of PTA. This function is only available on Itanium processors.
@return The current value of PTA.
@ -3928,7 +3928,7 @@ AsmReadPta (
reserved fields of DCR must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Value The 64-bit value to write to DCR.
@ -3948,7 +3948,7 @@ AsmWriteDcr (
Writes the current value of IVA. The 64-bit value written to the IVA is returned.
The size of vector table is 32 K bytes and is 32 K bytes aligned
the low 15 bits of Value is ignored when written.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Value The 64-bit value to write to IVA.
@ -3970,7 +3970,7 @@ AsmWriteIva (
reserved fields of DCR must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Value The 64-bit value to write to PTA.
@ -3986,7 +3986,7 @@ AsmWritePta (
/**
Reads the current value of Local Interrupt ID Register (LID).
Reads and returns the current value of LID. This function is only available on IPF.
Reads and returns the current value of LID. This function is only available on Itanium processors.
@return The current value of LID.
@ -4001,7 +4001,7 @@ AsmReadLid (
/**
Reads the current value of External Interrupt Vector Register (IVR).
Reads and returns the current value of IVR. This function is only available on IPF.
Reads and returns the current value of IVR. This function is only available on Itanium processors.
@return The current value of IVR.
@ -4016,7 +4016,7 @@ AsmReadIvr (
/**
Reads the current value of Task Priority Register (TPR).
Reads and returns the current value of TPR. This function is only available on IPF.
Reads and returns the current value of TPR. This function is only available on Itanium processors.
@return The current value of TPR.
@ -4031,7 +4031,7 @@ AsmReadTpr (
/**
Reads the current value of External Interrupt Request Register #0 (IRR0).
Reads and returns the current value of IRR0. This function is only available on IPF.
Reads and returns the current value of IRR0. This function is only available on Itanium processors.
@return The current value of IRR0.
@ -4046,7 +4046,7 @@ AsmReadIrr0 (
/**
Reads the current value of External Interrupt Request Register #1 (IRR1).
Reads and returns the current value of IRR1. This function is only available on IPF.
Reads and returns the current value of IRR1. This function is only available on Itanium processors.
@return The current value of IRR1.
@ -4061,7 +4061,7 @@ AsmReadIrr1 (
/**
Reads the current value of External Interrupt Request Register #2 (IRR2).
Reads and returns the current value of IRR2. This function is only available on IPF.
Reads and returns the current value of IRR2. This function is only available on Itanium processors.
@return The current value of IRR2.
@ -4076,7 +4076,7 @@ AsmReadIrr2 (
/**
Reads the current value of External Interrupt Request Register #3 (IRR3).
Reads and returns the current value of IRR3. This function is only available on IPF.
Reads and returns the current value of IRR3. This function is only available on Itanium processors.
@return The current value of IRR3.
@ -4091,7 +4091,7 @@ AsmReadIrr3 (
/**
Reads the current value of Performance Monitor Vector Register (PMV).
Reads and returns the current value of PMV. This function is only available on IPF.
Reads and returns the current value of PMV. This function is only available on Itanium processors.
@return The current value of PMV.
@ -4106,7 +4106,7 @@ AsmReadPmv (
/**
Reads the current value of Corrected Machine Check Vector Register (CMCV).
Reads and returns the current value of CMCV. This function is only available on IPF.
Reads and returns the current value of CMCV. This function is only available on Itanium processors.
@return The current value of CMCV.
@ -4121,7 +4121,7 @@ AsmReadCmcv (
/**
Reads the current value of Local Redirection Register #0 (LRR0).
Reads and returns the current value of LRR0. This function is only available on IPF.
Reads and returns the current value of LRR0. This function is only available on Itanium processors.
@return The current value of LRR0.
@ -4136,7 +4136,7 @@ AsmReadLrr0 (
/**
Reads the current value of Local Redirection Register #1 (LRR1).
Reads and returns the current value of LRR1. This function is only available on IPF.
Reads and returns the current value of LRR1. This function is only available on Itanium processors.
@return The current value of LRR1.
@ -4156,7 +4156,7 @@ AsmReadLrr1 (
reserved fields of LID must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Value The 64-bit value to write to LID.
@ -4178,7 +4178,7 @@ AsmWriteLid (
reserved fields of TPR must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Value The 64-bit value to write to TPR.
@ -4195,7 +4195,7 @@ AsmWriteTpr (
/**
Performs a write operation on End OF External Interrupt Register (EOI).
Writes a value of 0 to the EOI Register. This function is only available on IPF.
Writes a value of 0 to the EOI Register. This function is only available on Itanium processors.
**/
VOID
@ -4213,7 +4213,7 @@ AsmWriteEoi (
to reserved fields of PMV must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Value The 64-bit value to write to PMV.
@ -4235,7 +4235,7 @@ AsmWritePmv (
to reserved fields of CMCV must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Value The 64-bit value to write to CMCV.
@ -4257,7 +4257,7 @@ AsmWriteCmcv (
to reserved fields of LRR0 must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must set up
fault handlers to catch the faults.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Value The 64-bit value to write to LRR0.
@ -4279,7 +4279,7 @@ AsmWriteLrr0 (
to reserved fields of LRR1 must be 0 or a Reserved Register/Field fault may occur.
The caller must either guarantee that Value is valid, or the caller must
set up fault handlers to catch the faults.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Value The 64-bit value to write to LRR1.
@ -4304,7 +4304,7 @@ AsmWriteLrr1 (
is beyond the implemented IBR register range, a Reserved Register/Field fault may
occur. The caller must either guarantee that Index is valid, or the caller must
set up fault handlers to catch the faults.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Index The 8-bit Instruction Breakpoint Register index to read.
@ -4329,7 +4329,7 @@ AsmReadIbr (
the implemented DBR register range, a Reserved Register/Field fault may occur.
The caller must either guarantee that Index is valid, or the caller must set up
fault handlers to catch the faults.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Index The 8-bit Data Breakpoint Register index to read.
@ -4354,7 +4354,7 @@ AsmReadDbr (
register set is implementation dependent. No parameter checking is performed
on Index. If the Index value is beyond the implemented PMC register range,
zero value will be returned.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Index The 8-bit Performance Monitor Configuration Register index to read.
@ -4380,7 +4380,7 @@ AsmReadPmc (
register set is implementation dependent. No parameter checking is performed
on Index. If the Index value is beyond the implemented PMD register range,
zero value will be returned.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Index The 8-bit Performance Monitor Data Register index to read.
@ -4406,7 +4406,7 @@ AsmReadPmd (
is beyond the implemented IBR register range, a Reserved Register/Field fault may
occur. The caller must either guarantee that Index is valid, or the caller must
set up fault handlers to catch the faults.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Index The 8-bit Instruction Breakpoint Register index to write.
@param Value The 64-bit value to write to IBR.
@ -4434,7 +4434,7 @@ AsmWriteIbr (
DBR register range, a Reserved Register/Field fault may occur. The caller must
either guarantee that Index is valid, or the caller must set up fault handlers to
catch the faults.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Index The 8-bit Data Breakpoint Register index to write.
@param Value The 64-bit value to write to DBR.
@ -4461,7 +4461,7 @@ AsmWriteDbr (
counters (PMC/PMD pairs). The remainder of PMC and PMD register set is implementation
dependent. No parameter checking is performed on Index. If the Index value is
beyond the implemented PMC register range, the write is ignored.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Index The 8-bit Performance Monitor Configuration Register index to write.
@param Value The 64-bit value to write to PMC.
@ -4488,7 +4488,7 @@ AsmWritePmc (
performance counters (PMC/PMD pairs). The remainder of PMC and PMD register set
is implementation dependent. No parameter checking is performed on Index. If the
Index value is beyond the implemented PMD register range, the write is ignored.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Index The 8-bit Performance Monitor Data Register index to write.
@param Value The 64-bit value to write to PMD.
@ -4508,7 +4508,7 @@ AsmWritePmd (
Reads the current value of 64-bit Global Pointer (GP).
Reads and returns the current value of GP.
This function is only available on IPF.
This function is only available on Itanium processors.
@return The current value of GP.
@ -4525,7 +4525,7 @@ AsmReadGp (
Writes the current value of GP. The 64-bit value written to the GP is returned.
No parameter checking is performed on Value.
This function is only available on IPF.
This function is only available on Itanium processors.
@param Value The 64-bit value to write to GP.
@ -4543,7 +4543,7 @@ AsmWriteGp (
Reads the current value of 64-bit Stack Pointer (SP).
Reads and returns the current value of SP.
This function is only available on IPF.
This function is only available on Itanium processors.
@return The current value of SP.
@ -4590,7 +4590,7 @@ AsmReadSp (
Reads and returns the control register specified by Index. The valid Index valued are defined
above in "Related Definitions".
If Index is invalid then 0xFFFFFFFFFFFFFFFF is returned. This function is only available on IPF.
If Index is invalid then 0xFFFFFFFFFFFFFFFF is returned. This function is only available on Itanium processors.
@param Index The index of the control register to read.
@ -4640,7 +4640,7 @@ AsmReadControlRegister (
Reads and returns the application register specified by Index. The valid Index valued are defined
above in "Related Definitions".
If Index is invalid then 0xFFFFFFFFFFFFFFFF is returned. This function is only available on IPF.
If Index is invalid then 0xFFFFFFFFFFFFFFFF is returned. This function is only available on Itanium processors.
@param Index The index of the application register to read.
@ -4661,7 +4661,7 @@ AsmReadApplicationRegister (
parameter checking is performed on Index, and if the Index value is beyond the implemented MSR
register range, a Reserved Register/Field fault may occur. The caller must either guarantee that
Index is valid, or the caller must set up fault handlers to catch the faults. This function is
only available on IPF.
only available on Itanium processors.
@param Index The 8-bit Machine Specific Register index to read.
@ -4682,7 +4682,7 @@ AsmReadMsr (
parameter checking is performed on Index, and if the Index value is beyond the implemented MSR
register range, a Reserved Register/Field fault may occur. The caller must either guarantee that
Index is valid, or the caller must set up fault handlers to catch the faults. This function is
only available on IPF.
only available on Itanium processors.
@param Index The 8-bit Machine Specific Register index to write.
@param Value The 64-bit value to write to the Machine Specific Register.
@ -4706,7 +4706,7 @@ AsmWriteMsr (
If the CPU is in physical mode(PSR.RT=0, PSR.DT=0, PSR.IT=0), then 0 is returned.
If the CPU is not in physical mode or virtual mode, then it is in mixed mode,
and -1 is returned.
This function is only available on IPF.
This function is only available on Itanium processors.
@retval 1 The CPU is in virtual mode.
@retval 0 The CPU is in physical mode.
@ -4740,7 +4740,7 @@ AsmCpuVirtual (
argument return value may be returned or undefined result may occur during the
execution of the procedure. If the PalEntryPoint does not point to a valid
PAL entry point then the system behavior is undefined. This function is only
available on IPF.
available on Itanium processors.
@param PalEntryPoint The PAL procedure calls entry point.
@param Index The PAL procedure Index number.
@ -4894,7 +4894,7 @@ typedef struct {
#if defined (MDE_CPU_IA32)
///
/// Byte packed structure for an IA32 Interrupt Gate Descriptor
/// Byte packed structure for an IA-32 Interrupt Gate Descriptor
///
typedef union {
struct {

6
MdePkg/Include/Library/CacheMaintenanceLib.h
View File

@ -39,7 +39,7 @@ InvalidateInstructionCache (
aligned on a cache line boundary, then the entire instruction cache line
containing Address + Length -1 is invalidated. This function may choose to
invalidate the entire instruction cache if that is more efficient than
invalidating the specified range. If Length is 0, the no instruction cache
invalidating the specified range. If Length is 0, then no instruction cache
lines are invalidated. Address is returned.
If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
@ -88,7 +88,7 @@ WriteBackInvalidateDataCache (
line containing Address + Length -1 is written back and invalidated. This
function may choose to write back and invalidate the entire data cache if
that is more efficient than writing back and invalidating the specified
range. If Length is 0, the no data cache lines are written back and
range. If Length is 0, then no data cache lines are written back and
invalidated. Address is returned.
If Length is greater than (MAX_ADDRESS - Address + 1), then ASSERT().
@ -136,7 +136,7 @@ WriteBackDataCache (
cache line boundary, then the entire data cache line containing Address +
Length -1 is written back. This function may choose to write back the entire
data cache if that is more efficient than writing back the specified range.
If Length is 0, the no data cache lines are written back. This function may
If Length is 0, then no data cache lines are written back. This function may
also invalidate all the data cache lines in the specified range of the cache
coherency domain of the calling CPU. Address is returned.

2
MdePkg/Include/Library/CpuLib.h
View File

@ -3,7 +3,7 @@
in the Base Library due to dependencies on the PAL Library
The CPU Library provides services to flush CPU TLBs and place the CPU in a sleep state.
The implementation of these services on Itanium CPUs requires the use of PAL Calls.
The implementation of these services on Itanium processors requires the use of PAL Calls.
PAL Calls require PEI and DXE specific mechanisms to look up PAL Entry Point.
As a result, these services could not be defined in the Base Library.

8
MdePkg/Include/Library/DebugLib.h
View File

@ -216,10 +216,10 @@ DebugClearMemoryEnabled (
/**
Internal worker macro that calls DebugAssert().
This macro calls DebugAssert() passing in the filename, line number, and
expression that evailated to FALSE.
This macro calls DebugAssert(), passing in the filename, line number, and an
expression that evaluated to FALSE.
@param Expression Boolean expression that evailated to FALSE
@param Expression Boolean expression that evaluated to FALSE
**/
#define _ASSERT(Expression) DebugAssert (__FILE__, __LINE__, #Expression)
@ -239,7 +239,7 @@ DebugClearMemoryEnabled (
/**
Macro that calls DebugAssert() if a expression evaluates to FALSE.
Macro that calls DebugAssert() if an expression evaluates to FALSE.
If the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit of PcdDebugProperyMask is set,
then this macro evaluates the Boolean expression specified by Expression. If

19
MdePkg/Include/Library/DxeServicesLib.h
View File

@ -13,14 +13,17 @@
**/
#ifndef __DXE_SERVICES_LIB_H__
#define __DXE_SERVICES_LIB_H__
#ifndef __PI_LIB_H__
#define __PI_LIB_H__
#include <Pi/PiFirmwareFile.h>
/**
Searches all the availables firmware volumes and returns the first matching FFS section.
Searches all the available firmware volumes and returns the first matching FFS section.
This function searches all the firmware volumes for FFS files with an FFS filename specified by NameGuid.
The order that the firmware volumes is searched is not deterministic. For each FFS file found a search
The order in which the firmware volumes are searched is not deterministic. For each FFS file found, a search
is made for FFS sections of type SectionType. If the FFS file contains at least SectionInstance instances
of the FFS section specified by SectionType, then the SectionInstance instance is returned in Buffer.
Buffer is allocated using AllocatePool(), and the size of the allocated buffer is returned in Size.
@ -42,7 +45,7 @@
@param SectionType Indicates the FFS section type to search for within the FFS file specified by NameGuid.
@param SectionInstance Indicates which section instance within the FFS file specified by NameGuid to retrieve.
@param Buffer On output, a pointer to a callee allocated buffer containing the FFS file section that was found.
Is it the caller's responsibility to free this buffer using FreePool().
It is the caller's responsibility to free this buffer using FreePool().
@param Size On output, a pointer to the size, in bytes, of Buffer.
@retval EFI_SUCCESS The specified FFS section was returned.
@ -66,7 +69,7 @@ GetSectionFromAnyFv (
Searches the firmware volume that the currently executing module was loaded from and returns the first matching FFS section.
This function searches the firmware volume that the currently executing module was loaded
from for an FFS file with an FFS filename specified by NameGuid. If the FFS file is found a search
from for an FFS file with an FFS filename specified by NameGuid. If the FFS file is found, a search
is made for FFS sections of type SectionType. If the FFS file contains at least SectionInstance
instances of the FFS section specified by SectionType, then the SectionInstance instance is returned in Buffer.
Buffer is allocated using AllocatePool(), and the size of the allocated buffer is returned in Size.
@ -88,7 +91,7 @@ GetSectionFromAnyFv (
@param SectionType Indicates the FFS section type to search for within the FFS file specified by NameGuid.
@param SectionInstance Indicates which section instance within the FFS file specified by NameGuid to retrieve.
@param Buffer On output, a pointer to a callee allocated buffer containing the FFS file section that was found.
Is it the caller's responsibility to free this buffer using FreePool().
It is the caller's responsibility to free this buffer using FreePool().
@param Size On output, a pointer to the size, in bytes, of Buffer.
@ -134,7 +137,7 @@ GetSectionFromFv (
@param SectionInstance Indicates which section instance to retrieve within the FFS file
that the currently executing module was loaded from.
@param Buffer On output, a pointer to a callee allocated buffer containing the FFS file section that was found.
Is it the caller's responsibility to free this buffer using FreePool().
It is the caller's responsibility to free this buffer using FreePool().
@param Size On output, a pointer to the size, in bytes, of Buffer.
@retval EFI_SUCCESS The specified FFS section was returned.

8
MdePkg/Include/Library/PalLib.h
View File

@ -2,12 +2,12 @@
Provides library services to make PAL Calls.
The PAL Library provides a service to make a PAL CALL. This service is identical
in functionality to AsmPalCall() in the Itanium specific functions of the Base Library.
The only difference is that the PAL Entry Point is not passed in. Implementations
in functionality to AsmPalCall() in the functions of the Base Library specific to Intel Itanium architecture.
The only difference is that the PAL Entry Point is not passed in. Implementations
of this library class must manage PAL Entry Point on their own. For example, a PEI
implementation can use a PPI to lookup the PAL Entry Point, and a DXE implementation
can contain a constructor to look up the PAL Entry Point from a HOB. This library class
is only available on IPF.
is only available on Intel Itanium-based platforms.
Copyright (c) 2006 - 2008, Intel Corporation<BR>
All rights reserved. This program and the accompanying materials
@ -40,7 +40,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
may cause undefined results. For those parameters defined as reserved or some fields
defined as reserved must be zero filled or the invalid argument return value may be
returned or undefined result may occur during the execution of the procedure.
This function is only available on IPF.
This function is only available on Intel Itanium-based platforms.
@param Index The PAL procedure Index number.
@param Arg2 The 2nd parameter for PAL procedure calls.

44
MdePkg/Include/Library/PcdLib.h
View File

@ -1,12 +1,12 @@
/** @file
Provides library services to get and set Platform Configuration Database entries.
PCD Library Class provides PCD usage macro interface for all PCD types.
It should be included at any module who use PCD. If module use dynamic/dynamicex
PCD, module should be linked to PEIM/DXE library instance to access that PCD.
If module uses PatchableInModule type PCD, also need library instance produce
LibPatchPcdSetPtr() interface. For FeatureFlag/Fixed PCD, macro interface is
translated to an variable or macro which is auto-generated by build tool in
PCD Library Class provides a PCD usage macro interface for all PCD types.
It should be included in any module that uses PCD. If a module uses dynamic/dynamicex
PCD, module should be linked to a PEIM/DXE library instance to access that PCD.
If a module uses PatchableInModule type PCD, it also needs the library instance to produce
LibPatchPcdSetPtr() interface. For FeatureFlag/Fixed PCD, the macro interface is
translated to n variable or macro that is auto-generated by build tool in
module's autogen.h/autogen.c.
The PcdGetXX(), PcdSetXX(), PcdToken(), and PcdGetNextTokenSpace() operations are
only available prior to ExitBootServices(). If access to PCD values are required
@ -785,7 +785,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
@param SkuId The SKU value that will be used when the PCD service retrieves and sets values
associated with a PCD token.
@return Return the SKU ID that just be set.
@return Return the SKU ID that was set.
**/
UINTN
@ -1072,7 +1072,7 @@ LibPcdGetExSize (
@param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 8-bit value to set.
@return Return the value been set.
@return Return the value that was set.
**/
UINT8
@ -1092,7 +1092,7 @@ LibPcdSet8 (
@param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 16-bit value to set.
@return Return the value been set.
@return Return the value that was set.
**/
UINT16
@ -1112,7 +1112,7 @@ LibPcdSet16 (
@param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 32-bit value to set.
@return Return the value been set.
@return Return the value that was set.
**/
UINT32
@ -1132,7 +1132,7 @@ LibPcdSet32 (
@param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 64-bit value to set.
@return Return the value been set.
@return Return the value that was set.
**/
UINT64
@ -1162,7 +1162,7 @@ LibPcdSet64 (
@param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to set.
@return Return the pointer for the buffer been set.
@return Return the pointer for the buffer that was set.
**/
VOID *
@ -1183,7 +1183,7 @@ LibPcdSetPtr (
@param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The boolean value to set.
@return Return the value been set.
@return Return the value that was set.
**/
BOOLEAN
@ -1207,7 +1207,7 @@ LibPcdSetBool (
@param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 8-bit value to set.
@return Return the value been set.
@return Return the value that was set.
**/
UINT8
@ -1232,7 +1232,7 @@ LibPcdSetEx8 (
@param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 16-bit value to set.
@return Return the value been set.
@return Return the value that was set.
**/
UINT16
@ -1257,7 +1257,7 @@ LibPcdSetEx16 (
@param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 32-bit value to set.
@return Return the value been set.
@return Return the value that was set.
**/
UINT32
@ -1281,7 +1281,7 @@ LibPcdSetEx32 (
@param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The 64-bit value to set.
@return Return the value been set.
@return Return the value that was set.
**/
UINT64
@ -1312,7 +1312,7 @@ LibPcdSetEx64 (
@param[in, out] SizeOfBuffer The size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to set.
@return Return the pinter to the buffer been set.
@return Return the pointer to the buffer that was set.
**/
VOID *
@ -1338,7 +1338,7 @@ LibPcdSetExPtr (
@param[in] TokenNumber The PCD token number to set a current value for.
@param[in] Value The Boolean value to set.
@return Return the value been set.
@return Return the value that was set.
**/
BOOLEAN
@ -1353,9 +1353,9 @@ LibPcdSetExBool (
/**
This notification function serves two purposes.
Firstly, it notifies the module which did the registration that the value of this
Firstly, it notifies the module that did the registration that the value of this
PCD token has been set.
Secondly, it provides a mechanism for the module which did the registration to intercept
Secondly, it provides a mechanism for the module that did the registration to intercept
the set operation and override the value been set if necessary. After the invocation of
the callback function, TokenData will be used by PCD service PEIM or driver to modify th
internal data in PCD database.
@ -1491,7 +1491,7 @@ LibPcdGetNextTokenSpace (
@param[in, out] SizeOfBuffer A pointer to the size, in bytes, of Buffer.
@param[in] Buffer A pointer to the buffer to used to set the target variable.
@return Return the pointer to the buffer been set.
@return Return the pointer to the buffer that was set.
**/
VOID *

2
MdePkg/Include/Library/PciCf8Lib.h
View File

@ -2,7 +2,7 @@
Provides services to access PCI Configuration Space using the I/O ports 0xCF8 and 0xCFC.
This library is identical to the PCI Library, except the access method for performing PCI
configuration cycles must be though I/O ports 0xCF8 and 0xCFC. This library only allows
configuration cycles must be through I/O ports 0xCF8 and 0xCFC. This library only allows
access to PCI Segment #0.
Copyright (c) 2006 - 2009, Intel Corporation<BR>

2
MdePkg/Include/Library/PciExpressLib.h
View File

@ -2,7 +2,7 @@
Provides services to access PCI Configuration Space using the MMIO PCI Express window.
This library is identical to the PCI Library, except the access method for performing PCI
configuration cycles must be though the 256 MB PCI Express MMIO window whose base address
configuration cycles must be through the 256 MB PCI Express MMIO window whose base address
is defined by PcdPciExpressBaseAddress.
Copyright (c) 2006 - 2008, Intel Corporation<BR>

2
MdePkg/Include/Library/PciLib.h
View File

@ -167,7 +167,7 @@ PciAnd8 (
/**
Performs a bitwise AND of an 8-bit PCI configuration register with an 8-bit
value, followed a bitwise OR with another 8-bit value.
value, followed by a bitwise OR with another 8-bit value.
Reads the 8-bit PCI configuration register specified by Address, performs a
bitwise AND between the read result and the value specified by AndData,

10
MdePkg/Include/Library/PeCoffLib.h
View File

@ -2,7 +2,7 @@
Provides services to load and relocate a PE/COFF image.
The PE/COFF Loader Library abstracts the implementation of a PE/COFF loader for
IA-32, x86, IPF, and EBC processor types. The library functions are memory based
IA-32, x86, IPF, and EBC processor types. The library functions are memory-based
and can be ported easily to any environment.
Copyright (c) 2006 - 2008, Intel Corporation
@ -230,7 +230,7 @@ PeCoffLoaderGetImageInfo (
of ImageContext as the relocation base address. The caller must allocate the relocation
fixup log buffer and fill in the FixupData field of ImageContext prior to calling this function.
The ImageRead, Handle, PeCoffHeaderOffset, IsTeImage, Machine, ImageType, ImageAddress,
The ImageRead, Handle, PeCoffHeaderOffset, IsTeImage, Machine, ImageType, ImageAddress,
ImageSize, DestinationAddress, RelocationsStripped, SectionAlignment, SizeOfHeaders,
DebugDirectoryEntryRva, EntryPoint, FixupDataSize, CodeView, PdbPointer, and FixupData of
the ImageContext structure must be valid prior to invoking this service.
@ -265,7 +265,7 @@ PeCoffLoaderRelocateImage (
specified by the ImageAddress and ImageSize fields of ImageContext. The caller must allocate
the load buffer and fill in the ImageAddress and ImageSize fields prior to calling this function.
The EntryPoint, FixupDataSize, CodeView, PdbPointer and HiiResourceData fields of ImageContext are computed.
The ImageRead, Handle, PeCoffHeaderOffset, IsTeImage, Machine, ImageType, ImageAddress, ImageSize,
The ImageRead, Handle, PeCoffHeaderOffset, IsTeImage, Machine, ImageType, ImageAddress, ImageSize,
DestinationAddress, RelocationsStripped, SectionAlignment, SizeOfHeaders, and DebugDirectoryEntryRva
fields of the ImageContext structure must be valid prior to invoking this service.
@ -302,7 +302,7 @@ PeCoffLoaderLoadImage (
This is the default implementation of a PE_COFF_LOADER_READ_FILE function
that assumes FileHandle pointer to the beginning of a PE/COFF image.
This function reads contents of the PE/COFF image that starts at the system memory
address specified by FileHandle. The read operation copies ReadSize bytes from the
address specified by FileHandle. The read operation copies ReadSize bytes from the
PE/COFF image starting at byte offset FileOffset into the buffer specified by Buffer.
The size of the buffer actually read is returned in ReadSize.
@ -335,7 +335,7 @@ PeCoffLoaderImageReadFromMemory (
This function reapplies relocation fixups to the PE/COFF image specified by ImageBase
and ImageSize so the image will execute correctly when the PE/COFF image is mapped
to the address specified by VirtualImageBase. RelocationData must be identical
to the address specified by VirtualImageBase. RelocationData must be identical
to the FiuxupData buffer from the PE_COFF_LOADER_IMAGE_CONTEXT structure
after this PE/COFF image was relocated with PeCoffLoaderRelocateImage().

4
MdePkg/Include/Library/PeiCoreEntryPoint.h
View File

@ -86,8 +86,8 @@ EfiMain (
module depends on. This include library instances that a module depends on directly and library
instances that a module depends on indirectly through other libraries.
This function is autogenerated by build tools and those build tools are responsible for collecting
the set of library instances, determine which ones have constructors, and calling the library
constructors in the proper order based upon each of the library instances own dependencies.
the set of library instances, determining which ones have constructors, and calling the library
constructors in the proper order based upon the dependencies of each of the library instances.
The PEI Core must call this function with a NULL FileHandle value as soon as the initial PEI
Services Table has been established.

10
MdePkg/Include/Library/PostCodeLib.h
View File

@ -19,7 +19,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
#define POST_CODE_PROPERTY_POST_CODE_DESCRIPTION_ENABLED 0x00000010
/**
Sends an 32-bit value to a POST card.
Sends a 32-bit value to a POST card.
Sends the 32-bit value specified by Value to a POST card, and returns Value.
Some implementations of this library function may perform I/O operations
@ -28,7 +28,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
display the 32-bit value on the status reporting device.
PostCode() must actively prevent recursion. If PostCode() is called while
processing another any other Post Code Library function, then
processing another Post Code Library function, then
PostCode() must return Value immediately.
@param Value The 32-bit value to write to the POST card.
@ -44,7 +44,7 @@ PostCode (
/**
Sends an 32-bit value to a POST and associated ASCII string.
Sends a 32-bit value to a POST and associated ASCII string.
Sends the 32-bit value specified by Value to a POST card, and returns Value.
If Description is not NULL, then the ASCII string specified by Description is
@ -114,7 +114,7 @@ PostCodeDescriptionEnabled (
/**
Sends an 32-bit value to a POST card.
Sends a 32-bit value to a POST card.
If POST codes are enabled in PcdPostCodeProperyMask, then call PostCode()
passing in Value. Value is returned.
@ -127,7 +127,7 @@ PostCodeDescriptionEnabled (
#define POST_CODE(Value) PostCodeEnabled() ? PostCode(Value) : Value
/**
Sends an 32-bit value to a POST and associated ASCII string.
Sends a 32-bit value to a POST and associated ASCII string.
If POST codes and POST code descriptions are enabled in
PcdPostCodeProperyMask, then call PostCodeWithDescription() passing in

2
MdePkg/Include/Library/SalLib.h
View File

@ -29,7 +29,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
defined as reserved or some fields defined as reserved must be
zero filled or the invalid argument return value may be returned
or undefined result may occur during the execution of the procedure.
This function is only available on IPF.
This function is only available on Intel Itanium-based platforms.
@param Index The SAL procedure Index number
@param Arg2 The 2nd parameter for SAL procedure calls

2
MdePkg/Include/Library/SerialPortLib.h
View File

@ -69,7 +69,7 @@ SerialPortWrite (
@param Buffer Pointer to the data buffer to store the data read from the serial device.
@param NumberOfBytes Number of bytes which will be read.
@retval 0 Read data failed, No data is to be read.
@retval 0 Read data failed, no data is to be read.
@retval >0 Actual number of bytes read from serial device.
**/

8
MdePkg/Include/Library/SynchronizationLib.h
View File

@ -22,7 +22,7 @@ typedef volatile UINTN SPIN_LOCK;
/**
Retrieves the architecture specific spin lock alignment requirements for
Retrieves the architecture-specific spin lock alignment requirements for
optimal spin lock performance.
This function retrieves the spin lock alignment requirements for optimal
@ -34,7 +34,7 @@ typedef volatile UINTN SPIN_LOCK;
consumers of the spin lock synchronization functions to obtain optimal spin
lock performance.
@return The architecture specific spin lock alignment.
@return The architecture-specific spin lock alignment.
**/
UINTN
@ -140,7 +140,7 @@ ReleaseSpinLock (
/**
Performs an atomic increment of an 32-bit unsigned integer.
Performs an atomic increment of a 32-bit unsigned integer.
Performs an atomic increment of the 32-bit unsigned integer specified by
Value and returns the incremented value. The increment operation must be
@ -162,7 +162,7 @@ InterlockedIncrement (
/**
Performs an atomic decrement of an 32-bit unsigned integer.
Performs an atomic decrement of a 32-bit unsigned integer.
Performs an atomic decrement of the 32-bit unsigned integer specified by
Value and returns the decremented value. The decrement operation must be

2
MdePkg/Include/Library/UefiDecompressLib.h
View File

@ -45,7 +45,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
@param SourceSize The size, in bytes, of the source buffer.
@param DestinationSize A pointer to the size, in bytes, of the uncompressed buffer
that will be generated when the compressed buffer specified
by Source and SourceSize is decompressed..
by Source and SourceSize is decompressed.
@param ScratchSize A pointer to the size, in bytes, of the scratch buffer that
is required to decompress the compressed buffer specified
by Source and SourceSize.

28
MdePkg/Include/Library/UefiLib.h
View File

@ -113,8 +113,8 @@ typedef struct {
based on a specified GUID.
This function searches the list of configuration tables stored in the EFI System Table
for a table with a GUID that matches TableGuid. If a match is found, then a pointer to
the configuration table is returned in Table., and EFI_SUCCESS is returned. If a matching GUID
for a table with a GUID that matches TableGuid. If a match is found, then a pointer to
the configuration table is returned in Table, and EFI_SUCCESS is returned. If a matching GUID
is not found, then EFI_NOT_FOUND is returned.
If TableGuid is NULL, then ASSERT().
If Table is NULL, then ASSERT().
@ -948,7 +948,7 @@ EfiInitializeFwVolDevicepathNode (
This library function abstracts validating a device path node.
Check the MEDIA_FW_VOL_FILEPATH_DEVICE_PATH data structure to see if it's valid.
If it is valid, then return the GUID file name from the device path node. Otherwise,
return NULL. This device path changed in the DXE CIS version 0.92 in a non back ward
return NULL. This device path changed in the DXE CIS version 0.92 in a non backward
compatible way to not conflict with the UEFI 2.0 specification. This function abstracts
the differences from the caller.
If FvDevicePathNode is NULL, then ASSERT().
@ -1077,12 +1077,10 @@ AsciiErrorPrint (
Unicode characters displayed, not including partial characters that may be clipped
by the right edge of the display. If the length of the formatted Unicode string is
greater than PcdUefiLibMaxPrintBufferSize, then at most the first
PcdUefiLibMaxPrintBufferSize characters are printed.The EFI_HII_FONT_PROTOCOL
StringToImage() service is used to convert the string to a bitmap using the glyphs
registered with the HII database. No wrapping is performed, so any portions of the
string the fall outside the active display region will not be displayed. Please see
Section 27.2.6 of the UEFI Specification for a description of the supported string
format including the set of control codes supported by the StringToImage() service.
PcdUefiLibMaxPrintBufferSize characters are printed. The EFI_HII_FONT_PROTOCOL
is used to convert the string to a bitmap using the glyphs registered with the
HII database. No wrapping is performed, so any portions of the string the fall
outside the active display region will not be displayed.
If a graphics console device is not associated with the ConsoleOutputHandle
defined in the EFI_SYSTEM_TABLE then no string is printed, and 0 is returned.
@ -1129,12 +1127,10 @@ PrintXY (
ASCII characters displayed, not including partial characters that may be clipped
by the right edge of the display. If the length of the formatted ASCII string is
greater than PcdUefiLibMaxPrintBufferSize, then at most the first
PcdUefiLibMaxPrintBufferSize characters are printed.The EFI_HII_FONT_PROTOCOL
StringToImage() service is used to convert the string to a bitmap using the glyphs
registered with the HII database. No wrapping is performed, so any portions of the
string the fall outside the active display region will not be displayed. Please see
Section 27.2.6 of the UEFI Specification for a description of the supported string
format including the set of control codes supported by the StringToImage() service.
PcdUefiLibMaxPrintBufferSize characters are printed. The EFI_HII_FONT_PROTOCOL
is used to convert the string to a bitmap using the glyphs registered with the
HII database. No wrapping is performed, so any portions of the string the fall
outside the active display region will not be displayed.
If a graphics console device is not associated with the ConsoleOutputHandle
defined in the EFI_SYSTEM_TABLE then no string is printed, and 0 is returned.
@ -1210,7 +1206,7 @@ EfiLibInstallDriverBinding (
Initializes a driver by installing the Driver Binding Protocol together with the
optional Component Name, optional Driver Configure and optional Driver Diagnostic
Protocols onto the driver's DriverBindingHandle. If DriverBindingHandle is NULL,
then the protocols are installed onto a newly created handle. DriverBindingHandle
then the protocols are installed onto a newly created handle. DriverBindingHandle
is typically the same as the driver's ImageHandle, but it can be different if the
driver produces multiple Driver Binding Protocols.
If DriverBinding is NULL, then ASSERT().

10
MdePkg/Include/Library/UefiRuntimeLib.h
View File

@ -60,7 +60,7 @@ EfiGoneVirtual (
information returned by GetTime() are the values that were last set via SetTime().
The GetTime() function should take approximately the same amount of time to read the time each
time it is called. All reported device capabilities are to be rounded up.
During runtime, if a PC-AT CMOS device is present in the platform the caller must synchronize
During runtime, if a PC-AT CMOS device is present in the platform, the caller must synchronize
access to the device before calling GetTime().
@param Time A pointer to storage to receive a snapshot of the current time.
@ -87,7 +87,7 @@ EfiGetTime (
to loop based on the current time. For example, if the device does not support a hardware reset
for the sub-resolution time, the code is not to implement the feature by waiting for the time to
wrap.
During runtime, if a PC-AT CMOS device is present in the platform the caller must synchronize
During runtime, if a PC-AT CMOS device is present in the platform, the caller must synchronize
access to the device before calling SetTime().
@param Time A pointer to the current time. Type EFI_TIME is defined in the GetTime()
@ -169,7 +169,7 @@ EfiSetWakeupTime (
This service is a wrapper for the UEFI Runtime Service GetVariable().
Each vendor may create and manage its own variables without the risk of name conflicts by
using a unique VendorGuid. When a variable is set its Attributes are supplied to indicate
using a unique VendorGuid. When a variable is set, its Attributes are supplied to indicate
how the data variable should be stored and maintained by the system. The attributes affect
when the variable may be accessed and volatility of the data. Any attempts to access a variable
that does not have the attribute set for runtime access will yield the EFI_NOT_FOUND error.
@ -249,7 +249,7 @@ EfiGetNextVariableName (
Variables are stored by the firmware and may maintain their values across power cycles. Each vendor
may create and manage its own variables without the risk of name conflicts by using a unique VendorGuid.
@param VariableName the name of the vendor's variable, it's a
@param VariableName the name of the vendor's variable, as a
Null-Terminated Unicode String
@param VendorGuid Unify identifier for vendor.
@param Attributes Point to memory location to return the attributes of variable. If the point
@ -443,7 +443,7 @@ EfiSetVirtualAddressMap (
@param ListHead Head of linked list to convert.
@retval EFI_SUCCESS Success to execute the function.
@retval !EFI_SUCCESS Failed to e3xecute the function.
@retval !EFI_SUCCESS Failed to execute the function.
**/
EFI_STATUS

2
MdePkg/Include/Library/UefiScsiLib.h
View File

@ -1,5 +1,5 @@
/** @file
Provides the functions to submit Scsi commands defined in SCSI-2 specification for scsi device.
Provides the functions to submit Scsi commands defined in SCSI-2 specification for SCSI devices.
This library class provides the functions to submit SCSI commands defined in SCSI-2 specification
for hard drive, CD and DVD devices that are the most common SCSI boot targets used by UEFI platforms.

17
MdePkg/Include/Library/UefiUsbLib.h
View File

@ -1,6 +1,6 @@
/** @file
Provides most usb APIs to support the Hid requests defined in Usb Hid 1.1 spec
and the standard requests defined in Usb 1.1 spec.
Provides most USB APIs to support the Hid requests defined in USB Hid 1.1 spec
and the standard requests defined in USB 1.1 spec.
Copyright (c) 2006 - 2008, Intel Corporation<BR>
All rights reserved. This program and the accompanying materials
@ -18,12 +18,13 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
#define __USB_DXE_LIB_H__
#include <Protocol/UsbIo.h>
#include <IndustryStandard/Usb.h>
/**
Get the descriptor of the specified USB HID interface.
Submit a USB get HID descriptor request for the USB device specified by UsbIo
and Interface and return the HID descriptor in HidDescriptor.
Submit a UsbGetHidDescriptor() request for the USB device specified by UsbIo
and Interface, and return the HID descriptor in HidDescriptor.
If UsbIo is NULL, then ASSERT().
If HidDescriptor is NULL, then ASSERT().
@ -51,7 +52,7 @@ UsbGetHidDescriptor (
Get the report descriptor of the specified USB HID interface.
Submit a USB get HID report descriptor request for the USB device specified by
UsbIo and Interface and return the report descriptor in DescriptorBuffer.
UsbIo and Interface, and return the report descriptor in DescriptorBuffer.
If UsbIo is NULL, then ASSERT().
If DescriptorBuffer is NULL, then ASSERT().
@ -81,7 +82,7 @@ UsbGetReportDescriptor (
Get the HID protocol of the specified USB HID interface.
Submit a USB get HID protocol request for the USB device specified by UsbIo
and Interface and return the protocol retrieved in Protocol.
and Interface, and return the protocol retrieved in Protocol.
If UsbIo is NULL, then ASSERT().
If Protocol is NULL, then ASSERT().
@ -106,7 +107,7 @@ UsbGetProtocolRequest (
Set the HID protocol of the specified USB HID interface.
Submit a USB set HID protocol request for the USB device specified by UsbIo
and Interface and set the protocol to the value specified by Protocol.
and Interface, and set the protocol to the value specified by Protocol.
If UsbIo is NULL, then ASSERT().
@param UsbIo A pointer to the USB I/O Protocol instance for the specific USB target.
@ -501,7 +502,7 @@ UsbClearFeature (
Get the status of the specified device.
Submit a USB device get status request for the USB device specified by UsbIo,
Recipient, and Target and place the result in the buffer specified by DeviceStatus.
Recipient, and Target, and place the result in the buffer specified by DeviceStatus.
The status of the transfer is returned in Status.
If UsbIo is NULL, then ASSERT().
If DeviceStatus is NULL, then ASSERT().

6
MdePkg/Include/Ppi/Pcd.h
View File

@ -74,7 +74,7 @@ UINT8
/**
Retrieves a 16-bit value for a given PCD token.
Retrieves the current 16-bits value for a PCD token number.
Retrieves the current 16-bit value for a PCD token number.
If the TokenNumber is invalid, the results are unpredictable.
@param[in] TokenNumber The PCD token number.
@ -93,7 +93,7 @@ UINT16
/**
Retrieves a 32-bit value for a given PCD token.
Retrieves the current 32-bits value for a PCD token number.
Retrieves the current 32-bit value for a PCD token number.
If the TokenNumber is invalid, the results are unpredictable.
@param[in] TokenNumber The PCD token number.
@ -112,7 +112,7 @@ UINT32
/**
Retrieves a 64-bit value for a given PCD token.
Retrieves the current 64-bits value for a PCD token number.
Retrieves the current 64-bit value for a PCD token number.
If the TokenNumber is invalid, the results are unpredictable.
@param[in] TokenNumber The PCD token number.

4
MdePkg/Include/Ppi/StatusCode.h
View File

@ -1,6 +1,6 @@
/** @file
This file declares Status Code PPI.
This ppi provides service that allows PEIMs to report status codes.
This ppi provides a service that allows PEIMs to report status codes.
Copyright (c) 2006 - 2009, Intel Corporation
All rights reserved. This program and the accompanying materials
@ -29,7 +29,7 @@
//
///
/// This PPI provides the sevice to report status code.
/// This PPI provides the service to report status code.
/// There can be only one instance of this service in the system.
///
typedef struct {

4
MdePkg/Include/Uefi/UefiInternalFormRepresentation.h
View File

@ -1497,7 +1497,7 @@ typedef struct {
///
/// This key is affected by the caps lock so that if a keyboard driver
/// would need to disambiguate between a key which had a "1" defined
/// versus a "a" character. Having this bit turned on would tell
/// versus an "a" character. Having this bit turned on would tell
/// the keyboard driver to use the appropriate shifted state or not.
///
#define EFI_AFFECTED_BY_CAPS_LOCK 0x0002
@ -1563,7 +1563,7 @@ typedef struct {
//
// Keys that have multiple control functions based on modifier
// settings are handled in the keyboard driver implementation.
// For instance PRINT_KEY might have a modifier held down and
// For instance, PRINT_KEY might have a modifier held down and
// is still a nonprinting character, but might have an alternate
// control function like SYSREQUEST
//

2
MdePkg/Include/Uefi/UefiSpec.h
View File

@ -964,7 +964,7 @@ typedef enum {
///
EfiResetWarm,
///
/// Used to induce en entry into power state equivalent to the ACPI G2/S5 or G3
/// Used to induce an entry into the power state equivalent to the ACPI G2/S5 or G3
/// state. If the system does not support this reset type, then when the system
/// is rebooted, it should exhibit the EfiResetCold attributes.
///

11
MdePkg/Include/X64/ProcessorBind.h
View File

@ -1,5 +1,5 @@
/** @file
Processor or Compiler specific defines and types x64 (Intel(r) EM64T, AMD64).
Processor or Compiler specific defines and types x64 (Intel 64, AMD64).
Copyright (c) 2006 - 2009, Intel Corporation<BR>
All rights reserved. This program and the accompanying materials
@ -397,19 +397,14 @@ typedef INT64 INTN;
#endif
//
// Macros for GNU assembly code
// For symbol name in GNU assembly code, an extra "_" is necessary
//
#if defined(__GNUC__)
#if defined(linux)
#define ASM_PFX(name) name
#else
#define ASM_PFX(name) _##name
#endif
///
/// For GNU assembly code, .global or .globl can declare global symbols.
/// Define this macro to unify the usage.
///
#define ASM_GLOBAL .globl
#endif
#endif
/**