X-Git-Url: https://git.proxmox.com/?p=mirror_edk2.git;a=blobdiff_plain;f=MdePkg%2FInclude%2FProtocol%2FIp4.h;h=df6fd03cd57730f426dd3e6847615a3010125a36;hp=99885496458d945a4f3053e2ac9cc57ea4685fd4;hb=721b16af11941318ff27684da8bb7a90c9118385;hpb=14f7d6c89a1f0c8f2f64bb8e66a784329f4159e3

diff --git a/MdePkg/Include/Protocol/Ip4.h b/MdePkg/Include/Protocol/Ip4.h
index 9988549645..df6fd03cd5 100644
--- a/MdePkg/Include/Protocol/Ip4.h
+++ b/MdePkg/Include/Protocol/Ip4.h
@@ -1,5 +1,17 @@
 /** @file
-  Copyright (c) 2006, Intel Corporation                                                         
+  
+  This file defines the EFI IPv4 (Internet Protocol version 4)
+  Protocol interface. It is split into the following three main
+  sections:
+  - EFI IPv4 Service Binding Protocol
+  - EFI IPv4 Variable
+  - EFI IPv4 Protocol The EFI IPv4 Protocol provides basic
+    network IPv4 packet I/O services, which includes support for
+    a subset of the Internet Control Message Protocol (ICMP) and
+    may include support for the Internet Group Management
+    Protocol (IGMP).
+  
+  Copyright (c) 2006 - 2008, 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        
@@ -151,7 +163,7 @@ typedef struct {
   @param  This          Pointer to the EFI_IP4_PROTOCOL instance.
   @param  Ip4ModeData   Pointer to the EFI IPv4 Protocol mode data structure.
   @param  MnpConfigData Pointer to the managed network configuration data structure.
-  @param  SnpData       Pointer to the simple network mode data structure.
+  @param  SnpModeData   Pointer to the simple network mode data structure.
 
   @retval EFI_SUCCESS           The operation completed successfully.
   @retval EFI_INVALID_PARAMETER This is NULL.
@@ -160,13 +172,12 @@ typedef struct {
 **/
 typedef
 EFI_STATUS
-(EFIAPI *EFI_IP4_GET_MODE_DATA) (
+(EFIAPI *EFI_IP4_GET_MODE_DATA)(
   IN CONST  EFI_IP4_PROTOCOL                *This,
   OUT       EFI_IP4_MODE_DATA               *Ip4ModeData     OPTIONAL,
   OUT       EFI_MANAGED_NETWORK_CONFIG_DATA *MnpConfigData   OPTIONAL,
   OUT       EFI_SIMPLE_NETWORK_MODE         *SnpModeData     OPTIONAL
-  )
-;  
+  );  
 
 /**
   Assigns an IPv4 address and subnet mask to this EFI IPv4 Protocol driver instance.
@@ -188,16 +199,15 @@ EFI_STATUS
                                 IPv4 address or subnet mask can be changed. The interface must
                                 also be stopped when switching to/from raw packet mode.
   @retval EFI_DEVICE_ERROR      An unexpected system or network error occurred. The EFI IPv4
-                                 Protocol driver instance is not opened.
+                                Protocol driver instance is not opened.
 
 **/
 typedef 
 EFI_STATUS
-(EFIAPI *EFI_IP4_CONFIGURE) (
+(EFIAPI *EFI_IP4_CONFIGURE)(
   IN EFI_IP4_PROTOCOL    *This,
   IN EFI_IP4_CONFIG_DATA *IpConfigData     OPTIONAL
-  )
-;  
+  );  
 
 /**
   Joins and leaves multicast groups.
@@ -225,12 +235,11 @@ EFI_STATUS
 **/
 typedef 
 EFI_STATUS
-(EFIAPI *EFI_IP4_GROUPS) (
+(EFIAPI *EFI_IP4_GROUPS)(
   IN EFI_IP4_PROTOCOL    *This,
   IN BOOLEAN             JoinFlag,
   IN EFI_IPv4_ADDRESS    *GroupAddress  OPTIONAL
-  )
-;    
+  );    
 
 /**
   Adds and deletes routing table entries.
@@ -263,14 +272,13 @@ EFI_STATUS
 **/
 typedef 
 EFI_STATUS
-(EFIAPI *EFI_IP4_ROUTES) (
+(EFIAPI *EFI_IP4_ROUTES)(
   IN EFI_IP4_PROTOCOL    *This,
   IN BOOLEAN             DeleteRoute,
   IN EFI_IPv4_ADDRESS    *SubnetAddress,
   IN EFI_IPv4_ADDRESS    *SubnetMask,
   IN EFI_IPv4_ADDRESS    *GatewayAddress  
-  )
-;  
+  );  
 
 /**
   Places outgoing data packets into the transmit queue.
@@ -299,11 +307,10 @@ EFI_STATUS
 **/
 typedef 
 EFI_STATUS
-(EFIAPI *EFI_IP4_TRANSMIT) (
+(EFIAPI *EFI_IP4_TRANSMIT)(
   IN EFI_IP4_PROTOCOL          *This,
   IN EFI_IP4_COMPLETION_TOKEN  *Token
-  )
-;    
+  );    
 
 /**
   Places a receiving request into the receiving queue.
@@ -331,11 +338,10 @@ EFI_STATUS
 **/
 typedef 
 EFI_STATUS
-(EFIAPI *EFI_IP4_RECEIVE) (
+(EFIAPI *EFI_IP4_RECEIVE)(
   IN EFI_IP4_PROTOCOL          *This,
   IN EFI_IP4_COMPLETION_TOKEN  *Token
-  )
-;      
+  );      
 
 /**
   Abort an asynchronous transmit or receive request.
@@ -361,11 +367,10 @@ EFI_STATUS
 **/
 typedef
 EFI_STATUS
-(EFIAPI *EFI_IP4_CANCEL) (
+(EFIAPI *EFI_IP4_CANCEL)(
   IN EFI_IP4_PROTOCOL          *This,
   IN EFI_IP4_COMPLETION_TOKEN  *Token OPTIONAL
-  )
-;      
+  );      
   
 /**
   Polls for incoming data packets and processes outgoing data packets.
@@ -385,11 +390,15 @@ EFI_STATUS
 **/
 typedef 
 EFI_STATUS
-(EFIAPI *EFI_IP4_POLL) (
+(EFIAPI *EFI_IP4_POLL)(
   IN EFI_IP4_PROTOCOL          *This
-  )
-;  
+  );  
 
+/**  
+  @par Protocol Description:
+  The EFI IPv4 Protocol implements a simple packet-oriented interface that can be 
+  used by drivers, daemons, and applications to transmit and receive network packets.
+**/
 struct _EFI_IP4_PROTOCOL {
   EFI_IP4_GET_MODE_DATA        GetModeData;
   EFI_IP4_CONFIGURE            Configure;