Add comments for functions and fix some coding style issue.

[mirror_edk2.git] / MdeModulePkg / Universal / Network / Tcp4Dxe / Tcp4Driver.c

/** @file\r
\r
Copyright (c) 2005 - 2007, Intel Corporation\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\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
\r
Module Name:\r
\r
  Tcp4Driver.c\r
\r
Abstract:\r
\r
\r
**/\r
\r
#include "Tcp4Main.h"\r
\r
\r
UINT16                                mTcp4RandomPort;\r
extern EFI_COMPONENT_NAME_PROTOCOL    gTcp4ComponentName;\r
extern EFI_COMPONENT_NAME2_PROTOCOL   gTcp4ComponentName2;\r
\r
TCP4_HEARTBEAT_TIMER  mTcp4Timer = {\r
  NULL,\r
  0\r
};\r
\r
EFI_TCP4_PROTOCOL mTcp4ProtocolTemplate = {\r
  Tcp4GetModeData,\r
  Tcp4Configure,\r
  Tcp4Routes,\r
  Tcp4Connect,\r
  Tcp4Accept,\r
  Tcp4Transmit,\r
  Tcp4Receive,\r
  Tcp4Close,\r
  Tcp4Cancel,\r
  Tcp4Poll\r
};\r
\r
SOCK_INIT_DATA mTcp4DefaultSockData = {\r
  SOCK_STREAM,\r
  (SOCK_STATE) 0,\r
  NULL,\r
  TCP_BACKLOG,\r
  TCP_SND_BUF_SIZE,\r
  TCP_RCV_BUF_SIZE,\r
  &mTcp4ProtocolTemplate,\r
  Tcp4CreateSocketCallback,\r
  Tcp4DestroySocketCallback,\r
  NULL,\r
  NULL,\r
  0,\r
  Tcp4Dispatcher,\r
  NULL,\r
};\r
\r
EFI_DRIVER_BINDING_PROTOCOL mTcp4DriverBinding = {\r
  Tcp4DriverBindingSupported,\r
  Tcp4DriverBindingStart,\r
  Tcp4DriverBindingStop,\r
  0xa,\r
  NULL,\r
  NULL\r
};\r
\r
EFI_SERVICE_BINDING_PROTOCOL mTcp4ServiceBinding = {\r
  Tcp4ServiceBindingCreateChild,\r
  Tcp4ServiceBindingDestroyChild\r
};\r
\r
\r
/**\r
  Create and start the heartbeat timer for TCP driver.\r
\r
  @retval EFI_SUCCESS            The timer is successfully created and started.\r
  @retval other                  The timer is not created.\r
\r
**/\r
EFI_STATUS\r
Tcp4CreateTimer (\r
  VOID\r
  )\r
{\r
  EFI_STATUS  Status;\r
\r
  Status = EFI_SUCCESS;\r
\r
  if (mTcp4Timer.RefCnt == 0) {\r
\r
    Status = gBS->CreateEvent (\r
                    EVT_TIMER | EVT_NOTIFY_SIGNAL,\r
                    TPL_NOTIFY,\r
                    TcpTicking,\r
                    NULL,\r
                    &mTcp4Timer.TimerEvent\r
                    );\r
    if (!EFI_ERROR (Status)) {\r
\r
      Status = gBS->SetTimer (\r
                      mTcp4Timer.TimerEvent,\r
                      TimerPeriodic,\r
                      (UINT64) (TICKS_PER_SECOND / TCP_TICK_HZ)\r
                      );\r
    }\r
  }\r
\r
  if (!EFI_ERROR (Status)) {\r
\r
    mTcp4Timer.RefCnt++;\r
  }\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Stop and destroy the heartbeat timer for TCP driver.\r
  \r
**/\r
VOID\r
Tcp4DestroyTimer (\r
  VOID\r
  )\r
{\r
  ASSERT (mTcp4Timer.RefCnt > 0);\r
\r
  mTcp4Timer.RefCnt--;\r
\r
  if (mTcp4Timer.RefCnt > 0) {\r
    return;\r
  }\r
\r
  gBS->SetTimer (mTcp4Timer.TimerEvent, TimerCancel, 0);\r
  gBS->CloseEvent (mTcp4Timer.TimerEvent);\r
  mTcp4Timer.TimerEvent = NULL;\r
}\r
\r
/**\r
  The entry point for Tcp4 driver, used to install Tcp4 driver on the ImageHandle.\r
\r
  @param  ImageHandle   The firmware allocated handle for this\r
                        driver image.\r
  @param  SystemTable   Pointer to the EFI system table.\r
\r
  @retval EFI_SUCCESS   Driver loaded.\r
  @retval other         Driver not loaded.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
Tcp4DriverEntryPoint (\r
  IN EFI_HANDLE        ImageHandle,\r
  IN EFI_SYSTEM_TABLE  *SystemTable\r
  )\r
{\r
  EFI_STATUS  Status;\r
  UINT32      Seed;\r
\r
  //\r
  // Install the TCP4 Driver Binding Protocol\r
  //\r
  Status = EfiLibInstallDriverBindingComponentName2 (\r
             ImageHandle,\r
             SystemTable,\r
             &mTcp4DriverBinding,\r
             ImageHandle,\r
             &gTcp4ComponentName,\r
             &gTcp4ComponentName2\r
             );\r
  ASSERT_EFI_ERROR (Status);\r
  //\r
  // Initialize ISS and random port.\r
  //\r
  Seed            = NetRandomInitSeed ();\r
  mTcpGlobalIss   = NET_RANDOM (Seed) % mTcpGlobalIss;\r
  mTcp4RandomPort = (UINT16) (TCP4_PORT_KNOWN +\r
                    (UINT16) (NET_RANDOM(Seed) % TCP4_PORT_KNOWN));\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Test to see if this driver supports ControllerHandle.\r
\r
  @param  This                   Protocol instance pointer.\r
  @param  ControllerHandle       Handle of device to test.\r
  @param  RemainingDevicePath    Optional parameter use to pick a specific child\r
                                 device to start.\r
\r
  @retval EFI_SUCCESS            This driver supports this device.\r
  @retval EFI_ALREADY_STARTED    This driver is already running on this device.\r
  @retval other                  This driver does not support this device.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
Tcp4DriverBindingSupported (\r
  IN EFI_DRIVER_BINDING_PROTOCOL  *This,\r
  IN EFI_HANDLE                   ControllerHandle,\r
  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath OPTIONAL\r
  )\r
{\r
  EFI_STATUS  Status;\r
\r
  //\r
  // Test for the Tcp4ServiceBinding Protocol\r
  //\r
  Status = gBS->OpenProtocol (\r
                  ControllerHandle,\r
                  &gEfiTcp4ServiceBindingProtocolGuid,\r
                  NULL,\r
                  This->DriverBindingHandle,\r
                  ControllerHandle,\r
                  EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
                  );\r
  if (!EFI_ERROR (Status)) {\r
    return EFI_ALREADY_STARTED;\r
  }\r
\r
  //\r
  // Test for the Ip4 Protocol\r
  //\r
  Status = gBS->OpenProtocol (\r
                  ControllerHandle,\r
                  &gEfiIp4ServiceBindingProtocolGuid,\r
                  NULL,\r
                  This->DriverBindingHandle,\r
                  ControllerHandle,\r
                  EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
                  );\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Start this driver on ControllerHandle.\r
\r
  @param  This                   Protocol instance pointer.\r
  @param  ControllerHandle       Handle of device to bind driver to.\r
  @param  RemainingDevicePath    Optional parameter use to pick a specific child\r
                                 device to start.\r
\r
  @retval EFI_SUCCESS            The driver is added to ControllerHandle.\r
  @retval EFI_OUT_OF_RESOURCES   There are not enough resources to start the\r
                                 driver.\r
  @retval other                  The driver cannot be added to ControllerHandle.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
Tcp4DriverBindingStart (\r
  IN EFI_DRIVER_BINDING_PROTOCOL  *This,\r
  IN EFI_HANDLE                   ControllerHandle,\r
  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath OPTIONAL\r
  )\r
{\r
  EFI_STATUS               Status;\r
  TCP4_SERVICE_DATA        *TcpServiceData;\r
  IP_IO_OPEN_DATA          OpenData;\r
\r
  TcpServiceData = AllocateZeroPool (sizeof (TCP4_SERVICE_DATA));\r
\r
  if (NULL == TcpServiceData) {\r
    DEBUG ((EFI_D_ERROR, "Tcp4DriverBindingStart: Have no enough"\r
      " resource to create a Tcp Servcie Data!\n"));\r
\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  //\r
  // Create a new IP IO to Consume it\r
  //\r
  TcpServiceData->IpIo = IpIoCreate (This->DriverBindingHandle, ControllerHandle);\r
  if (NULL == TcpServiceData->IpIo) {\r
\r
    DEBUG ((EFI_D_ERROR, "Tcp4DriverBindingStart: Have no enough"\r
      " resource to create an Ip Io!\n"));\r
\r
    Status = EFI_OUT_OF_RESOURCES;\r
    goto ON_ERROR;\r
  }\r
\r
  //\r
  // Configure and start IpIo.\r
  //\r
  ZeroMem (&OpenData, sizeof (IP_IO_OPEN_DATA));\r
\r
  CopyMem (&OpenData.IpConfigData, &mIpIoDefaultIpConfigData, sizeof (OpenData.IpConfigData));\r
  OpenData.IpConfigData.DefaultProtocol = EFI_IP_PROTO_TCP;\r
\r
  OpenData.PktRcvdNotify = Tcp4RxCallback;\r
  Status                 = IpIoOpen (TcpServiceData->IpIo, &OpenData);\r
\r
  if (EFI_ERROR (Status)) {\r
    goto ON_ERROR;\r
  }\r
\r
  //\r
  // Create the timer event used by TCP driver\r
  //\r
  Status = Tcp4CreateTimer ();\r
  if (EFI_ERROR (Status)) {\r
\r
    DEBUG ((EFI_D_ERROR, "Tcp4DriverBindingStart: Create TcpTimer"\r
      " Event failed with %r\n", Status));\r
\r
    goto ON_ERROR;\r
  }\r
\r
  //\r
  // Install the Tcp4ServiceBinding Protocol on the\r
  // controller handle\r
  //\r
  TcpServiceData->Tcp4ServiceBinding = mTcp4ServiceBinding;\r
\r
  Status = gBS->InstallMultipleProtocolInterfaces (\r
                  &ControllerHandle,\r
                  &gEfiTcp4ServiceBindingProtocolGuid,\r
                  &TcpServiceData->Tcp4ServiceBinding,\r
                  NULL\r
                  );\r
  if (EFI_ERROR (Status)) {\r
\r
    DEBUG ((EFI_D_ERROR, "Tcp4DriverBindingStart: Install Tcp4 Service Binding"\r
      " Protocol failed for %r\n", Status));\r
\r
    Tcp4DestroyTimer ();\r
    goto ON_ERROR;\r
  }\r
\r
  //\r
  // Initialize member in TcpServiceData\r
  //\r
  TcpServiceData->ControllerHandle    = ControllerHandle;\r
  TcpServiceData->Signature           = TCP4_DRIVER_SIGNATURE;\r
  TcpServiceData->DriverBindingHandle = This->DriverBindingHandle;\r
\r
  InitializeListHead (&TcpServiceData->SocketList);\r
\r
  TcpSetVariableData (TcpServiceData);\r
\r
  return EFI_SUCCESS;\r
\r
ON_ERROR:\r
\r
  if (TcpServiceData->IpIo != NULL) {\r
    IpIoDestroy (TcpServiceData->IpIo);\r
  }\r
\r
  gBS->FreePool (TcpServiceData);\r
\r
  return Status;\r
}\r
\r
\r
/**\r
  Stop this driver on ControllerHandle.\r
\r
  @param  This                   Protocol instance pointer.\r
  @param  ControllerHandle       Handle of device to stop driver on.\r
  @param  NumberOfChildren       Number of Handles in ChildHandleBuffer. If number\r
                                 of children is zero stop the entire bus driver.\r
  @param  ChildHandleBuffer      List of Child Handles to Stop.\r
\r
  @retval EFI_SUCCESS            This driver is removed from ControllerHandle.\r
  @retval other                  This driver is not removed from ControllerHandle.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
Tcp4DriverBindingStop (\r
  IN  EFI_DRIVER_BINDING_PROTOCOL  *This,\r
  IN  EFI_HANDLE                   ControllerHandle,\r
  IN  UINTN                        NumberOfChildren,\r
  IN  EFI_HANDLE                   *ChildHandleBuffer\r
  )\r
{\r
  EFI_STATUS                          Status;\r
  EFI_HANDLE                          NicHandle;\r
  EFI_SERVICE_BINDING_PROTOCOL        *ServiceBinding;\r
  TCP4_SERVICE_DATA                   *TcpServiceData;\r
  SOCKET                              *Sock;\r
\r
  // Find the NicHandle where Tcp4 ServiceBinding Protocol is installed.\r
  //\r
  NicHandle = NetLibGetNicHandle (ControllerHandle, &gEfiIp4ProtocolGuid);\r
  if (NicHandle == NULL) {\r
    return EFI_DEVICE_ERROR;\r
  }\r
\r
  //\r
  // Retrieve the TCP driver Data Structure\r
  //\r
  Status = gBS->OpenProtocol (\r
                  NicHandle,\r
                  &gEfiTcp4ServiceBindingProtocolGuid,\r
                  (VOID **) &ServiceBinding,\r
                  This->DriverBindingHandle,\r
                  ControllerHandle,\r
                  EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
                  );\r
  if (EFI_ERROR (Status)) {\r
\r
    DEBUG ((EFI_D_ERROR, "Tcp4DriverBindingStop: Locate Tcp4 Service "\r
      " Binding Protocol failed with %r\n", Status));\r
\r
    return EFI_DEVICE_ERROR;\r
  }\r
\r
  TcpServiceData = TCP4_FROM_THIS (ServiceBinding);\r
\r
  if (NumberOfChildren == 0) {\r
    //\r
    // Uninstall TCP servicebinding protocol\r
    //\r
    gBS->UninstallMultipleProtocolInterfaces (\r
           NicHandle,\r
           &gEfiTcp4ServiceBindingProtocolGuid,\r
           ServiceBinding,\r
           NULL\r
           );\r
\r
    //\r
    // Destroy the IpIO consumed by TCP driver\r
    //\r
    IpIoDestroy (TcpServiceData->IpIo);\r
\r
    //\r
    // Destroy the heartbeat timer.\r
    //\r
    Tcp4DestroyTimer ();\r
\r
    //\r
    // Clear the variable.\r
    //\r
    TcpClearVariableData (TcpServiceData);\r
\r
    //\r
    // Release the TCP service data\r
    //\r
    gBS->FreePool (TcpServiceData);\r
  } else {\r
\r
    while (!IsListEmpty (&TcpServiceData->SocketList)) {\r
      Sock = NET_LIST_HEAD (&TcpServiceData->SocketList, SOCKET, Link);\r
\r
      ServiceBinding->DestroyChild (ServiceBinding, Sock->SockHandle);\r
    }\r
  }\r
\r
  return Status;\r
}\r
\r
/**\r
  Open Ip4 and device path protocols for a created socket, and insert it in \r
  socket list.\r
  \r
  @param  This                Pointer to the socket just created\r
  @param  Context             Context of the socket\r
  \r
  @retval EFI_SUCCESS         This protocol is installed successfully.\r
  @retval other               Some error occured.\r
  \r
**/\r
EFI_STATUS\r
Tcp4CreateSocketCallback (\r
  IN SOCKET  *This,\r
  IN VOID    *Context\r
  )\r
{\r
  EFI_STATUS         Status;\r
  TCP4_SERVICE_DATA  *TcpServiceData;\r
  EFI_IP4_PROTOCOL   *Ip4;\r
\r
  TcpServiceData = ((TCP4_PROTO_DATA *) This->ProtoReserved)->TcpService;\r
\r
  //\r
  // Open the default Ip4 protocol of IP_IO BY_DRIVER.\r
  //\r
  Status = gBS->OpenProtocol (\r
                  TcpServiceData->IpIo->ChildHandle,\r
                  &gEfiIp4ProtocolGuid,\r
                  (VOID **) &Ip4,\r
                  TcpServiceData->DriverBindingHandle,\r
                  This->SockHandle,\r
                  EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER\r
                  );\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  //\r
  // Open the device path on the handle where service binding resides on.\r
  //\r
  Status = gBS->OpenProtocol (\r
                  TcpServiceData->ControllerHandle,\r
                  &gEfiDevicePathProtocolGuid,\r
                  (VOID **) &This->ParentDevicePath,\r
                  TcpServiceData->DriverBindingHandle,\r
                  This->SockHandle,\r
                  EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER\r
                  );\r
  if (EFI_ERROR (Status)) {\r
    gBS->CloseProtocol (\r
           TcpServiceData->IpIo->ChildHandle,\r
           &gEfiIp4ProtocolGuid,\r
           TcpServiceData->DriverBindingHandle,\r
           This->SockHandle\r
           );\r
  } else {\r
    //\r
    // Insert this socket into the SocketList.\r
    //\r
    InsertTailList (&TcpServiceData->SocketList, &This->Link);\r
  }\r
\r
  return Status;\r
}\r
\r
/**\r
  Close Ip4 and device path protocols for a socket, and remove it from socket list. \r
    \r
  @param  This                Pointer to the socket to be removed\r
  @param  Context             Context of the socket\r
  \r
**/\r
VOID\r
Tcp4DestroySocketCallback (\r
  IN SOCKET  *This,\r
  IN VOID    *Context\r
  )\r
{\r
  TCP4_SERVICE_DATA  *TcpServiceData;\r
\r
  TcpServiceData = ((TCP4_PROTO_DATA *) This->ProtoReserved)->TcpService;\r
\r
  //\r
  // Remove this node from the list.\r
  //\r
  RemoveEntryList (&This->Link);\r
\r
  //\r
  // Close the device path protocol\r
  //\r
  gBS->CloseProtocol (\r
         TcpServiceData->ControllerHandle,\r
         &gEfiDevicePathProtocolGuid,\r
         TcpServiceData->DriverBindingHandle,\r
         This->SockHandle\r
         );\r
\r
  //\r
  // Close the Ip4 protocol.\r
  //\r
  gBS->CloseProtocol (\r
         TcpServiceData->IpIo->ChildHandle,\r
         &gEfiIp4ProtocolGuid,\r
         TcpServiceData->DriverBindingHandle,\r
         This->SockHandle\r
         );\r
}\r
\r
/**\r
  Creates a child handle with a set of TCP4 services.\r
\r
  @param  This                   Protocol instance pointer.\r
  @param  ChildHandle            Pointer to the handle of the child to create.  If\r
                                 it is NULL, then a new handle is created. If it is\r
                                 not NULL, then the I/O services are added to the\r
                                 existing child handle.\r
\r
  @retval EFI_SUCCESS            The child handle is created.\r
  @retval EFI_INVALID_PARAMETER  One or more parameters are invalid.\r
  @retval EFI_OUT_OF_RESOURCES   There are not enough resources to create the\r
                                 child.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
Tcp4ServiceBindingCreateChild (\r
  IN EFI_SERVICE_BINDING_PROTOCOL  *This,\r
  IN EFI_HANDLE                    *ChildHandle\r
  )\r
{\r
  SOCKET            *Sock;\r
  TCP4_SERVICE_DATA *TcpServiceData;\r
  TCP4_PROTO_DATA   TcpProto;\r
  EFI_STATUS        Status;\r
  EFI_TPL           OldTpl;\r
\r
  if (NULL == This || NULL == ChildHandle) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  OldTpl              = gBS->RaiseTPL (TPL_CALLBACK);\r
  Status              = EFI_SUCCESS;\r
  TcpServiceData      = TCP4_FROM_THIS (This);\r
  TcpProto.TcpService = TcpServiceData;\r
  TcpProto.TcpPcb     = NULL;\r
\r
  //\r
  // Create a tcp instance with defualt Tcp default\r
  // sock init data and TcpProto\r
  //\r
  mTcp4DefaultSockData.ProtoData     = &TcpProto;\r
  mTcp4DefaultSockData.DataSize      = sizeof (TCP4_PROTO_DATA);\r
  mTcp4DefaultSockData.DriverBinding = TcpServiceData->DriverBindingHandle;\r
\r
  Sock = SockCreateChild (&mTcp4DefaultSockData);\r
  if (NULL == Sock) {\r
    DEBUG ((EFI_D_ERROR, "Tcp4DriverBindingCreateChild: "\r
      "No resource to create a Tcp Child\n"));\r
\r
    Status = EFI_OUT_OF_RESOURCES;\r
  } else {\r
    *ChildHandle = Sock->SockHandle;\r
  }\r
\r
  gBS->RestoreTPL (OldTpl);\r
  return Status;\r
}\r
\r
\r
/**\r
  Destroys a child handle with a set of UDP4 services.\r
\r
  @param  This                   Protocol instance pointer.\r
  @param  ChildHandle            Handle of the child to be destroyed.\r
\r
  @retval EFI_SUCCESS            The TCP4 services are removed from  the child\r
                                 handle.\r
  @retval EFI_INVALID_PARAMETER  One or more parameters are invalid.\r
  @retval other                  The child handle is not destroyed.\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
Tcp4ServiceBindingDestroyChild (\r
  IN EFI_SERVICE_BINDING_PROTOCOL  *This,\r
  IN EFI_HANDLE                    ChildHandle\r
  )\r
{\r
  EFI_STATUS         Status;\r
  EFI_TCP4_PROTOCOL  *Tcp4;\r
  SOCKET             *Sock;\r
  EFI_TPL            OldTpl;\r
\r
  if (NULL == This || NULL == ChildHandle) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  OldTpl = gBS->RaiseTPL (TPL_CALLBACK);\r
\r
  //\r
  // retrieve the Tcp4 protocol from ChildHandle\r
  //\r
  Status = gBS->OpenProtocol (\r
                  ChildHandle,\r
                  &gEfiTcp4ProtocolGuid,\r
                  (VOID **) &Tcp4,\r
                  mTcp4DriverBinding.DriverBindingHandle,\r
                  ChildHandle,\r
                  EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
                  );\r
  if (EFI_ERROR (Status)) {\r
    Status = EFI_UNSUPPORTED;\r
  } else {\r
    //\r
    // destroy this sock and related Tcp protocol control\r
    // block\r
    //\r
    Sock = SOCK_FROM_THIS (Tcp4);\r
\r
    SockDestroyChild (Sock);\r
  }\r
\r
  gBS->RestoreTPL (OldTpl);\r
  return Status;\r
}\r
\r