Clean up .h files for the CPU I/O PPI and the CPU I/O 2 Protocol

Minor clean up to PeiIoLibCpuIo.inf




git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@9739 6f19259b-4bc3-4df7-8a09-765794883524

2 files changed, 89 insertions, 72 deletions

diff --git a/MdePkg/Include/Ppi/CpuIo.h b/MdePkg/Include/Ppi/CpuIo.h
index e67a5a8f6a..99821082e1 100644
--- a/MdePkg/Include/Ppi/CpuIo.h
+++ b/MdePkg/Include/Ppi/CpuIo.h
@@ -1,8 +1,8 @@
 /** @file

-  This PPI provides a set of memory- and I/O-based services. 

+  This PPI provides a set of memory and I/O-based services. 

   The perspective of the services is that of the processor, not the bus or system.

 

-  Copyright (c) 2006 - 2009, Intel Corporation                                                         

+  Copyright (c) 2006 - 2010, Intel Corporation                                                         

   All rights reserved. This program and the accompanying materials                          

   are licensed and made available under the terms and conditions of the BSD License         

   which accompanies this distribution.  The full text of the license may be found at        

@@ -48,13 +48,13 @@ typedef enum {
 /**

   Memory-based access services and I/O-based access services.

 

-  @param  PeiServices           An indirect pointer to the PEI Services Table

+  @param[in]  PeiServices  An indirect pointer to the PEI Services Table

                                 published by the PEI Foundation.

-  @param  This                  Pointer to local data for the interface.

-  @param  Width                 The width of the access. Enumerated in bytes.

-  @param  Address               The physical address of the access.

-  @param  Count                 The number of accesses to perform.

-  @param  Buffer                A pointer to the buffer of data.

+  @param[in]  This         Pointer to local data for the interface.

+  @param[in]  Width        The width of the access. Enumerated in bytes.

+  @param[in]  Address      The physical address of the access.

+  @param[in]  Count        The number of accesses to perform.

+  @param[out] Buffer       A pointer to the buffer of data.

 

   @retval EFI_SUCCESS           The function completed successfully.

   @retval EFI_NOT_YET_AVAILABLE The service has not been installed.

@@ -90,9 +90,10 @@ typedef struct {
 /**

   8-bit I/O read operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

 

   @return An 8-bit value returned from the I/O space.

 

@@ -108,9 +109,10 @@ UINT8
 /**

   16-bit I/O read operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

 

   @return A 16-bit value returned from the I/O space.

 

@@ -126,9 +128,10 @@ UINT16
 /**

   32-bit I/O read operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

 

   @return A 32-bit value returned from the I/O space.

 

@@ -144,9 +147,10 @@ UINT32
 /**

   64-bit I/O read operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

 

   @return A 64-bit value returned from the I/O space.

 

@@ -162,10 +166,11 @@ UINT64
 /**

   8-bit I/O write operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

-  @param  Data           The data to write.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

+  @param[in] Data         The data to write.

 

 **/

 typedef

@@ -180,10 +185,11 @@ VOID
 /**

   16-bit I/O write operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

-  @param  Data           The data to write.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

+  @param[in] Data         The data to write.

 

 **/

 typedef

@@ -198,10 +204,11 @@ VOID
 /**

   32-bit I/O write operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

-  @param  Data           The data to write.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

+  @param[in] Data         The data to write.

 

 **/

 typedef

@@ -216,10 +223,11 @@ VOID
 /**

   64-bit I/O write operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

-  @param  Data           The data to write.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

+  @param[in] Data         The data to write.

 

 **/

 typedef

@@ -234,9 +242,10 @@ VOID
 /**

   8-bit memory read operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

 

   @return An 8-bit value returned from the memory space.

 

@@ -252,9 +261,10 @@ UINT8
 /**

   16-bit memory read operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

 

   @return A 16-bit value returned from the memory space.

 

@@ -270,9 +280,10 @@ UINT16
 /**

   32-bit memory read operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

 

   @return A 32-bit value returned from the memory space.

 

@@ -288,9 +299,10 @@ UINT32
 /**

   64-bit memory read operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

 

   @return A 64-bit value returned from the memory space.

 

@@ -306,10 +318,11 @@ UINT64
 /**

   8-bit memory write operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

-  @param  Data           The data to write.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

+  @param[in] Data         The data to write.

 

 **/

 typedef

