[mirror_edk2.git] / NetworkPkg / Ip6Dxe / Ip6If.c

/** @file\r
  Implement IP6 pseudo interface.\r
\r
  Copyright (c) 2009 - 2018, Intel Corporation. All rights reserved.<BR>\r
\r
  SPDX-License-Identifier: BSD-2-Clause-Patent\r
\r
**/\r
\r
#include "Ip6Impl.h"\r
\r
/**\r
  Request Ip6OnFrameSentDpc as a DPC at TPL_CALLBACK.\r
\r
  @param[in]  Event              The transmit token's event.\r
  @param[in]  Context            The Context which is pointed to the token.\r
\r
**/\r
VOID\r
EFIAPI\r
Ip6OnFrameSent (\r
  IN EFI_EVENT  Event,\r
  IN VOID       *Context\r
  );\r
\r
/**\r
  Fileter function to cancel all the frame related to an IP instance.\r
\r
  @param[in]  Frame             The transmit request to test whether to cancel.\r
  @param[in]  Context           The context which is the Ip instance that issued\r
                                the transmit.\r
\r
  @retval TRUE                  The frame belongs to this instance and is to be\r
                                removed.\r
  @retval FALSE                 The frame doesn't belong to this instance.\r
\r
**/\r
BOOLEAN\r
Ip6CancelInstanceFrame (\r
  IN IP6_LINK_TX_TOKEN  *Frame,\r
  IN VOID               *Context\r
  )\r
{\r
  if (Frame->IpInstance == (IP6_PROTOCOL *)Context) {\r
    return TRUE;\r
  }\r
\r
  return FALSE;\r
}\r
\r
/**\r
  Set the interface's address. This will trigger the DAD process for the\r
  address to set. To set an already set address, the lifetimes wil be\r
  updated to the new value passed in.\r
\r
  @param[in]  Interface             The interface to set the address.\r
  @param[in]  Ip6Addr               The interface's to be assigned IPv6 address.\r
  @param[in]  IsAnycast             If TRUE, the unicast IPv6 address is anycast.\r
                                    Otherwise, it is not anycast.\r
  @param[in]  PrefixLength          The prefix length of the Ip6Addr.\r
  @param[in]  ValidLifetime         The valid lifetime for this address.\r
  @param[in]  PreferredLifetime     The preferred lifetime for this address.\r
  @param[in]  DadCallback           The caller's callback to trigger when DAD finishes.\r
                                    This is an optional parameter that may be NULL.\r
  @param[in]  Context               The context that will be passed to DadCallback.\r
                                    This is an optional parameter that may be NULL.\r
\r
  @retval EFI_SUCCESS               The interface is scheduled to be configured with\r
                                    the specified address.\r
  @retval EFI_OUT_OF_RESOURCES      Failed to set the interface's address due to\r
                                    lack of resources.\r
\r
**/\r
EFI_STATUS\r
Ip6SetAddress (\r
  IN IP6_INTERFACE     *Interface,\r
  IN EFI_IPv6_ADDRESS  *Ip6Addr,\r
  IN BOOLEAN           IsAnycast,\r
  IN UINT8             PrefixLength,\r
  IN UINT32            ValidLifetime,\r
  IN UINT32            PreferredLifetime,\r
  IN IP6_DAD_CALLBACK  DadCallback  OPTIONAL,\r
  IN VOID              *Context     OPTIONAL\r
  )\r
{\r
  IP6_SERVICE            *IpSb;\r
  IP6_ADDRESS_INFO       *AddressInfo;\r
  LIST_ENTRY             *Entry;\r
  IP6_PREFIX_LIST_ENTRY  *PrefixEntry;\r
  UINT64                 Delay;\r
  IP6_DELAY_JOIN_LIST    *DelayNode;\r
\r
  NET_CHECK_SIGNATURE (Interface, IP6_INTERFACE_SIGNATURE);\r
\r
  IpSb = Interface->Service;\r
\r
  if (Ip6IsOneOfSetAddress (IpSb, Ip6Addr, NULL, &AddressInfo)) {\r
    ASSERT (AddressInfo != NULL);\r
    //\r
    // Update the lifetime.\r
    //\r
    AddressInfo->ValidLifetime     = ValidLifetime;\r
    AddressInfo->PreferredLifetime = PreferredLifetime;\r
\r
    if (DadCallback != NULL) {\r
      DadCallback (TRUE, Ip6Addr, Context);\r
    }\r
\r
    return EFI_SUCCESS;\r
  }\r
\r
  AddressInfo = (IP6_ADDRESS_INFO *)AllocatePool (sizeof (IP6_ADDRESS_INFO));\r
  if (AddressInfo == NULL) {\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  AddressInfo->Signature = IP6_ADDR_INFO_SIGNATURE;\r
  IP6_COPY_ADDRESS (&AddressInfo->Address, Ip6Addr);\r
  AddressInfo->IsAnycast         = IsAnycast;\r
  AddressInfo->PrefixLength      = PrefixLength;\r
  AddressInfo->ValidLifetime     = ValidLifetime;\r
  AddressInfo->PreferredLifetime = PreferredLifetime;\r
\r
  if (AddressInfo->PrefixLength == 0) {\r
    //\r
    // Find an appropriate prefix from on-link prefixes and update the prefixlength.\r
    // Longest prefix match is used here.\r
    //\r
    NET_LIST_FOR_EACH (Entry, &IpSb->OnlinkPrefix) {\r
      PrefixEntry = NET_LIST_USER_STRUCT (Entry, IP6_PREFIX_LIST_ENTRY, Link);\r
\r
      if (NetIp6IsNetEqual (&PrefixEntry->Prefix, &AddressInfo->Address, PrefixEntry->PrefixLength)) {\r
        AddressInfo->PrefixLength = PrefixEntry->PrefixLength;\r
        break;\r
      }\r
    }\r
  }\r
\r
  if (AddressInfo->PrefixLength == 0) {\r
    //\r
    // If the prefix length is still zero, try the autonomous prefixes.\r
    // Longest prefix match is used here.\r
    //\r
    NET_LIST_FOR_EACH (Entry, &IpSb->AutonomousPrefix) {\r
      PrefixEntry = NET_LIST_USER_STRUCT (Entry, IP6_PREFIX_LIST_ENTRY, Link);\r
\r
      if (NetIp6IsNetEqual (&PrefixEntry->Prefix, &AddressInfo->Address, PrefixEntry->PrefixLength)) {\r
        AddressInfo->PrefixLength = PrefixEntry->PrefixLength;\r
        break;\r
      }\r
    }\r
  }\r
\r
  if (AddressInfo->PrefixLength == 0) {\r
    //\r
    // BUGBUG: Stil fail, use 64 as the default prefix length.\r
    //\r
    AddressInfo->PrefixLength = IP6_LINK_LOCAL_PREFIX_LENGTH;\r
  }\r
\r
  //\r
  // Node should delay joining the solicited-node multicast address by a random delay\r
  // between 0 and MAX_RTR_SOLICITATION_DELAY (1 second).\r
  // Thus queue the address to be processed in Duplicate Address Detection module\r
  // after the delay time (in milliseconds).\r
  //\r
  Delay = (UINT64)NET_RANDOM (NetRandomInitSeed ());\r
  Delay = MultU64x32 (Delay, IP6_ONE_SECOND_IN_MS);\r
  Delay = RShiftU64 (Delay, 32);\r
\r
  DelayNode = (IP6_DELAY_JOIN_LIST *)AllocatePool (sizeof (IP6_DELAY_JOIN_LIST));\r
  if (DelayNode == NULL) {\r
    FreePool (AddressInfo);\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  DelayNode->DelayTime   = (UINT32)(DivU64x32 (Delay, IP6_TIMER_INTERVAL_IN_MS));\r
  DelayNode->Interface   = Interface;\r
  DelayNode->AddressInfo = AddressInfo;\r
  DelayNode->DadCallback = DadCallback;\r
  DelayNode->Context     = Context;\r
\r
  InsertTailList (&Interface->DelayJoinList, &DelayNode->Link);\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Create an IP6_INTERFACE.\r
\r
  @param[in]  IpSb                  The IP6 service binding instance.\r
  @param[in]  LinkLocal             If TRUE, the instance is created for link-local address.\r
                                    Otherwise, it is not for a link-local address.\r
\r
  @return Point to the created IP6_INTERFACE, otherwise NULL.\r
\r
**/\r
IP6_INTERFACE *\r
Ip6CreateInterface (\r
  IN IP6_SERVICE  *IpSb,\r
  IN BOOLEAN      LinkLocal\r
  )\r
{\r
  EFI_STATUS        Status;\r
  IP6_INTERFACE     *Interface;\r
  EFI_IPv6_ADDRESS  *Ip6Addr;\r
\r
  NET_CHECK_SIGNATURE (IpSb, IP6_SERVICE_SIGNATURE);\r
\r
  Interface = AllocatePool (sizeof (IP6_INTERFACE));\r
  if (Interface == NULL) {\r
    return NULL;\r
  }\r
\r
  Interface->Signature = IP6_INTERFACE_SIGNATURE;\r
  Interface->RefCnt    = 1;\r
\r
  InitializeListHead (&Interface->AddressList);\r
  Interface->AddressCount = 0;\r
  Interface->Configured   = FALSE;\r
\r
  Interface->Service    = IpSb;\r
  Interface->Controller = IpSb->Controller;\r
  Interface->Image      = IpSb->Image;\r
\r
  InitializeListHead (&Interface->ArpQues);\r
  InitializeListHead (&Interface->SentFrames);\r
\r
  Interface->DupAddrDetect = IpSb->Ip6ConfigInstance.DadXmits.DupAddrDetectTransmits;\r
  InitializeListHead (&Interface->DupAddrDetectList);\r
\r
  InitializeListHead (&Interface->DelayJoinList);\r
\r
  InitializeListHead (&Interface->IpInstances);\r
  Interface->PromiscRecv = FALSE;\r
\r
  if (!LinkLocal) {\r
    return Interface;\r
  }\r
\r
  //\r
  // Get the link local addr\r
  //\r
  Ip6Addr = Ip6CreateLinkLocalAddr (IpSb);\r
  if (Ip6Addr == NULL) {\r
    goto ON_ERROR;\r
  }\r
\r
  //\r
  // Perform DAD - Duplicate Address Detection.\r
  //\r
  Status = Ip6SetAddress (\r
             Interface,\r
             Ip6Addr,\r
             FALSE,\r
             IP6_LINK_LOCAL_PREFIX_LENGTH,\r
             (UINT32)IP6_INFINIT_LIFETIME,\r
             (UINT32)IP6_INFINIT_LIFETIME,\r
             NULL,\r
             NULL\r
             );\r
\r
  FreePool (Ip6Addr);\r
\r
  if (EFI_ERROR (Status)) {\r
    goto ON_ERROR;\r
  }\r
\r
  return Interface;\r
\r
ON_ERROR:\r
\r
  FreePool (Interface);\r
  return NULL;\r
}\r
\r
/**\r
  Free the interface used by IpInstance. All the IP instance with\r
  the same Ip/prefix pair share the same interface. It is reference\r
  counted. All the frames that haven't been sent will be cancelled.\r
  Because the IpInstance is optional, the caller must remove\r
  IpInstance from the interface's instance list.\r
\r
  @param[in]  Interface         The interface used by the IpInstance.\r
  @param[in]  IpInstance        The IP instance that free the interface. NULL if\r
                                the IP driver is releasing the default interface.\r
\r
**/\r
VOID\r
Ip6CleanInterface (\r
  IN  IP6_INTERFACE  *Interface,\r
  IN  IP6_PROTOCOL   *IpInstance           OPTIONAL\r
  )\r
{\r
  IP6_DAD_ENTRY        *Duplicate;\r
  IP6_DELAY_JOIN_LIST  *Delay;\r
\r
  NET_CHECK_SIGNATURE (Interface, IP6_INTERFACE_SIGNATURE);\r
  ASSERT (Interface->RefCnt > 0);\r
\r
  //\r
  // Remove all the pending transmit token related to this IP instance.\r
  //\r
  Ip6CancelFrames (Interface, EFI_ABORTED, Ip6CancelInstanceFrame, IpInstance);\r
\r
  if (--Interface->RefCnt > 0) {\r
    return;\r
  }\r
\r
  //\r
  // Destroy the interface if this is the last IP instance.\r
  // Remove all the system transmitted packets\r
  // from this interface, cancel the receive request if exists.\r
  //\r
  Ip6CancelFrames (Interface, EFI_ABORTED, Ip6CancelInstanceFrame, NULL);\r
\r
  ASSERT (IsListEmpty (&Interface->IpInstances));\r
  ASSERT (IsListEmpty (&Interface->ArpQues));\r
  ASSERT (IsListEmpty (&Interface->SentFrames));\r
\r
  while (!IsListEmpty (&Interface->DupAddrDetectList)) {\r
    Duplicate = NET_LIST_HEAD (&Interface->DupAddrDetectList, IP6_DAD_ENTRY, Link);\r
    NetListRemoveHead (&Interface->DupAddrDetectList);\r
    FreePool (Duplicate);\r
  }\r
\r
  while (!IsListEmpty (&Interface->DelayJoinList)) {\r
    Delay = NET_LIST_HEAD (&Interface->DelayJoinList, IP6_DELAY_JOIN_LIST, Link);\r
    NetListRemoveHead (&Interface->DelayJoinList);\r
    FreePool (Delay);\r
  }\r
\r
  Ip6RemoveAddr (Interface->Service, &Interface->AddressList, &Interface->AddressCount, NULL, 0);\r
\r
  RemoveEntryList (&Interface->Link);\r
  FreePool (Interface);\r
}\r
\r
/**\r
  Create and wrap a transmit request into a newly allocated IP6_LINK_TX_TOKEN.\r
\r
  @param[in]  Interface         The interface to send out from.\r
  @param[in]  IpInstance        The IpInstance that transmit the packet.  NULL if\r
                                the packet is sent by the IP6 driver itself.\r
  @param[in]  Packet            The packet to transmit\r
  @param[in]  CallBack          Call back function to execute if transmission\r
                                finished.\r
  @param[in]  Context           Opaque parameter to the callback.\r
\r
  @return The wrapped token if succeed or NULL.\r
\r
**/\r
IP6_LINK_TX_TOKEN *\r
Ip6CreateLinkTxToken (\r
  IN IP6_INTERFACE       *Interface,\r
  IN IP6_PROTOCOL        *IpInstance    OPTIONAL,\r
  IN NET_BUF             *Packet,\r
  IN IP6_FRAME_CALLBACK  CallBack,\r
  IN VOID                *Context\r
  )\r
{\r
  EFI_MANAGED_NETWORK_COMPLETION_TOKEN  *MnpToken;\r
  EFI_MANAGED_NETWORK_TRANSMIT_DATA     *MnpTxData;\r
  IP6_LINK_TX_TOKEN                     *Token;\r
  EFI_STATUS                            Status;\r
  UINT32                                Count;\r
\r
  Token = AllocatePool (sizeof (IP6_LINK_TX_TOKEN) + (Packet->BlockOpNum - 1) * sizeof (EFI_MANAGED_NETWORK_FRAGMENT_DATA));\r
\r
  if (Token == NULL) {\r
    return NULL;\r
  }\r
\r
  Token->Signature = IP6_LINK_TX_SIGNATURE;\r
  InitializeListHead (&Token->Link);\r
\r
  Token->IpInstance = IpInstance;\r
  Token->CallBack   = CallBack;\r
  Token->Packet     = Packet;\r
  Token->Context    = Context;\r
  ZeroMem (&Token->DstMac, sizeof (EFI_MAC_ADDRESS));\r
  IP6_COPY_LINK_ADDRESS (&Token->SrcMac, &Interface->Service->SnpMode.CurrentAddress);\r
\r
  MnpToken         = &(Token->MnpToken);\r
  MnpToken->Status = EFI_NOT_READY;\r
\r
  Status = gBS->CreateEvent (\r
                  EVT_NOTIFY_SIGNAL,\r
                  TPL_NOTIFY,\r
                  Ip6OnFrameSent,\r
                  Token,\r
                  &MnpToken->Event\r
                  );\r
\r
  if (EFI_ERROR (Status)) {\r
    FreePool (Token);\r
    return NULL;\r
  }\r
\r
  MnpTxData               = &Token->MnpTxData;\r
  MnpToken->Packet.TxData = MnpTxData;\r
\r
  MnpTxData->DestinationAddress = &Token->DstMac;\r
  MnpTxData->SourceAddress      = &Token->SrcMac;\r
  MnpTxData->ProtocolType       = IP6_ETHER_PROTO;\r
  MnpTxData->DataLength         = Packet->TotalSize;\r
  MnpTxData->HeaderLength       = 0;\r
\r
  Count = Packet->BlockOpNum;\r
\r
  NetbufBuildExt (Packet, (NET_FRAGMENT *)MnpTxData->FragmentTable, &Count);\r
  MnpTxData->FragmentCount = (UINT16)Count;\r
\r
  return Token;\r
}\r
\r
/**\r
  Free the link layer transmit token. It will close the event,\r
  then free the memory used.\r
\r
  @param[in]  Token                 Token to free.\r
\r
**/\r
VOID\r
Ip6FreeLinkTxToken (\r
  IN IP6_LINK_TX_TOKEN  *Token\r
  )\r
{\r
  NET_CHECK_SIGNATURE (Token, IP6_LINK_TX_SIGNATURE);\r
\r
  gBS->CloseEvent (Token->MnpToken.Event);\r
  FreePool (Token);\r
}\r
\r
/**\r
  Callback function when the received packet is freed.\r
  Check Ip6OnFrameReceived for information.\r
\r
  @param[in]  Context       Points to EFI_MANAGED_NETWORK_RECEIVE_DATA.\r
\r
**/\r
VOID\r
EFIAPI\r
Ip6RecycleFrame (\r
  IN VOID  *Context\r
  )\r
{\r
  EFI_MANAGED_NETWORK_RECEIVE_DATA  *RxData;\r
\r
  RxData = (EFI_MANAGED_NETWORK_RECEIVE_DATA *)Context;\r
\r
  gBS->SignalEvent (RxData->RecycleEvent);\r
}\r
\r
/**\r
  Received a frame from MNP. Wrap it in net buffer then deliver\r
  it to IP's input function. The ownship of the packet also\r
  is transferred to IP. When Ip is finished with this packet, it\r
  will call NetbufFree to release the packet, NetbufFree will\r
  again call the Ip6RecycleFrame to signal MNP's event and free\r
  the token used.\r
\r
  @param[in]  Context         Context for the callback.\r
\r
**/\r
VOID\r
EFIAPI\r
Ip6OnFrameReceivedDpc (\r
  IN VOID  *Context\r
  )\r
{\r
  EFI_MANAGED_NETWORK_COMPLETION_TOKEN  *MnpToken;\r
  EFI_MANAGED_NETWORK_RECEIVE_DATA      *MnpRxData;\r
  IP6_LINK_RX_TOKEN                     *Token;\r
  NET_FRAGMENT                          Netfrag;\r
  NET_BUF                               *Packet;\r
  UINT32                                Flag;\r
  IP6_SERVICE                           *IpSb;\r
\r
  Token = (IP6_LINK_RX_TOKEN *)Context;\r
  NET_CHECK_SIGNATURE (Token, IP6_LINK_RX_SIGNATURE);\r
\r
  //\r
  // First clear the interface's receive request in case the\r
  // caller wants to call Ip6ReceiveFrame in the callback.\r
  //\r
  IpSb = (IP6_SERVICE *)Token->Context;\r
  NET_CHECK_SIGNATURE (IpSb, IP6_SERVICE_SIGNATURE);\r
\r
  MnpToken  = &Token->MnpToken;\r
  MnpRxData = MnpToken->Packet.RxData;\r
\r
  if (EFI_ERROR (MnpToken->Status) || (MnpRxData == NULL)) {\r
    Token->CallBack (NULL, MnpToken->Status, 0, Token->Context);\r
    return;\r
  }\r
\r
  //\r
  // Wrap the frame in a net buffer then deliver it to IP input.\r
  // IP will reassemble the packet, and deliver it to upper layer\r
  //\r
  Netfrag.Len  = MnpRxData->DataLength;\r
  Netfrag.Bulk = MnpRxData->PacketData;\r
\r
  Packet = NetbufFromExt (&Netfrag, 1, IP6_MAX_HEADLEN, 0, Ip6RecycleFrame, Token->MnpToken.Packet.RxData);\r
\r
  if (Packet == NULL) {\r
    gBS->SignalEvent (MnpRxData->RecycleEvent);\r
\r
    Token->CallBack (NULL, EFI_OUT_OF_RESOURCES, 0, Token->Context);\r
\r
    return;\r
  }\r
\r
  Flag  = (MnpRxData->BroadcastFlag ? IP6_LINK_BROADCAST : 0);\r
  Flag |= (MnpRxData->MulticastFlag ? IP6_LINK_MULTICAST : 0);\r
  Flag |= (MnpRxData->PromiscuousFlag ? IP6_LINK_PROMISC : 0);\r
\r
  Token->CallBack (Packet, EFI_SUCCESS, Flag, Token->Context);\r
}\r
\r
/**\r
  Request Ip6OnFrameReceivedDpc as a DPC at TPL_CALLBACK.\r
\r
  @param  Event                 The receive event delivered to MNP for receive.\r
  @param  Context               Context for the callback.\r
\r
**/\r
VOID\r
EFIAPI\r
Ip6OnFrameReceived (\r
  IN EFI_EVENT  Event,\r
  IN VOID       *Context\r
  )\r
{\r
  //\r
  // Request Ip6OnFrameReceivedDpc as a DPC at TPL_CALLBACK\r
  //\r
  QueueDpc (TPL_CALLBACK, Ip6OnFrameReceivedDpc, Context);\r
}\r
\r
/**\r
  Request to receive the packet from the interface.\r
\r
  @param[in]  CallBack          Function to call when receive finished.\r
  @param[in]  IpSb              Points to IP6 service binding instance.\r
\r
  @retval EFI_ALREADY_STARTED   There is already a pending receive request.\r
  @retval EFI_OUT_OF_RESOURCES  Failed to allocate resource to receive.\r
  @retval EFI_SUCCESS           The receive request has been started.\r
\r
**/\r
EFI_STATUS\r
Ip6ReceiveFrame (\r
  IN  IP6_FRAME_CALLBACK  CallBack,\r
  IN  IP6_SERVICE         *IpSb\r
  )\r
{\r
  EFI_STATUS         Status;\r
  IP6_LINK_RX_TOKEN  *Token;\r
\r
  NET_CHECK_SIGNATURE (IpSb, IP6_SERVICE_SIGNATURE);\r
\r
  Token           = &IpSb->RecvRequest;\r
  Token->CallBack = CallBack;\r
  Token->Context  = (VOID *)IpSb;\r
\r
  Status = IpSb->Mnp->Receive (IpSb->Mnp, &Token->MnpToken);\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
/**\r
  Callback function when frame transmission is finished. It will\r
  call the frame owner's callback function to tell it the result.\r
\r
  @param[in]  Context        Context which points to the token.\r
\r
**/\r
VOID\r
EFIAPI\r
Ip6OnFrameSentDpc (\r
  IN VOID  *Context\r
  )\r
{\r
  IP6_LINK_TX_TOKEN  *Token;\r
\r
  Token = (IP6_LINK_TX_TOKEN *)Context;\r
  NET_CHECK_SIGNATURE (Token, IP6_LINK_TX_SIGNATURE);\r
\r
  RemoveEntryList (&Token->Link);\r
\r
  Token->CallBack (\r
           Token->Packet,\r
           Token->MnpToken.Status,\r
           0,\r
           Token->Context\r
           );\r
\r
  Ip6FreeLinkTxToken (Token);\r
}\r
\r
/**\r
  Request Ip6OnFrameSentDpc as a DPC at TPL_CALLBACK.\r
\r
  @param[in]  Event                 The transmit token's event.\r
  @param[in]  Context               Context which points to the token.\r
\r
**/\r
VOID\r
EFIAPI\r
Ip6OnFrameSent (\r
  IN EFI_EVENT  Event,\r
  IN VOID       *Context\r
  )\r
{\r
  //\r
  // Request Ip6OnFrameSentDpc as a DPC at TPL_CALLBACK\r
  //\r
  QueueDpc (TPL_CALLBACK, Ip6OnFrameSentDpc, Context);\r
}\r
\r
/**\r
  Send a frame from the interface. If the next hop is a multicast address,\r
  it is transmitted immediately. If the next hop is a unicast,\r
  and the NextHop's MAC is not known, it will perform address resolution.\r
  If an error occurred, the CallBack won't be called. So, the caller\r
  must test the return value, and take action when there is an error.\r
\r
  @param[in]  Interface         The interface to send the frame from\r
  @param[in]  IpInstance        The IP child that request the transmission.\r
                                NULL if it is the IP6 driver itself.\r
  @param[in]  Packet            The packet to transmit.\r
  @param[in]  NextHop           The immediate destination to transmit the packet to.\r
  @param[in]  CallBack          Function to call back when transmit finished.\r
  @param[in]  Context           Opaque parameter to the callback.\r
\r
  @retval EFI_OUT_OF_RESOURCES  Failed to allocate resource to send the frame.\r
  @retval EFI_NO_MAPPING        Can't resolve the MAC for the nexthop.\r
  @retval EFI_SUCCESS           The packet successfully transmitted.\r
\r
**/\r
EFI_STATUS\r
Ip6SendFrame (\r
  IN  IP6_INTERFACE       *Interface,\r
  IN  IP6_PROTOCOL        *IpInstance      OPTIONAL,\r
  IN  NET_BUF             *Packet,\r
  IN  EFI_IPv6_ADDRESS    *NextHop,\r
  IN  IP6_FRAME_CALLBACK  CallBack,\r
  IN  VOID                *Context\r
  )\r
{\r
  IP6_SERVICE         *IpSb;\r
  IP6_LINK_TX_TOKEN   *Token;\r
  EFI_STATUS          Status;\r
  IP6_NEIGHBOR_ENTRY  *NeighborCache;\r
  LIST_ENTRY          *Entry;\r
  IP6_NEIGHBOR_ENTRY  *ArpQue;\r
\r
  IpSb = Interface->Service;\r
  NET_CHECK_SIGNATURE (IpSb, IP6_SERVICE_SIGNATURE);\r
\r
  //\r
  // Only when link local address is performing DAD, the interface could be used in unconfigured.\r
  //\r
  if (IpSb->LinkLocalOk) {\r
    ASSERT (Interface->Configured);\r
  }\r
\r
  Token = Ip6CreateLinkTxToken (Interface, IpInstance, Packet, CallBack, Context);\r
\r
  if (Token == NULL) {\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  if (IP6_IS_MULTICAST (NextHop)) {\r
    Status = Ip6GetMulticastMac (IpSb->Mnp, NextHop, &Token->DstMac);\r
    if (EFI_ERROR (Status)) {\r
      goto Error;\r
    }\r
\r
    goto SendNow;\r
  }\r
\r
  //\r
  // If send to itself, directly send out\r
  //\r
  if (EFI_IP6_EQUAL (&Packet->Ip.Ip6->DestinationAddress, &Packet->Ip.Ip6->SourceAddress)) {\r
    IP6_COPY_LINK_ADDRESS (&Token->DstMac, &IpSb->SnpMode.CurrentAddress);\r
    goto SendNow;\r
  }\r
\r
  //\r
  // If unicast, check the neighbor state.\r
  //\r
\r
  NeighborCache = Ip6FindNeighborEntry (IpSb, NextHop);\r
  ASSERT (NeighborCache != NULL);\r
\r
  if (NeighborCache->Interface == NULL) {\r
    NeighborCache->Interface = Interface;\r
  }\r
\r
  switch (NeighborCache->State) {\r
    case EfiNeighborStale:\r
      NeighborCache->State = EfiNeighborDelay;\r
      NeighborCache->Ticks = (UINT32)IP6_GET_TICKS (IP6_DELAY_FIRST_PROBE_TIME);\r
    //\r
    // Fall through\r
    //\r
    case EfiNeighborReachable:\r
    case EfiNeighborDelay:\r
    case EfiNeighborProbe:\r
      IP6_COPY_LINK_ADDRESS (&Token->DstMac, &NeighborCache->LinkAddress);\r
      goto SendNow;\r
      break;\r
\r
    default:\r
      break;\r
  }\r
\r
  //\r
  // Have to do asynchronous ARP resolution. First check whether there is\r
  // already a pending request.\r
  //\r
  NET_LIST_FOR_EACH (Entry, &Interface->ArpQues) {\r
    ArpQue = NET_LIST_USER_STRUCT (Entry, IP6_NEIGHBOR_ENTRY, ArpList);\r
    if (ArpQue == NeighborCache) {\r
      InsertTailList (&NeighborCache->Frames, &Token->Link);\r
      NeighborCache->ArpFree = TRUE;\r
      return EFI_SUCCESS;\r
    }\r
  }\r
\r
  //\r
  // First frame requires ARP.\r
  //\r
  InsertTailList (&NeighborCache->Frames, &Token->Link);\r
  InsertTailList (&Interface->ArpQues, &NeighborCache->ArpList);\r
\r
  NeighborCache->ArpFree = TRUE;\r
\r
  return EFI_SUCCESS;\r
\r
SendNow:\r
  //\r
  // Insert the tx token into the SentFrames list before calling Mnp->Transmit.\r
  // Remove it if the returned status is not EFI_SUCCESS.\r
  //\r
  InsertTailList (&Interface->SentFrames, &Token->Link);\r
  Status = IpSb->Mnp->Transmit (IpSb->Mnp, &Token->MnpToken);\r
  if (EFI_ERROR (Status)) {\r
    RemoveEntryList (&Token->Link);\r
    goto Error;\r
  }\r
\r
  return EFI_SUCCESS;\r
\r
Error:\r
  Ip6FreeLinkTxToken (Token);\r
  return Status;\r
}\r
\r
/**\r
  The heartbeat timer of IP6 service instance. It times out\r
  all of its IP6 children's received-but-not-delivered and\r
  transmitted-but-not-recycle packets.\r
\r
  @param[in]  Event                 The IP6 service instance's heartbeat timer.\r
  @param[in]  Context               The IP6 service instance.\r
\r
**/\r
VOID\r
EFIAPI\r
Ip6TimerTicking (\r
  IN EFI_EVENT  Event,\r
  IN VOID       *Context\r
  )\r
{\r
  IP6_SERVICE  *IpSb;\r
\r
  IpSb = (IP6_SERVICE *)Context;\r
  NET_CHECK_SIGNATURE (IpSb, IP6_SERVICE_SIGNATURE);\r
\r
  Ip6PacketTimerTicking (IpSb);\r
  Ip6NdTimerTicking (IpSb);\r
  Ip6MldTimerTicking (IpSb);\r
}\r