Update the copyright notice format

[mirror_edk2.git] / MdeModulePkg / Universal / Network / IScsiDxe / Md5.c

diff --git a/MdeModulePkg/Universal/Network/IScsiDxe/Md5.c b/MdeModulePkg/Universal/Network/IScsiDxe/Md5.c
index 202de40d1f1df17f3b1bfcf09f9f532818b4054c..5dc7d994d67ff22a200e57de5eaaab0b36042bdb 100644 (file)
--- a/MdeModulePkg/Universal/Network/IScsiDxe/Md5.c
+++ b/MdeModulePkg/Universal/Network/IScsiDxe/Md5.c
@@ -1,8 +1,8 @@
 /** @file\r
   Implementation of MD5 algorithm.\r
 \r
-Copyright (c) 2004 - 2008, Intel Corporation.<BR>\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2004 - 2008, Intel Corporation. All rights reserved.<BR>\r
+This program and the accompanying materials\r
 are licensed and made available under the terms and conditions of the BSD License\r
 which accompanies this distribution.  The full text of the license may be found at\r
 http://opensource.org/licenses/bsd-license.php\r
@@ -89,9 +89,9 @@ CONST UINT8 Md5HashPadding[] =
 **/\r
 UINT32 \r
 Tf1 (\r
-  UINT32 A, \r
-  UINT32 B, \r
-  UINT32 C\r
+  IN UINT32 A, \r
+  IN UINT32 B, \r
+  IN UINT32 C\r
   )\r
 {\r
   return (A & B) | (~A & C);\r
@@ -109,9 +109,9 @@ Tf1 (
 **/\r
 UINT32 \r
 Tf2 (\r
-  UINT32 A, \r
-  UINT32 B, \r
-  UINT32 C\r
+  IN UINT32 A, \r
+  IN UINT32 B, \r
+  IN UINT32 C\r
   )\r
 {\r
   return (A & C) | (B & ~C);\r
@@ -129,9 +129,9 @@ Tf2 (
 **/\r
 UINT32 \r
 Tf3 (\r
-  UINT32 A, \r
-  UINT32 B, \r
-  UINT32 C\r
+  IN UINT32 A, \r
+  IN UINT32 B, \r
+  IN UINT32 C\r
   )\r
 {\r
   return A ^ B ^ C;\r
@@ -149,9 +149,9 @@ Tf3 (
 **/\r
 UINT32 \r
 Tf4 (\r
-  UINT32 A, \r
-  UINT32 B, \r
-  UINT32 C\r
+  IN UINT32 A, \r
+  IN UINT32 B, \r
+  IN UINT32 C\r
   )\r
 {\r
   return B ^ (A | ~C);\r
@@ -175,11 +175,11 @@ CONST MD5_TRANSFORM_FUNC Md5_F[] = {
 /**\r
   Perform the MD5 transform on 64 bytes data segment.\r
 \r
-  @param[in]  Md5Ctx  It includes the data segment for Md5 transform.\r
+  @param[in, out]  Md5Ctx  It includes the data segment for Md5 transform.\r
 **/\r
 VOID\r
 MD5Transform (\r
-  IN MD5_CTX  *Md5Ctx\r
+  IN OUT MD5_CTX  *Md5Ctx\r
   )\r
 {\r
   UINT32  Index1;\r
@@ -224,14 +224,14 @@ MD5Transform (
   All of Md5 code generated for the sequential 64-bytes data segaments are be\r
   accumulated in MD5Final() function.\r
 \r
-  @param[in]  Md5Ctx  The data structure of storing the original data\r
-                      segment and the final result.\r
-  @param[in]  Data    The data wanted to be transformed.\r
-  @param[in]  DataLen The length of data.\r
+  @param[in, out]  Md5Ctx  The data structure of storing the original data\r
+                           segment and the final result.\r
+  @param[in]       Data    The data wanted to be transformed.\r
+  @param[in]       DataLen The length of data.\r
 **/\r
 VOID\r
 MD5UpdateBlock (\r
-  IN MD5_CTX      *Md5Ctx,\r
+  IN OUT MD5_CTX  *Md5Ctx,\r
   IN CONST UINT8  *Data,\r
   IN       UINTN  DataLen\r
   )\r
@@ -254,13 +254,13 @@ MD5UpdateBlock (
 /**\r
   Initialize four 32-bits chaining variables and use them to do the Md5 transform.\r
 \r
-  @param[in]  Md5Ctx The data structure of Md5.\r
+  @param[out]  Md5Ctx The data structure of Md5.\r
 \r
   @retval EFI_SUCCESS Initialization is ok.\r
 **/\r
 EFI_STATUS\r
 MD5Init (\r
-  IN MD5_CTX  *Md5Ctx\r
+  OUT MD5_CTX  *Md5Ctx\r
   )\r
 {\r
   ZeroMem (Md5Ctx, sizeof (*Md5Ctx));\r
@@ -279,19 +279,19 @@ MD5Init (
 /**\r
   the external interface of Md5 algorithm\r
 \r
-  @param[in]  Md5Ctx  The data structure of storing the original data\r
-                      segment and the final result.\r
-  @param[in]  Data    The data wanted to be transformed.\r
-  @param[in]  DataLen The length of data.\r
+  @param[in, out]  Md5Ctx  The data structure of storing the original data\r
+                           segment and the final result.\r
+  @param[in]       Data    The data wanted to be transformed.\r
+  @param[in]       DataLen The length of data.\r
 \r
   @retval EFI_SUCCESS The transform is ok.\r
-  @retval Others      Some unexpected errors happened.\r
+  @retval Others      Other errors as indicated.\r
 **/\r
 EFI_STATUS\r
 MD5Update (\r
-  IN  MD5_CTX  *Md5Ctx,\r
-  IN  VOID     *Data,\r
-  IN  UINTN    DataLen\r
+  IN  OUT MD5_CTX  *Md5Ctx,\r
+  IN  VOID         *Data,\r
+  IN  UINTN        DataLen\r
   )\r
 {\r
   if (EFI_ERROR (Md5Ctx->Status)) {\r
@@ -307,17 +307,17 @@ MD5Update (
   Accumulate the MD5 value of every data segment and generate the finial\r
   result according to MD5 algorithm.\r
 \r
-  @param[in]   Md5Ctx  The data structure of storing the original data\r
-                       segment and the final result.\r
-  @param[out]  HashVal The final 128-bits output.\r
+  @param[in, out]   Md5Ctx  The data structure of storing the original data\r
+                            segment and the final result.\r
+  @param[out]      HashVal  The final 128-bits output.\r
 \r
   @retval EFI_SUCCESS  The transform is ok.\r
-  @retval Others       Some unexpected errors happened.\r
+  @retval Others       Other errors as indicated.\r
 **/\r
 EFI_STATUS\r
 MD5Final (\r
-  IN  MD5_CTX  *Md5Ctx,\r
-  OUT UINT8    *HashVal\r
+  IN  OUT MD5_CTX  *Md5Ctx,\r
+  OUT UINT8        *HashVal\r
   )\r
 {\r
   UINTN PadLength;\r