@@ -324,10 +337,11 @@ VOID
 /**

   16-bit memory write operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

-  @param  Data           The data to write.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

+  @param[in] Data         The data to write.

 

 **/

 typedef

@@ -342,10 +356,11 @@ VOID
 /**

   32-bit memory write operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

-  @param  Data           The data to write.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

+  @param[in] Data         The data to write.

 

 **/

 typedef

@@ -360,10 +375,11 @@ VOID
 /**

   64-bit memory write operations.

 

-  @param  PeiServices    An indirect pointer to the PEI Services Table published by the PEI Foundation.

-  @param  This           Pointer to local data for the interface.

-  @param  Address        The physical address of the access.

-  @param  Data           The data to write.

+  @param[in] PeiServices  An indirect pointer to the PEI Services Table published 

+                          by the PEI Foundation.

+  @param[in] This         Pointer to local data for the interface.

+  @param[in] Address      The physical address of the access.

+  @param[in] Data         The data to write.

 

 **/

 typedef

@@ -380,8 +396,14 @@ VOID
 /// The perspective of the services is that of the processor, not the bus or system.

 ///

 struct _EFI_PEI_CPU_IO_PPI {

-  EFI_PEI_CPU_IO_PPI_ACCESS       Mem;      ///< Collection of memory-access services.

-  EFI_PEI_CPU_IO_PPI_ACCESS       Io;       ///< Collection of I/O-access services.

+  ///

+  /// Collection of memory-access services.

+  ///

+  EFI_PEI_CPU_IO_PPI_ACCESS       Mem;

+  ///

+  /// Collection of I/O-access services.

+  ///

+  EFI_PEI_CPU_IO_PPI_ACCESS       Io;

 

   EFI_PEI_CPU_IO_PPI_IO_READ8     IoRead8;

   EFI_PEI_CPU_IO_PPI_IO_READ16    IoRead16;

diff --git a/MdePkg/Include/Protocol/CpuIo2.h b/MdePkg/Include/Protocol/CpuIo2.h
index 0156489eea..78b3eb6998 100644
--- a/MdePkg/Include/Protocol/CpuIo2.h
+++ b/MdePkg/Include/Protocol/CpuIo2.h
@@ -12,7 +12,7 @@
   ExitBootServices(). It is different from the Framework CPU I/O Protocol, which is a runtime

   protocol and can be used by runtime drivers after ExitBootServices().

 

-  Copyright (c) 2007 - 2009, Intel Corporation

+  Copyright (c) 2007 - 2010, Intel Corporation

   All rights reserved. This program and the accompanying materials

   are licensed and made available under the terms and conditions of the BSD License

   which accompanies this distribution.  The full text of the license may be found at

@@ -30,7 +30,6 @@
 #ifndef __CPU_IO2_H__

 #define __CPU_IO2_H__

 

-

 #define EFI_CPU_IO2_PROTOCOL_GUID \

   { \

     0xad61f191, 0xae5f, 0x4c0e, {0xb9, 0xfa, 0xe8, 0x69, 0xd2, 0x88, 0xc6, 0x4f} \

@@ -38,7 +37,6 @@
 

 typedef struct _EFI_CPU_IO2_PROTOCOL EFI_CPU_IO2_PROTOCOL;

 

-

 ///

 /// Enumeration that defines the width of the I/O operation.

 ///

@@ -58,7 +56,6 @@ typedef enum {
   EfiCpuIoWidthMaximum

 } EFI_CPU_IO_PROTOCOL_WIDTH;

 

-

 /**

   Enables a driver to access registers in the PI CPU I/O space. 

 

@@ -109,7 +106,6 @@ EFI_STATUS
   IN OUT VOID                              *Buffer

   );

 

-

 ///

 /// Service for read and write accesses.

 ///

@@ -124,7 +120,6 @@ typedef struct {
   EFI_CPU_IO_PROTOCOL_IO_MEM  Write;

 } EFI_CPU_IO_PROTOCOL_ACCESS;

 

-

 ///

 /// Provides the basic memory and I/O interfaces that are used to abstract

 /// accesses to devices in a system.