]> git.proxmox.com Git - mirror_edk2.git/commitdiff
Fix doxygen comment for structure and macro
authorklu2 <klu2@6f19259b-4bc3-4df7-8a09-765794883524>
Thu, 9 Oct 2008 17:40:26 +0000 (17:40 +0000)
committerklu2 <klu2@6f19259b-4bc3-4df7-8a09-765794883524>
Thu, 9 Oct 2008 17:40:26 +0000 (17:40 +0000)
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@6091 6f19259b-4bc3-4df7-8a09-765794883524

MdePkg/Include/Protocol/AcpiTable.h
MdePkg/Include/Protocol/Arp.h
MdePkg/Include/Protocol/AuthenticationInfo.h
MdePkg/Include/Protocol/Bds.h
MdePkg/Include/Protocol/Bis.h

index 9ccf2ecea0a207656b6d2dd1c48c6dfa6f48c0a3..40376a40142cc61abd05d48f5300d1c66bf58d1a 100644 (file)
@@ -108,13 +108,6 @@ EFI_STATUS
   @par Protocol Description:\r
   The EFI_ACPI_TABLE_PROTOCOL provides the ability for a component\r
   to install and uninstall ACPI tables from a platform.\r
-\r
-\r
-  @param InstallAcpiTable   Installs an ACPI table into the system.\r
-\r
-  @param UninstallAcpiTable Removes a previously installed ACPI\r
-                            table from the system.\r
-\r
 **/   \r
 struct _EFI_ACPI_TABLE_PROTOCOL {\r
   EFI_ACPI_TABLE_INSTALL_ACPI_TABLE   InstallAcpiTable;\r
index 21d815668907abe47ffe17c6a9f0be4bdd9acc27..efdd4c2f3402672319c39a3f8d1857df576455a2 100644 (file)
@@ -9,7 +9,6 @@
   The EFI ARP Protocol provides services to map IP network\r
   address to hardware address used by a data link protocol.\r
   \r
-  \r
   Copyright (c) 2006 - 2008, Intel Corporation                                                         \r
   All rights reserved. This program and the accompanying materials                          \r
   are licensed and made available under the terms and conditions of the BSD License         \r
 typedef struct _EFI_ARP_PROTOCOL EFI_ARP_PROTOCOL;\r
 \r
 typedef struct {\r
-UINT32                      Size;\r
-BOOLEAN                     DenyFlag;\r
-BOOLEAN                     StaticFlag;\r
-UINT16                      HwAddressType;\r
-UINT16                      SwAddressType;\r
-UINT8                       HwAddressLength;\r
-UINT8                       SwAddressLength;\r
+  UINT32                      Size;\r
+  BOOLEAN                     DenyFlag;\r
+  BOOLEAN                     StaticFlag;\r
+  UINT16                      HwAddressType;\r
+  UINT16                      SwAddressType;\r
+  UINT8                       HwAddressLength;\r
+  UINT8                       SwAddressLength;\r
 } EFI_ARP_FIND_DATA;\r
 \r
 typedef struct {\r
-  UINT16                    SwAddressType;      // Host byte order\r
+  UINT16                    SwAddressType;      ///< Host byte order\r
   UINT8                     SwAddressLength;\r
-  VOID                      *StationAddress;    // Network byte order\r
+  VOID                      *StationAddress;    ///< Network byte order\r
   UINT32                    EntryTimeOut;\r
   UINT32                    RetryCount;\r
   UINT32                    RetryTimeOut;\r
@@ -254,28 +253,6 @@ EFI_STATUS
   @par Protocol Description:\r
   ARP is used to resolve local network protocol addresses into \r
   network hardware addresses.\r
-\r
-  @param Configure\r
-  Adds a new station address (protocol type and network address) to the ARP cache.\r
-  \r
-  @param Add\r
-  Manually inserts an entry to the ARP cache for administrative purpose.\r
-\r
-  @param Find\r
-  Locates one or more entries in the ARP cache.\r
-\r
-  @param Delete\r
-  Removes an entry from the ARP cache.\r
-  \r
-  @param Flush\r
-  Removes all dynamic ARP cache entries of a specified protocol type.\r
-  \r
-  @param Request\r
-  Starts an ARP request session.\r
-  \r
-  @param Cancel\r
-  Abort previous ARP request session.\r
-\r
 **/\r
 struct _EFI_ARP_PROTOCOL {\r
   EFI_ARP_CONFIGURE         Configure;\r
index 592561394a380c6078de8f1646b8940dd4810ea6..3b3fd6b33a4b09a50cf70e97c6e5542a4f6bf95c 100644 (file)
@@ -41,9 +41,9 @@ typedef struct {
 \r
 typedef struct {\r
   AUTH_NODE_HEADER Header;\r
-  EFI_IPv6_ADDRESS RadiusIpAddr;             // IPv4 or IPv6 address\r
+  EFI_IPv6_ADDRESS RadiusIpAddr;             ///< IPv4 or IPv6 address\r
   UINT16           Reserved;\r
-  EFI_IPv6_ADDRESS NasIpAddr;                // IPv4 or IPv6 address\r
+  EFI_IPv6_ADDRESS NasIpAddr;                ///< IPv4 or IPv6 address\r
   UINT16           NasSecretLength; \r
   UINT8            *NasSecret;      \r
   UINT16           ChapSecretLength;\r
@@ -113,13 +113,6 @@ EFI_STATUS
   @par Protocol Description:\r
   This protocol is used on any device handle to obtain authentication \r
   information associated with the physical or logical device.\r
-\r
-  @param Get\r
-  Used to retrieve the Authentication Information associated with the controller handle\r
-  \r
-  @param Set\r
-  Used to set the Authentication information associated with the controller handle\r
-  \r
 **/  \r
 struct _EFI_AUTHENTICATION_INFO_PROTOCOL {\r
   EFI_AUTHENTICATION_PROTOCOL_INFO_GET Get;\r
index 843c5e9445be5d30cfb2f7b500420775754765be..0dca9322451bc91c23f32b5490c85f51cc32a68c 100644 (file)
@@ -66,12 +66,6 @@ VOID
   back to the dispatcher.  Once the required boot devices are available, then \r
   the boot device can be used to load and invoke an OS or a system utility.\r
 \r
-  @par Protocol Parameters:\r
-  Entry - The entry point to BDS.  This call does not take any parameters, \r
-  and the return value can be ignored.  If it returns, then the \r
-  dispatcher must be invoked again, if it never returns, then an \r
-  operating system or a system utility have been invoked.\r
-\r
 **/\r
 struct _EFI_BDS_ARCH_PROTOCOL {\r
   EFI_BDS_ENTRY Entry;\r
index eb4f7a60fcce1342ccd2f31fb35b1253c0676b54..f03452e57915fc200ebc3e8d15ce9105566d0210 100644 (file)
@@ -45,22 +45,20 @@ typedef VOID    *BIS_APPLICATION_HANDLE;
 typedef UINT16  BIS_ALG_ID;\r
 typedef UINT32  BIS_CERT_ID;\r
 \r
-///\r
-/// EFI_BIS_DATA type.\r
 ///\r
 /// EFI_BIS_DATA instances obtained from BIS must be freed by calling Free( ).\r
 ///\r
 typedef struct {\r
-  UINT32  Length; // Length of Data in 8 bit bytes.\r
-  UINT8   *Data;  // 32 Bit Flat Address of data.\r
+  UINT32  Length; ///< Length of Data in 8 bit bytes.\r
+  UINT8   *Data;  ///< 32 Bit Flat Address of data.\r
 } EFI_BIS_DATA;\r
 \r
 ///\r
 /// EFI_BIS_VERSION type.\r
 ///\r
 typedef struct {\r
-  UINT32  Major;  // BIS Interface version number.\r
-  UINT32  Minor;  // Build number.\r
+  UINT32  Major;  ///< BIS Interface version number.\r
+  UINT32  Minor;  ///< Build number.\r
 } EFI_BIS_VERSION;\r
 \r
 //\r
@@ -76,25 +74,25 @@ typedef struct {
 /// EFI_BIS_SIGNATURE_INFO type.\r
 ///\r
 typedef struct {\r
-  BIS_CERT_ID CertificateID;  // Truncated hash of platform Boot Object\r
-  ///  authorization certificate.\r
-  ///\r
-  BIS_ALG_ID  AlgorithmID;  // A signature algorithm number.\r
-  UINT16      KeyLength;    // Length of alg. keys in bits.\r
+  BIS_CERT_ID CertificateID;  ///< Truncated hash of platform Boot Object\r
+  BIS_ALG_ID  AlgorithmID;    ///< A signature algorithm number.\r
+  UINT16      KeyLength;      ///< Length of alg. keys in bits.\r
 } EFI_BIS_SIGNATURE_INFO;\r
 \r
 ///\r
-/// Currently defined values for EFI_BIS_SIGNATURE_INFO.AlgorithmID.\r
+/// values for EFI_BIS_SIGNATURE_INFO.AlgorithmID.\r
 /// The exact numeric values come from\r
 ///    "Common Data Security Architecture (CDSA) Specification".\r
 ///\r
 #define BIS_ALG_DSA     (41)  // CSSM_ALGID_DSA\r
 #define BIS_ALG_RSA_MD5 (42)  // CSSM_ALGID_MD5_WITH_RSA\r
-/// Currently defined values for EFI_BIS_SIGNATURE_INFO.CertificateId.\r
+///\r
+/// values for EFI_BIS_SIGNATURE_INFO.CertificateId.\r
 ///\r
 #define BIS_CERT_ID_DSA     BIS_ALG_DSA     // CSSM_ALGID_DSA\r
 #define BIS_CERT_ID_RSA_MD5 BIS_ALG_RSA_MD5 // CSSM_ALGID_MD5_WITH_RSA\r
-/// The  following  is a mask value that gets applied to the truncated hash of a\r
+///\r
+/// the mask value that gets applied to the truncated hash of a\r
 /// platform  Boot Object Authorization Certificate to create the certificateID.\r
 /// A certificateID must not have any bits set to the value 1 other than bits in\r
 /// this mask.\r
@@ -403,55 +401,6 @@ EFI_STATUS
   @par Protocol Description:\r
   The EFI_BIS_PROTOCOL is used to check a digital signature of a data block against a digital\r
   certificate for the purpose of an integrity and authorization check.\r
-\r
-  @param initialize\r
-  Initializes an application instance of the EFI_BIS protocol,\r
-  returning a handle for the application instance. Other functions in\r
-  the EFI_BIS protocol require a valid application instance\r
-  handle obtained from this function.\r
-  \r
-  @param Shutdown \r
-  Ends the lifetime of an application instance of the EFI_BIS\r
-  protocol, invalidating its application instance handle. The\r
-  application instance handle may no longer be used in other\r
-  functions in the EFI_BIS protocol.\r
-\r
-  @param Free \r
-  Frees memory structures allocated and returned by other\r
-  functions in the EFI_BIS protocol. \r
-\r
-  @param GetBootObjectAuthorizationCertificate\r
-  Retrieves the current digital certificate (if any) used by the\r
-  EFI_BIS protocol as the source of authorization for verifying\r
-  boot objects and altering configuration parameters.\r
-\r
-  @param GetBootObjectAuthorizationCheckFlag\r
-  Retrieves the current setting of the authorization check flag that\r
-  indicates whether or not authorization checks are required for\r
-  boot objects.\r
-\r
-  @param GetBootObjectAuthorizationUpdateToken\r
-  Retrieves an uninterpreted token whose value gets included and\r
-  signed in a subsequent request to alter the configuration\r
-  parameters, to protect against attempts to replay such a request.\r
-\r
-  @param GetSignatureInfo \r
-  Retrieves information about the digital signature algorithms\r
-  supported and the identity of the installed authorization\r
-  certificate, if any.\r
-\r
-  @param UpdateBootObjectAuthorization\r
-  Requests that the configuration parameters be altered by\r
-  installing or removing an authorization certificate or changing the\r
-  setting of the check flag. \r
-\r
-  @param VerifyBootObject\r
-  Verifies a boot object according to the supplied digital signature\r
-  and the current authorization certificate and check flag setting.\r
-\r
-  @param VerifyObjectWithCredential\r
-  Verifies a data object according to a supplied digital signature\r
-  and a supplied digital certificate.  \r
 **/\r
 struct _EFI_BIS_PROTOCOL {\r
   EFI_BIS_INITIALIZE                                  Initialize;\r