/** @file\r
+ Common definition for IP4.\r
\r
-Copyright (c) 2005 - 2006, Intel Corporation\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2005 - 2018, 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
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
-\r
-Module Name:\r
-\r
- Ip4Common.h\r
-\r
-Abstract:\r
-\r
- Common definition for IP4.\r
-\r
-\r
**/\r
\r
#ifndef __EFI_IP4_COMMON_H__\r
typedef struct _IP4_PROTOCOL IP4_PROTOCOL;\r
typedef struct _IP4_SERVICE IP4_SERVICE;\r
\r
-\r
-typedef enum {\r
- IP4_ETHER_PROTO = 0x0800,\r
-\r
- IP4_PROTO_ICMP = 0x01,\r
- IP4_PROTO_IGMP = 0x02,\r
-\r
- //\r
- // The packet is received as link level broadcast/multicast/promiscuous.\r
- //\r
- IP4_LINK_BROADCAST = 0x00000001,\r
- IP4_LINK_MULTICAST = 0x00000002,\r
- IP4_LINK_PROMISC = 0x00000004,\r
-\r
- //\r
- // IP4 address cast type classfication. Keep it true that any\r
- // type bigger than or equal to LOCAL_BROADCAST is broadcast.\r
- //\r
- IP4_PROMISCUOUS = 1,\r
- IP4_LOCAL_HOST,\r
- IP4_MULTICAST,\r
- IP4_LOCAL_BROADCAST, // Destination is 255.255.255.255\r
- IP4_SUBNET_BROADCAST,\r
- IP4_NET_BROADCAST,\r
-\r
- //\r
- // IP4 header flags\r
- //\r
- IP4_HEAD_DF_MASK = 0x4000,\r
- IP4_HEAD_MF_MASK = 0x2000,\r
- IP4_HEAD_OFFSET_MASK = 0x1fff\r
-} IP_ENUM_TYPES;\r
+#define IP4_ETHER_PROTO 0x0800\r
+\r
+//\r
+// The packet is received as link level broadcast/multicast/promiscuous.\r
+//\r
+#define IP4_LINK_BROADCAST 0x00000001\r
+#define IP4_LINK_MULTICAST 0x00000002\r
+#define IP4_LINK_PROMISC 0x00000004\r
+\r
+//\r
+// IP4 address cast type classfication. Keep it true that any\r
+// type bigger than or equal to LOCAL_BROADCAST is broadcast.\r
+//\r
+#define IP4_PROMISCUOUS 1\r
+#define IP4_LOCAL_HOST 2\r
+#define IP4_MULTICAST 3\r
+#define IP4_LOCAL_BROADCAST 4 // Destination is 255.255.255.255\r
+#define IP4_SUBNET_BROADCAST 5\r
+#define IP4_NET_BROADCAST 6\r
+\r
+//\r
+// IP4 header flags\r
+//\r
+#define IP4_HEAD_DF_MASK 0x4000\r
+#define IP4_HEAD_MF_MASK 0x2000\r
+#define IP4_HEAD_OFFSET_MASK 0x1fff\r
\r
#define IP4_ALLZERO_ADDRESS 0x00000000u\r
#define IP4_ALLONE_ADDRESS 0xFFFFFFFFu\r
#define IP4_FIRST_FRAGMENT(FragmentField) \\r
((BOOLEAN)(((FragmentField) & IP4_HEAD_OFFSET_MASK) == 0))\r
\r
+#define IP4_DO_NOT_FRAGMENT(FragmentField) \\r
+ ((BOOLEAN)(((FragmentField) & IP4_HEAD_DF_MASK) == IP4_HEAD_DF_MASK))\r
+\r
#define IP4_IS_BROADCAST(CastType) ((CastType) >= IP4_LOCAL_BROADCAST)\r
\r
///\r
///\r
#define IP4_US_TO_SEC(Us) (((Us) + 999999) / 1000000)\r
\r
+/**\r
+ Return the cast type (Unicast/Boradcast) specific to an\r
+ interface. All the addresses are host byte ordered.\r
+\r
+ @param[in] IpAddr The IP address to classify in host byte order\r
+ @param[in] IpIf The interface that IpAddr received from\r
+\r
+ @return The cast type of this IP address specific to the interface.\r
+ @retval IP4_LOCAL_HOST The IpAddr equals to the interface's address\r
+ @retval IP4_SUBNET_BROADCAST The IpAddr is a directed subnet boradcast to the\r
+ interface\r
+ @retval IP4_NET_BROADCAST The IpAddr is a network broadcast to the interface\r
+ @retval 0 Otherwise.\r
+\r
+**/\r
INTN\r
Ip4GetNetCast (\r
- IN IP4_ADDR IpAddr,\r
- IN IP4_INTERFACE *IpIf\r
+ IN IP4_ADDR IpAddr,\r
+ IN IP4_INTERFACE *IpIf\r
);\r
\r
+/**\r
+ Find the cast type of the packet related to the local host.\r
+ This isn't the same as link layer cast type. For example, DHCP\r
+ server may send local broadcast to the local unicast MAC.\r
+\r
+ @param[in] IpSb The IP4 service binding instance that received the\r
+ packet\r
+ @param[in] Dst The destination address in the packet (host byte\r
+ order)\r
+ @param[in] Src The source address in the packet (host byte order)\r
+\r
+ @return The cast type for the Dst, it will return on the first non-promiscuous\r
+ cast type to a configured interface. If the packet doesn't match any of\r
+ the interface, multicast address and local broadcast address are checked.\r
+\r
+**/\r
INTN\r
Ip4GetHostCast (\r
- IN IP4_SERVICE *IpSb,\r
- IN IP4_ADDR Dst,\r
- IN IP4_ADDR Src\r
+ IN IP4_SERVICE *IpSb,\r
+ IN IP4_ADDR Dst,\r
+ IN IP4_ADDR Src\r
);\r
\r
+/**\r
+ Find an interface whose configured IP address is Ip.\r
+\r
+ @param[in] IpSb The IP4 service binding instance\r
+ @param[in] Ip The Ip address (host byte order) to find\r
+\r
+ @return The IP4_INTERFACE point if found, otherwise NULL\r
+\r
+**/\r
IP4_INTERFACE *\r
Ip4FindInterface (\r
- IN IP4_SERVICE *IpService,\r
- IN IP4_ADDR Addr\r
+ IN IP4_SERVICE *IpSb,\r
+ IN IP4_ADDR Ip\r
);\r
\r
+/**\r
+ Find an interface that Ip is on that connected network.\r
+\r
+ @param[in] IpSb The IP4 service binding instance\r
+ @param[in] Ip The Ip address (host byte order) to find\r
+\r
+ @return The IP4_INTERFACE point if found, otherwise NULL\r
+\r
+**/\r
IP4_INTERFACE *\r
Ip4FindNet (\r
- IN IP4_SERVICE *IpService,\r
- IN IP4_ADDR Addr\r
+ IN IP4_SERVICE *IpSb,\r
+ IN IP4_ADDR Ip\r
);\r
\r
+/**\r
+ Find an interface of the service with the same Ip/Netmask pair.\r
+\r
+ @param[in] IpSb Ip4 service binding instance\r
+ @param[in] Ip The Ip adress to find (host byte order)\r
+ @param[in] Netmask The network to find (host byte order)\r
+\r
+ @return The IP4_INTERFACE point if found, otherwise NULL\r
+\r
+**/\r
IP4_INTERFACE *\r
Ip4FindStationAddress (\r
- IN IP4_SERVICE *IpSb,\r
- IN IP4_ADDR Ip,\r
- IN IP4_ADDR Netmask\r
+ IN IP4_SERVICE *IpSb,\r
+ IN IP4_ADDR Ip,\r
+ IN IP4_ADDR Netmask\r
);\r
\r
+/**\r
+ Get the MAC address for a multicast IP address. Call\r
+ Mnp's McastIpToMac to find the MAC address in stead of\r
+ hard code the NIC to be Ethernet.\r
+\r
+ @param[in] Mnp The Mnp instance to get the MAC address.\r
+ @param[in] Multicast The multicast IP address to translate.\r
+ @param[out] Mac The buffer to hold the translated address.\r
+\r
+ @retval EFI_SUCCESS if the multicast IP is successfully translated to a\r
+ multicast MAC address.\r
+ @retval other Otherwise some error.\r
+\r
+**/\r
EFI_STATUS\r
Ip4GetMulticastMac (\r
IN EFI_MANAGED_NETWORK_PROTOCOL *Mnp,\r
OUT EFI_MAC_ADDRESS *Mac\r
);\r
\r
+/**\r
+ Convert the multibyte field in IP header's byter order.\r
+ In spite of its name, it can also be used to convert from\r
+ host to network byte order.\r
+\r
+ @param[in] Head The IP head to convert\r
+\r
+ @return Point to the converted IP head\r
+\r
+**/\r
IP4_HEAD *\r
Ip4NtohHead (\r
- IN IP4_HEAD *Head\r
+ IN IP4_HEAD *Head\r
);\r
\r
-EFI_STATUS\r
-Ip4SetVariableData (\r
- IN IP4_SERVICE *IpSb\r
- );\r
\r
-VOID\r
-Ip4ClearVariableData (\r
- IN IP4_SERVICE *IpSb\r
+/**\r
+ Validate that Ip/Netmask pair is OK to be used as station\r
+ address. Only continuous netmasks are supported. and check\r
+ that StationAddress is a unicast address on the newtwork.\r
+\r
+ @param[in] Ip The IP address to validate.\r
+ @param[in] Netmask The netmaks of the IP.\r
+\r
+ @retval TRUE The Ip/Netmask pair is valid.\r
+ @retval FALSE The Ip/Netmask pair is invalid.\r
+\r
+**/\r
+BOOLEAN\r
+Ip4StationAddressValid (\r
+ IN IP4_ADDR Ip,\r
+ IN IP4_ADDR Netmask\r
);\r
\r
#endif\r
projects / mirror_edk2.git / blobdiff