This library is only intended to be used by UEFI network stack modules.\r
It provides basic functions for the UEFI network stack.\r
\r
-Copyright (c) 2005 - 2010, Intel Corporation.<BR>\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
-which accompanies this distribution. The full text of the license may be found at<BR>\r
-http://opensource.org/licenses/bsd-license.php\r
-\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
+Copyright (c) 2005 - 2018, Intel Corporation. All rights reserved.<BR>\r
+SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#include <Protocol/Ip6.h>\r
\r
#include <Library/BaseLib.h>\r
+#include <Library/BaseMemoryLib.h>\r
\r
typedef UINT32 IP4_ADDR;\r
typedef UINT32 TCP_SEQNO;\r
#define EFI_IP_PROTO_ICMP 0x01\r
#define IP4_PROTO_IGMP 0x02\r
#define IP6_ICMP 58\r
+#define DNS_MAX_NAME_SIZE 255\r
+#define DNS_MAX_MESSAGE_SIZE 512\r
\r
//\r
// The address classification\r
//\r
-#define IP4_ADDR_CLASSA 1\r
-#define IP4_ADDR_CLASSB 2\r
-#define IP4_ADDR_CLASSC 3\r
+#define IP4_ADDR_CLASSA 1 // Deprecated\r
+#define IP4_ADDR_CLASSB 2 // Deprecated\r
+#define IP4_ADDR_CLASSC 3 // Deprecated\r
#define IP4_ADDR_CLASSD 4\r
#define IP4_ADDR_CLASSE 5\r
\r
#define IP4_MASK_NUM 33\r
#define IP6_PREFIX_NUM 129\r
\r
+#define IP4_MASK_MAX 32\r
+#define IP6_PREFIX_MAX 128\r
+\r
#define IP6_HOP_BY_HOP 0\r
#define IP6_DESTINATION 60\r
+#define IP6_ROUTING 43\r
#define IP6_FRAGMENT 44\r
#define IP6_AH 51\r
#define IP6_ESP 50\r
#define IP_VERSION_4 4\r
#define IP_VERSION_6 6\r
\r
+#define IP6_PREFIX_LENGTH 64\r
+\r
+//\r
+// DNS QTYPE values\r
+//\r
+#define DNS_TYPE_A 1\r
+#define DNS_TYPE_NS 2\r
+#define DNS_TYPE_CNAME 5\r
+#define DNS_TYPE_SOA 6\r
+#define DNS_TYPE_WKS 11\r
+#define DNS_TYPE_PTR 12\r
+#define DNS_TYPE_HINFO 13\r
+#define DNS_TYPE_MINFO 14\r
+#define DNS_TYPE_MX 15\r
+#define DNS_TYPE_TXT 16\r
+#define DNS_TYPE_AAAA 28\r
+#define DNS_TYPE_SRV_RR 33\r
+#define DNS_TYPE_AXFR 252\r
+#define DNS_TYPE_MAILB 253\r
+#define DNS_TYPE_ANY 255\r
+\r
+//\r
+// DNS QCLASS values\r
+//\r
+#define DNS_CLASS_INET 1\r
+#define DNS_CLASS_CH 3\r
+#define DNS_CLASS_HS 4\r
+#define DNS_CLASS_ANY 255\r
+\r
+//\r
+// Number of 100ns units time Interval for network media state detect\r
+//\r
+#define MEDIA_STATE_DETECT_TIME_INTERVAL 1000000U\r
+\r
+\r
#pragma pack(1)\r
\r
//\r
// Test the IP's attribute, All the IPs are in host byte order.\r
//\r
#define IP4_IS_MULTICAST(Ip) (((Ip) & 0xF0000000) == 0xE0000000)\r
+#define IP4_IS_UNSPECIFIED(Ip) ((Ip) == 0)\r
#define IP4_IS_LOCAL_BROADCAST(Ip) ((Ip) == 0xFFFFFFFF)\r
#define IP4_NET_EQUAL(Ip1, Ip2, NetMask) (((Ip1) & (NetMask)) == ((Ip2) & (NetMask)))\r
-#define IP4_IS_VALID_NETMASK(Ip) (NetGetMaskLength (Ip) != IP4_MASK_NUM)\r
+#define IP4_IS_VALID_NETMASK(Ip) (NetGetMaskLength (Ip) != (IP4_MASK_MAX + 1))\r
\r
#define IP6_IS_MULTICAST(Ip6) (((Ip6)->Addr[0]) == 0xFF)\r
\r
\r
#define EFI_IP6_EQUAL(Ip1, Ip2) (CompareMem ((Ip1), (Ip2), sizeof (EFI_IPv6_ADDRESS)) == 0)\r
\r
+#define IP4_COPY_ADDRESS(Dest, Src) (CopyMem ((Dest), (Src), sizeof (EFI_IPv4_ADDRESS)))\r
#define IP6_COPY_ADDRESS(Dest, Src) (CopyMem ((Dest), (Src), sizeof (EFI_IPv6_ADDRESS)))\r
#define IP6_COPY_LINK_ADDRESS(Mac1, Mac2) (CopyMem ((Mac1), (Mac2), sizeof (EFI_MAC_ADDRESS)))\r
\r
//\r
// The debug level definition. This value is also used as the\r
-// syslog's servity level. Don't change it.\r
+// syslog's severity level. Don't change it.\r
//\r
#define NETDEBUG_LEVEL_TRACE 5\r
#define NETDEBUG_LEVEL_WARNING 4\r
This function will locate a instance of SNP then send the message through it.\r
Because it isn't open the SNP BY_DRIVER, apply caution when using it.\r
\r
- @param Level The servity level of the message.\r
- @param Module The Moudle that generates the log.\r
+ @param Level The severity level of the message.\r
+ @param Module The Module that generates the log.\r
@param File The file that contains the log.\r
@param Line The exact line that contains the log.\r
@param Message The user message to log.\r
Return the class of the IP address, such as class A, B, C.\r
Addr is in host byte order.\r
\r
+ [ATTENTION]\r
+ Classful addressing (IP class A/B/C) has been deprecated according to RFC4632.\r
+ Caller of this function could only check the returned value against\r
+ IP4_ADDR_CLASSD (multicast) or IP4_ADDR_CLASSE (reserved) now.\r
+\r
The address of class A starts with 0.\r
If the address belong to class A, return IP4_ADDR_CLASSA.\r
The address of class B starts with 10.\r
\r
/**\r
Check whether the IP is a valid unicast address according to\r
- the netmask. If NetMask is zero, use the IP address's class to get the default mask.\r
+ the netmask.\r
+\r
+ ASSERT if NetMask is zero.\r
\r
- If Ip is 0, IP is not a valid unicast address.\r
- Class D address is used for multicasting and class E address is reserved for future. If Ip\r
- belongs to class D or class E, Ip is not a valid unicast address.\r
- If all bits of the host address of Ip are 0 or 1, Ip is not a valid unicast address.\r
+ If all bits of the host address of IP are 0 or 1, IP is also not a valid unicast address,\r
+ except when the originator is one of the endpoints of a point-to-point link with a 31-bit\r
+ mask (RFC3021), or a 32bit NetMask (all 0xFF) is used for special network environment (e.g.\r
+ PPP link).\r
\r
@param[in] Ip The IP to check against.\r
@param[in] NetMask The mask of the IP.\r
\r
- @return TRUE if Ip is a valid unicast address on the network, otherwise FALSE.\r
+ @return TRUE if IP is a valid unicast address on the network, otherwise FALSE.\r
\r
**/\r
BOOLEAN\r
/**\r
Check whether the incoming IPv6 address is a valid unicast address.\r
\r
+ ASSERT if Ip6 is NULL.\r
+\r
If the address is a multicast address has binary 0xFF at the start, it is not\r
a valid unicast address. If the address is unspecified ::, it is not a valid\r
unicast address to be assigned to any node. If the address is loopback address\r
/**\r
Check whether the incoming Ipv6 address is the unspecified address or not.\r
\r
+ ASSERT if Ip6 is NULL.\r
+\r
@param[in] Ip6 - Ip6 address, in network order.\r
\r
@retval TRUE - Yes, incoming Ipv6 address is the unspecified address.\r
/**\r
Check whether the incoming Ipv6 address is a link-local address.\r
\r
+ ASSERT if Ip6 is NULL.\r
+\r
@param[in] Ip6 - Ip6 address, in network order.\r
\r
@retval TRUE - The incoming Ipv6 address is a link-local address.\r
/**\r
Check whether the Ipv6 address1 and address2 are on the connected network.\r
\r
+ ASSERT if Ip1 or Ip2 is NULL.\r
+ ASSERT if PrefixLength exceeds or equals to IP6_PREFIX_MAX.\r
+\r
@param[in] Ip1 - Ip6 address1, in network order.\r
@param[in] Ip2 - Ip6 address2, in network order.\r
@param[in] PrefixLength - The prefix length of the checking net.\r
/**\r
Switches the endianess of an IPv6 address.\r
\r
+ ASSERT if Ip6 is NULL.\r
+\r
This function swaps the bytes in a 128-bit IPv6 address to switch the value\r
from little endian to big endian or vice versa. The byte swapped value is\r
returned.\r
extern EFI_IPv4_ADDRESS mZeroIp4Addr;\r
\r
#define NET_IS_DIGIT(Ch) (('0' <= (Ch)) && ((Ch) <= '9'))\r
+#define NET_IS_HEX(Ch) ((('0' <= (Ch)) && ((Ch) <= '9')) || (('A' <= (Ch)) && ((Ch) <= 'F')) || (('a' <= (Ch)) && ((Ch) <= 'f')))\r
#define NET_ROUNDUP(size, unit) (((size) + (unit) - 1) & (~((unit) - 1)))\r
#define NET_IS_LOWER_CASE_CHAR(Ch) (('a' <= (Ch)) && ((Ch) <= 'z'))\r
#define NET_IS_UPPER_CASE_CHAR(Ch) (('A' <= (Ch)) && ((Ch) <= 'Z'))\r
/**\r
Extract a UINT32 from a byte stream.\r
\r
+ ASSERT if Buf is NULL.\r
+\r
This function copies a UINT32 from a byte stream, and then converts it from Network\r
byte order to host byte order. Use this function to avoid alignment error.\r
\r
/**\r
Puts a UINT32 into the byte stream in network byte order.\r
\r
+ ASSERT if Buf is NULL.\r
+\r
Converts a UINT32 from host byte order to network byte order, then copies it to the\r
byte stream.\r
\r
);\r
\r
/**\r
- Initialize a random seed using current time.\r
+ Initialize a random seed using current time and monotonic count.\r
\r
- Get current time first. Then initialize a random seed based on some basic\r
- mathematical operations on the hour, day, minute, second, nanosecond and year\r
- of the current time.\r
+ Get current time and monotonic count first. Then initialize a random seed\r
+ based on some basic mathematics operation on the hour, day, minute, second,\r
+ nanosecond and year of the current time and the monotonic count value.\r
\r
- @return The random seed, initialized with current time.\r
+ @return The random seed initialized with current time.\r
\r
**/\r
UINT32\r
/**\r
Insert a new node entry after a designated node entry of a doubly linked list.\r
\r
+ ASSERT if PrevEntry or NewEntry is NULL.\r
+\r
Inserts a new node entry designated by NewEntry after the node entry designated by PrevEntry\r
of the doubly linked list.\r
\r
/**\r
Insert a new node entry before a designated node entry of a doubly linked list.\r
\r
+ ASSERT if PostEntry or NewEntry is NULL.\r
+\r
Inserts a new node entry designated by NewEntry before the node entry designated by PostEntry\r
of the doubly linked list.\r
\r
IN OUT LIST_ENTRY *NewEntry\r
);\r
\r
+/**\r
+ Callback function which provided by user to remove one node in NetDestroyLinkList process.\r
+\r
+ @param[in] Entry The entry to be removed.\r
+ @param[in] Context Pointer to the callback context corresponds to the Context in NetDestroyLinkList.\r
+\r
+ @retval EFI_SUCCESS The entry has been removed successfully.\r
+ @retval Others Fail to remove the entry.\r
+\r
+**/\r
+typedef\r
+EFI_STATUS\r
+(EFIAPI *NET_DESTROY_LINK_LIST_CALLBACK) (\r
+ IN LIST_ENTRY *Entry,\r
+ IN VOID *Context OPTIONAL\r
+ );\r
+\r
+/**\r
+ Safe destroy nodes in a linked list, and return the length of the list after all possible operations finished.\r
+\r
+ Destroy network children list by list traversals is not safe due to graph dependencies between nodes.\r
+ This function performs a safe traversal to destroy these nodes by checking to see if the node being destroyed\r
+ has been removed from the list or not.\r
+ If it has been removed, then restart the traversal from the head.\r
+ If it hasn't been removed, then continue with the next node directly.\r
+ This function will end the iterate and return the CallBack's last return value if error happens,\r
+ or retrun EFI_SUCCESS if 2 complete passes are made with no changes in the number of children in the list.\r
+\r
+ @param[in] List The head of the list.\r
+ @param[in] CallBack Pointer to the callback function to destroy one node in the list.\r
+ @param[in] Context Pointer to the callback function's context: corresponds to the\r
+ parameter Context in NET_DESTROY_LINK_LIST_CALLBACK.\r
+ @param[out] ListLength The length of the link list if the function returns successfully.\r
+\r
+ @retval EFI_SUCCESS Two complete passes are made with no changes in the number of children.\r
+ @retval EFI_INVALID_PARAMETER The input parameter is invalid.\r
+ @retval Others Return the CallBack's last return value.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+NetDestroyLinkList (\r
+ IN LIST_ENTRY *List,\r
+ IN NET_DESTROY_LINK_LIST_CALLBACK CallBack,\r
+ IN VOID *Context, OPTIONAL\r
+ OUT UINTN *ListLength OPTIONAL\r
+ );\r
+\r
+/**\r
+ This function checks the input Handle to see if it's one of these handles in ChildHandleBuffer.\r
+\r
+ @param[in] Handle Handle to be checked.\r
+ @param[in] NumberOfChildren Number of Handles in ChildHandleBuffer.\r
+ @param[in] ChildHandleBuffer An array of child handles to be freed. May be NULL\r
+ if NumberOfChildren is 0.\r
+\r
+ @retval TRUE Found the input Handle in ChildHandleBuffer.\r
+ @retval FALSE Can't find the input Handle in ChildHandleBuffer.\r
+\r
+**/\r
+BOOLEAN\r
+EFIAPI\r
+NetIsInHandleBuffer (\r
+ IN EFI_HANDLE Handle,\r
+ IN UINTN NumberOfChildren,\r
+ IN EFI_HANDLE *ChildHandleBuffer OPTIONAL\r
+ );\r
\r
//\r
// Object container: EFI network stack spec defines various kinds of\r
\r
If Map is NULL, then ASSERT().\r
\r
-\r
@param[in] Map The net map to test.\r
\r
@return TRUE if the netmap is empty, otherwise FALSE.\r
/**\r
Return the number of the <Key, Value> pairs in the netmap.\r
\r
+ If Map is NULL, then ASSERT().\r
+\r
@param[in] Map The netmap to get the entry number.\r
\r
@return The entry number in the netmap.\r
pairs in the netmap increase by 1.\r
\r
If Map is NULL, then ASSERT().\r
+ If Key is NULL, then ASSERT().\r
\r
@param[in, out] Map The netmap to insert into.\r
@param[in] Key The user's key.\r
pairs in the netmap increase by 1.\r
\r
If Map is NULL, then ASSERT().\r
+ If Key is NULL, then ASSERT().\r
\r
@param[in, out] Map The netmap to insert into.\r
@param[in] Key The user's key.\r
item with the key to search. It returns the point to the item contains the Key if found.\r
\r
If Map is NULL, then ASSERT().\r
+ If Key is NULL, then ASSERT().\r
\r
@param[in] Map The netmap to search within.\r
@param[in] Key The key to search.\r
/**\r
Iterate through the netmap and call CallBack for each item.\r
\r
- It will contiue the traverse if CallBack returns EFI_SUCCESS, otherwise, break\r
+ It will continue the traverse if CallBack returns EFI_SUCCESS, otherwise, break\r
from the loop. It returns the CallBack's last return value. This function is\r
delete safe for the current item.\r
\r
/**\r
Get MAC address associated with the network service handle.\r
\r
+ If MacAddress is NULL, then ASSERT().\r
+ If AddressSize is NULL, then ASSERT().\r
+\r
There should be MNP Service Binding Protocol installed on the input ServiceHandle.\r
If SNP is installed on the ServiceHandle or its parent handle, MAC address will\r
be retrieved from SNP. If no SNP found, try to get SNP mode data use MNP.\r
Convert MAC address of the NIC associated with specified Service Binding Handle\r
to a unicode string. Callers are responsible for freeing the string storage.\r
\r
+ If MacString is NULL, then ASSERT().\r
+\r
Locate simple network protocol associated with the Service Binding Handle and\r
get the mac address from SNP. Then convert the mac address into a unicode\r
string. It takes 2 unicode characters to represent a 1 byte binary buffer.\r
@param[in] ServiceHandle The handle where network service binding protocol is\r
installed.\r
@param[in] ImageHandle The image handle used to act as the agent handle to\r
- get the simple network protocol.\r
+ get the simple network protocol. This parameter is\r
+ optional and may be NULL.\r
@param[out] MacString The pointer to store the address of the string\r
representation of the mac address.\r
\r
EFIAPI\r
NetLibGetMacString (\r
IN EFI_HANDLE ServiceHandle,\r
- IN EFI_HANDLE ImageHandle,\r
+ IN EFI_HANDLE ImageHandle, OPTIONAL\r
OUT CHAR16 **MacString\r
);\r
\r
/**\r
Detect media status for specified network device.\r
\r
+ If MediaPresent is NULL, then ASSERT().\r
+\r
The underlying UNDI driver may or may not support reporting media status from\r
GET_STATUS command (PXE_STATFLAGS_GET_STATUS_NO_MEDIA_SUPPORTED). This routine\r
will try to invoke Snp->GetStatus() to get the media status. If media is already\r
present, it returns directly. If media is not present, it will stop SNP and then\r
- restart SNP to get the latest media status. This provides an opportunity to get \r
- the correct media status for old UNDI driver, which doesn't support reporting \r
+ restart SNP to get the latest media status. This provides an opportunity to get\r
+ the correct media status for old UNDI driver, which doesn't support reporting\r
media status from GET_STATUS command.\r
Note: there are two limitations for the current algorithm:\r
1) For UNDI with this capability, when the cable is not attached, there will\r
OUT BOOLEAN *MediaPresent\r
);\r
\r
+/**\r
+ Detect media state for a network device. This routine will wait for a period of time at\r
+ a specified checking interval when a certain network is under connecting until connection\r
+ process finishes or timeout. If Aip protocol is supported by low layer drivers, three kinds\r
+ of media states can be detected: EFI_SUCCESS, EFI_NOT_READY and EFI_NO_MEDIA, represents\r
+ connected state, connecting state and no media state respectively. When function detects\r
+ the current state is EFI_NOT_READY, it will loop to wait for next time's check until state\r
+ turns to be EFI_SUCCESS or EFI_NO_MEDIA. If Aip protocol is not supported, function will\r
+ call NetLibDetectMedia() and return state directly.\r
+\r
+ @param[in] ServiceHandle The handle where network service binding protocols are\r
+ installed on.\r
+ @param[in] Timeout The maximum number of 100ns units to wait when network\r
+ is connecting. Zero value means detect once and return\r
+ immediately.\r
+ @param[out] MediaState The pointer to the detected media state.\r
+\r
+ @retval EFI_SUCCESS Media detection success.\r
+ @retval EFI_INVALID_PARAMETER ServiceHandle is not a valid network device handle or\r
+ MediaState pointer is NULL.\r
+ @retval EFI_DEVICE_ERROR A device error occurred.\r
+ @retval EFI_TIMEOUT Network is connecting but timeout.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+NetLibDetectMediaWaitTimeout (\r
+ IN EFI_HANDLE ServiceHandle,\r
+ IN UINT64 Timeout,\r
+ OUT EFI_STATUS *MediaState\r
+ );\r
+\r
+\r
/**\r
Create an IPv4 device path node.\r
\r
+ If Node is NULL, then ASSERT().\r
+\r
The header type of IPv4 device path node is MESSAGING_DEVICE_PATH.\r
The header subtype of IPv4 device path node is MSG_IPv4_DP.\r
The length of the IPv4 device path node in bytes is 19.\r
/**\r
Create an IPv6 device path node.\r
\r
+ If Node is NULL, then ASSERT().\r
+ If LocalIp is NULL, then ASSERT().\r
+ If RemoteIp is NULL, then ASSERT().\r
+\r
The header type of IPv6 device path node is MESSAGING_DEVICE_PATH.\r
The header subtype of IPv6 device path node is MSG_IPv6_DP.\r
The length of the IPv6 device path node in bytes is 43.\r
/**\r
Find the UNDI/SNP handle from controller and protocol GUID.\r
\r
+ If ProtocolGuid is NULL, then ASSERT().\r
+\r
For example, IP will open an MNP child to transmit/receive\r
packets. When MNP is stopped, IP should also be stopped. IP\r
needs to find its own private data that is related the IP's\r
service binding instance that is installed on the UNDI/SNP handle.\r
The controller is then either an MNP or an ARP child handle. Note that\r
- IP opens these handles using BY_DRIVER. Use that infomation to get the\r
+ IP opens these handles using BY_DRIVER. Use that information to get the\r
UNDI/SNP handle.\r
\r
@param[in] Controller The protocol handle to check.\r
@param[out] Ip4Address The pointer to the converted IPv4 address.\r
\r
@retval EFI_SUCCESS Converted to an IPv4 address successfully.\r
- @retval EFI_INVALID_PARAMETER The string is malformated, or Ip4Address is NULL.\r
+ @retval EFI_INVALID_PARAMETER The string is malformatted, or Ip4Address is NULL.\r
\r
**/\r
EFI_STATUS\r
\r
/**\r
Convert one Null-terminated ASCII string to EFI_IPv6_ADDRESS. The format of the\r
- string is defined in RFC 4291 - Text Pepresentation of Addresses.\r
+ string is defined in RFC 4291 - Text Representation of Addresses.\r
\r
@param[in] String The pointer to the Ascii string.\r
@param[out] Ip6Address The pointer to the converted IPv6 address.\r
\r
@retval EFI_SUCCESS Converted to an IPv6 address successfully.\r
- @retval EFI_INVALID_PARAMETER The string is malformated, or Ip6Address is NULL.\r
+ @retval EFI_INVALID_PARAMETER The string is malformatted, or Ip6Address is NULL.\r
\r
**/\r
EFI_STATUS\r
@param[out] Ip4Address The pointer to the converted IPv4 address.\r
\r
@retval EFI_SUCCESS Converted to an IPv4 address successfully.\r
- @retval EFI_INVALID_PARAMETER The string is mal-formated or Ip4Address is NULL.\r
- @retval EFI_OUT_OF_RESOURCES Failed to perform the operation due to lack of resources.\r
+ @retval EFI_INVALID_PARAMETER The string is mal-formatted or Ip4Address is NULL.\r
\r
**/\r
EFI_STATUS\r
\r
/**\r
Convert one Null-terminated Unicode string to EFI_IPv6_ADDRESS. The format of\r
- the string is defined in RFC 4291 - Text Pepresentation of Addresses.\r
+ the string is defined in RFC 4291 - Text Representation of Addresses.\r
\r
@param[in] String The pointer to the Ascii string.\r
@param[out] Ip6Address The pointer to the converted IPv6 address.\r
\r
@retval EFI_SUCCESS Converted to an IPv6 address successfully.\r
- @retval EFI_INVALID_PARAMETER The string is malformated or Ip6Address is NULL.\r
- @retval EFI_OUT_OF_RESOURCES Failed to perform the operation due to a lack of resources.\r
+ @retval EFI_INVALID_PARAMETER The string is malformatted or Ip6Address is NULL.\r
\r
**/\r
EFI_STATUS\r
\r
/**\r
Convert one Null-terminated Unicode string to EFI_IPv6_ADDRESS and prefix length.\r
- The format of the string is defined in RFC 4291 - Text Pepresentation of Addresses\r
+ The format of the string is defined in RFC 4291 - Text Representation of Addresses\r
Prefixes: ipv6-address/prefix-length.\r
\r
@param[in] String The pointer to the Ascii string.\r
@param[out] PrefixLength The pointer to the converted prefix length.\r
\r
@retval EFI_SUCCESS Converted to an IPv6 address successfully.\r
- @retval EFI_INVALID_PARAMETER The string is malformated, or Ip6Address is NULL.\r
- @retval EFI_OUT_OF_RESOURCES Failed to perform the operation due to a lack of resources.\r
+ @retval EFI_INVALID_PARAMETER The string is malformatted, or Ip6Address is NULL.\r
\r
**/\r
EFI_STATUS\r
OUT UINT8 *PrefixLength\r
);\r
\r
+/**\r
+\r
+ Convert one EFI_IPv6_ADDRESS to Null-terminated Unicode string.\r
+ The text representation of address is defined in RFC 4291.\r
+\r
+ @param[in] Ip6Address The pointer to the IPv6 address.\r
+ @param[out] String The buffer to return the converted string.\r
+ @param[in] StringSize The length in bytes of the input String.\r
+\r
+ @retval EFI_SUCCESS Convert to string successfully.\r
+ @retval EFI_INVALID_PARAMETER The input parameter is invalid.\r
+ @retval EFI_BUFFER_TOO_SMALL The BufferSize is too small for the result. BufferSize has been\r
+ updated with the size needed to complete the request.\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+NetLibIp6ToStr (\r
+ IN EFI_IPv6_ADDRESS *Ip6Address,\r
+ OUT CHAR16 *String,\r
+ IN UINTN StringSize\r
+ );\r
+\r
//\r
// Various signatures\r
//\r
UINT32 Signature;\r
INTN RefCnt; // Reference count to share NET_VECTOR.\r
NET_VECTOR_EXT_FREE Free; // external function to free NET_VECTOR\r
- VOID *Arg; // opeque argument to Free\r
+ VOID *Arg; // opaque argument to Free\r
UINT32 Flag; // Flags, NET_VECTOR_OWN_FIRST\r
- UINT32 Len; // Total length of the assocated BLOCKs\r
+ UINT32 Len; // Total length of the associated BLOCKs\r
\r
UINT32 BlockNum;\r
NET_BLOCK Block[1];\r
(sizeof (NET_BUF) + ((BlockOpNum) - 1) * sizeof (NET_BLOCK_OP))\r
\r
#define NET_HEADSPACE(BlockOp) \\r
- (UINTN)((BlockOp)->Head - (BlockOp)->BlockHead)\r
+ ((UINTN)((BlockOp)->Head) - (UINTN)((BlockOp)->BlockHead))\r
\r
#define NET_TAILSPACE(BlockOp) \\r
- (UINTN)((BlockOp)->BlockTail - (BlockOp)->Tail)\r
+ ((UINTN)((BlockOp)->BlockTail) - (UINTN)((BlockOp)->Tail))\r
\r
/**\r
Allocate a single block NET_BUF. Upon allocation, all the\r
\r
@param[in, out] Nbuf The pointer to the net buffer.\r
@param[in] Len The length of the data to be trimmed.\r
- @param[in] FromHead The flag to indicate whether trim data is from the \r
+ @param[in] FromHead The flag to indicate whether trim data is from the\r
head (TRUE) or the tail (FALSE).\r
\r
@return The length of the actual trimmed data, which may be less\r
IN UINT8 NextHeader,\r
IN UINT32 Len\r
);\r
+\r
+/**\r
+ The function frees the net buffer which allocated by the IP protocol. It releases\r
+ only the net buffer and doesn't call the external free function.\r
+\r
+ This function should be called after finishing the process of mIpSec->ProcessExt()\r
+ for outbound traffic. The (EFI_IPSEC2_PROTOCOL)->ProcessExt() allocates a new\r
+ buffer for the ESP, so there needs a function to free the old net buffer.\r
+\r
+ @param[in] Nbuf The network buffer to be freed.\r
+\r
+**/\r
+VOID\r
+NetIpSecNetbufFree (\r
+ NET_BUF *Nbuf\r
+ );\r
+\r
+/**\r
+ This function obtains the system guid from the smbios table.\r
+\r
+ If SystemGuid is NULL, then ASSERT().\r
+\r
+ @param[out] SystemGuid The pointer of the returned system guid.\r
+\r
+ @retval EFI_SUCCESS Successfully obtained the system guid.\r
+ @retval EFI_NOT_FOUND Did not find the SMBIOS table.\r
+\r
+**/\r
+EFI_STATUS\r
+EFIAPI\r
+NetLibGetSystemGuid (\r
+ OUT EFI_GUID *SystemGuid\r
+ );\r
+\r
+/**\r
+ Create Dns QName according the queried domain name.\r
+\r
+ If DomainName is NULL, then ASSERT().\r
+\r
+ QName is a domain name represented as a sequence of labels,\r
+ where each label consists of a length octet followed by that\r
+ number of octets. The QName terminates with the zero\r
+ length octet for the null label of the root. Caller should\r
+ take responsibility to free the buffer in returned pointer.\r
+\r
+ @param DomainName The pointer to the queried domain name string.\r
+\r
+ @retval NULL Failed to fill QName.\r
+ @return QName filled successfully.\r
+\r
+**/\r
+CHAR8 *\r
+EFIAPI\r
+NetLibCreateDnsQName (\r
+ IN CHAR16 *DomainName\r
+ );\r
+\r
#endif\r