[mirror_edk2.git] / MdeModulePkg / Universal / Network / Dhcp4Dxe / Dhcp4Driver.c

/** @file\r
\r
Copyright (c) 2006 - 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
\r
Module Name:\r
\r
  Dhcp4Driver.c\r
\r
Abstract:\r
\r
\r
**/\r
\r
#include "Dhcp4Impl.h"\r
#include "Dhcp4Driver.h"\r
\r
EFI_DRIVER_BINDING_PROTOCOL gDhcp4DriverBinding = {\r
  Dhcp4DriverBindingSupported,\r
  Dhcp4DriverBindingStart,\r
  Dhcp4DriverBindingStop,\r
  0xa,\r
  NULL,\r
  NULL\r
};\r
\r
EFI_SERVICE_BINDING_PROTOCOL mDhcp4ServiceBindingTemplete = {\r
  Dhcp4ServiceBindingCreateChild,\r
  Dhcp4ServiceBindingDestroyChild\r
};\r
\r
\r
EFI_STATUS\r
EFIAPI\r
Dhcp4DriverEntryPoint (\r
  IN EFI_HANDLE             ImageHandle,\r
  IN EFI_SYSTEM_TABLE       *SystemTable\r
  )\r
/*++\r
\r
Routine Description:\r
\r
  Entry point of the DHCP driver to install various protocols.\r
\r
Arguments:\r
\r
  ImageHandle - The driver's image handle\r
  SystemTable - The system table\r
\r
Returns:\r
\r
  EFI_SUCCESS - All the related protocols are installed.\r
  Others      - Failed to install the protocols.\r
\r
--*/\r
{\r
  return EfiLibInstallDriverBindingComponentName2 (\r
           ImageHandle,\r
           SystemTable,\r
           &gDhcp4DriverBinding,\r
           ImageHandle,\r
           &gDhcp4ComponentName,\r
           &gDhcp4ComponentName2\r
           );\r
}\r
\r
\r
/**\r
  Test to see if DHCP driver supports the 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_SUCCES             This driver supports this device\r
  @retval other                  This driver does not support this device\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
Dhcp4DriverBindingSupported (\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
  Status = gBS->OpenProtocol (\r
                  ControllerHandle,\r
                  &gEfiUdp4ServiceBindingProtocolGuid,\r
                  NULL,\r
                  This->DriverBindingHandle,\r
                  ControllerHandle,\r
                  EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
                  );\r
\r
  return Status;\r
}\r
\r
\r
\r
/**\r
  Configure the default UDP child to receive all the DHCP traffics\r
  on this network interface.\r
\r
  @param  UdpIo                  The UDP IO port to configure\r
  @param  Context                The context to the function\r
\r
  @retval EFI_SUCCESS            The UDP IO port is successfully configured.\r
  @retval Others                 Failed to configure the UDP child.\r
\r
**/\r
EFI_STATUS\r
DhcpConfigUdpIo (\r
  IN UDP_IO_PORT            *UdpIo,\r
  IN VOID                   *Context\r
  )\r
{\r
  EFI_UDP4_CONFIG_DATA      UdpConfigData;\r
\r
  UdpConfigData.AcceptBroadcast           = TRUE;\r
  UdpConfigData.AcceptPromiscuous         = FALSE;\r
  UdpConfigData.AcceptAnyPort             = FALSE;\r
  UdpConfigData.AllowDuplicatePort        = TRUE;\r
  UdpConfigData.TypeOfService             = 0;\r
  UdpConfigData.TimeToLive                = 64;\r
  UdpConfigData.DoNotFragment             = FALSE;\r
  UdpConfigData.ReceiveTimeout            = 0;\r
  UdpConfigData.TransmitTimeout           = 0;\r
\r
  UdpConfigData.UseDefaultAddress         = FALSE;\r
  UdpConfigData.StationPort               = DHCP_CLIENT_PORT;\r
  UdpConfigData.RemotePort                = DHCP_SERVER_PORT;\r
\r
  NetZeroMem (&UdpConfigData.StationAddress, sizeof (EFI_IPv4_ADDRESS));\r
  NetZeroMem (&UdpConfigData.SubnetMask, sizeof (EFI_IPv4_ADDRESS));\r
  NetZeroMem (&UdpConfigData.RemoteAddress, sizeof (EFI_IPv4_ADDRESS));\r
\r
  return UdpIo->Udp->Configure (UdpIo->Udp, &UdpConfigData);;\r
}\r
\r
\r
\r
/**\r
  Destory the DHCP service. The Dhcp4 service may be partly initialized,\r
  or partly destoried. If a resource is destoried, it is marked as so in\r
  case the destory failed and being called again later.\r
\r
  @param  DhcpSb                 The DHCP service instance to destory.\r
\r
  @retval EFI_SUCCESS            The DHCP service is successfully closed.\r
\r
**/\r
EFI_STATUS\r
Dhcp4CloseService (\r
  IN DHCP_SERVICE           *DhcpSb\r
  )\r
{\r
  DhcpCleanLease (DhcpSb);\r
\r
  if (DhcpSb->UdpIo != NULL) {\r
    UdpIoFreePort (DhcpSb->UdpIo);\r
    DhcpSb->UdpIo = NULL;\r
  }\r
\r
  if (DhcpSb->Timer != NULL) {\r
    gBS->SetTimer (DhcpSb->Timer, TimerCancel, 0);\r
    gBS->CloseEvent (DhcpSb->Timer);\r
\r
    DhcpSb->Timer = NULL;\r
  }\r
\r
  return EFI_SUCCESS;\r
}\r
\r
\r
\r
/**\r
  Create a new DHCP service binding instance for the controller.\r
\r
  @param  Controller             The controller to install DHCP service binding\r
                                 protocol onto\r
  @param  ImageHandle            The driver's image handle\r
  @param  Service                The variable to receive the created DHCP service\r
                                 instance.\r
\r
  @retval EFI_OUT_OF_RESOURCES   Failed to allocate resource .\r
  @retval EFI_SUCCESS            The DHCP service instance is created.\r
\r
**/\r
EFI_STATUS\r
Dhcp4CreateService (\r
  IN  EFI_HANDLE            Controller,\r
  IN  EFI_HANDLE            ImageHandle,\r
  OUT DHCP_SERVICE          **Service\r
  )\r
{\r
  DHCP_SERVICE              *DhcpSb;\r
  EFI_STATUS                Status;\r
\r
  *Service  = NULL;\r
  DhcpSb    = NetAllocateZeroPool (sizeof (DHCP_SERVICE));\r
\r
  if (DhcpSb == NULL) {\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  DhcpSb->Signature       = DHCP_SERVICE_SIGNATURE;\r
  DhcpSb->ServiceBinding  = mDhcp4ServiceBindingTemplete;\r
  DhcpSb->ServiceState    = DHCP_UNCONFIGED;\r
  DhcpSb->InDestory       = FALSE;\r
  DhcpSb->Controller      = Controller;\r
  DhcpSb->Image           = ImageHandle;\r
  NetListInit (&DhcpSb->Children);\r
  DhcpSb->DhcpState       = Dhcp4Stopped;\r
  DhcpSb->Xid             = NET_RANDOM (NetRandomInitSeed ());\r
\r
  //\r
  // Create various resources, UdpIo, Timer, and get Mac address\r
  //\r
  Status = gBS->CreateEvent (\r
                  EVT_NOTIFY_SIGNAL | EVT_TIMER,\r
                  TPL_CALLBACK,\r
                  DhcpOnTimerTick,\r
                  DhcpSb,\r
                  &DhcpSb->Timer\r
                  );\r
\r
  if (EFI_ERROR (Status)) {\r
    goto ON_ERROR;\r
  }\r
\r
  DhcpSb->UdpIo = UdpIoCreatePort (Controller, ImageHandle, DhcpConfigUdpIo, NULL);\r
\r
  if (DhcpSb->UdpIo == NULL) {\r
    Status = EFI_OUT_OF_RESOURCES;\r
    goto ON_ERROR;\r
  }\r
\r
  DhcpSb->HwLen  = (UINT8) DhcpSb->UdpIo->SnpMode.HwAddressSize;\r
  DhcpSb->HwType = DhcpSb->UdpIo->SnpMode.IfType;\r
  CopyMem (&DhcpSb->Mac, &DhcpSb->UdpIo->SnpMode.CurrentAddress, sizeof (DhcpSb->Mac));\r
\r
  *Service       = DhcpSb;\r
  return EFI_SUCCESS;\r
\r
ON_ERROR:\r
  Dhcp4CloseService (DhcpSb);\r
  NetFreePool (DhcpSb);\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_SUCCES             This driver is added to ControllerHandle\r
  @retval EFI_ALREADY_STARTED    This driver is already running on ControllerHandle\r
  @retval other                  This driver does not support this device\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
Dhcp4DriverBindingStart (\r
  IN EFI_DRIVER_BINDING_PROTOCOL  *This,\r
  IN EFI_HANDLE                   ControllerHandle,\r
  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath OPTIONAL\r
  )\r
{\r
  DHCP_SERVICE              *DhcpSb;\r
  EFI_STATUS                Status;\r
\r
  //\r
  // First: test for the DHCP4 Protocol\r
  //\r
  Status = gBS->OpenProtocol (\r
                  ControllerHandle,\r
                  &gEfiDhcp4ServiceBindingProtocolGuid,\r
                  NULL,\r
                  This->DriverBindingHandle,\r
                  ControllerHandle,\r
                  EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
                  );\r
\r
  if (Status == EFI_SUCCESS) {\r
    return EFI_ALREADY_STARTED;\r
  }\r
\r
  Status = Dhcp4CreateService (ControllerHandle, This->DriverBindingHandle, &DhcpSb);\r
\r
  if (EFI_ERROR (Status)) {\r
    return Status;\r
  }\r
\r
  Status = gBS->SetTimer (DhcpSb->Timer, TimerPeriodic, TICKS_PER_SECOND);\r
\r
  if (EFI_ERROR (Status)) {\r
    goto ON_ERROR;\r
  }\r
\r
  //\r
  // Install the Dhcp4ServiceBinding Protocol onto ControlerHandle\r
  //\r
  Status = gBS->InstallMultipleProtocolInterfaces (\r
                  &ControllerHandle,\r
                  &gEfiDhcp4ServiceBindingProtocolGuid,\r
                  &DhcpSb->ServiceBinding,\r
                  NULL\r
                  );\r
\r
  if (EFI_ERROR (Status)) {\r
    goto ON_ERROR;\r
  }\r
\r
  return Status;\r
\r
ON_ERROR:\r
  Dhcp4CloseService (DhcpSb);\r
  NetFreePool (DhcpSb);\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_SUCCES             This driver is removed ControllerHandle\r
  @retval other                  This driver was not removed from this device\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
Dhcp4DriverBindingStop (\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_SERVICE_BINDING_PROTOCOL  *ServiceBinding;\r
  DHCP_SERVICE                  *DhcpSb;\r
  DHCP_PROTOCOL                 *Instance;\r
  EFI_HANDLE                    NicHandle;\r
  EFI_STATUS                    Status;\r
  EFI_TPL                       OldTpl;\r
\r
  //\r
  // DHCP driver opens UDP child, So, the ControllerHandle is the\r
  // UDP child handle. locate the Nic handle first.\r
  //\r
  NicHandle = NetLibGetNicHandle (ControllerHandle, &gEfiUdp4ProtocolGuid);\r
\r
  if (NicHandle == NULL) {\r
    return EFI_SUCCESS;\r
  }\r
\r
   Status = gBS->OpenProtocol (\r
                  NicHandle,\r
                  &gEfiDhcp4ServiceBindingProtocolGuid,\r
                  (VOID **) &ServiceBinding,\r
                  This->DriverBindingHandle,\r
                  NicHandle,\r
                  EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
                  );\r
\r
  if (EFI_ERROR (Status)) {\r
    return EFI_DEVICE_ERROR;\r
  }\r
\r
  DhcpSb = DHCP_SERVICE_FROM_THIS (ServiceBinding);\r
\r
  if (DhcpSb->InDestory) {\r
    return EFI_SUCCESS;\r
  }\r
\r
  OldTpl            = NET_RAISE_TPL (NET_TPL_LOCK);\r
  DhcpSb->InDestory = TRUE;\r
\r
  //\r
  // Don't use NET_LIST_FOR_EACH_SAFE here, Dhcp4ServiceBindingDestoryChild\r
  // may cause other child to be deleted.\r
  //\r
  while (!NetListIsEmpty (&DhcpSb->Children)) {\r
    Instance = NET_LIST_HEAD (&DhcpSb->Children, DHCP_PROTOCOL, Link);\r
    Dhcp4ServiceBindingDestroyChild (ServiceBinding, Instance->Handle);\r
  }\r
\r
  if (DhcpSb->NumChildren != 0) {\r
    Status = EFI_DEVICE_ERROR;\r
    goto ON_ERROR;\r
  }\r
\r
  DhcpSb->ServiceState  = DHCP_DESTORY;\r
\r
  Status = gBS->UninstallProtocolInterface (\r
                  NicHandle,\r
                  &gEfiDhcp4ServiceBindingProtocolGuid,\r
                  ServiceBinding\r
                  );\r
\r
  if (EFI_ERROR (Status)) {\r
    goto ON_ERROR;\r
  }\r
\r
  Dhcp4CloseService (DhcpSb);\r
  NET_RESTORE_TPL (OldTpl);\r
\r
  NetFreePool (DhcpSb);\r
  return EFI_SUCCESS;\r
\r
ON_ERROR:\r
  DhcpSb->InDestory = FALSE;\r
  NET_RESTORE_TPL (OldTpl);\r
  return Status;\r
}\r
\r
\r
/**\r
  Initialize a new DHCP child\r
\r
  @param  DhcpSb                 The dhcp service instance\r
  @param  Instance               The dhcp instance to initialize\r
\r
  @return None\r
\r
**/\r
VOID\r
DhcpInitProtocol (\r
  IN DHCP_SERVICE           *DhcpSb,\r
  IN DHCP_PROTOCOL          *Instance\r
  )\r
{\r
  Instance->Signature         = DHCP_PROTOCOL_SIGNATURE;\r
  CopyMem (&Instance->Dhcp4Protocol, &mDhcp4ProtocolTemplate, sizeof (Instance->Dhcp4Protocol));\r
  NetListInit (&Instance->Link);\r
  Instance->Handle            = NULL;\r
  Instance->Service           = DhcpSb;\r
  Instance->InDestory         = FALSE;\r
  Instance->CompletionEvent   = NULL;\r
  Instance->RenewRebindEvent  = NULL;\r
  Instance->Token             = NULL;\r
}\r
\r
\r
/**\r
  Creates a child handle with a set of DHCP4 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\r
                                 is not  NULL, then the DHCP4 services are added to\r
                                 the existing  child handle.\r
\r
  @retval EFI_SUCCES             The child handle was created with the DHCP4\r
                                 services\r
  @retval EFI_OUT_OF_RESOURCES   There are not enough resources to create the child\r
  @retval other                  The child handle was not created\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
Dhcp4ServiceBindingCreateChild (\r
  IN EFI_SERVICE_BINDING_PROTOCOL  *This,\r
  IN EFI_HANDLE                    *ChildHandle\r
  )\r
{\r
  DHCP_SERVICE              *DhcpSb;\r
  DHCP_PROTOCOL             *Instance;\r
  EFI_STATUS                Status;\r
  EFI_TPL                   OldTpl;\r
  VOID                      *Udp4;\r
\r
  if ((This == NULL) || (ChildHandle == NULL)) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  Instance = NetAllocatePool (sizeof (*Instance));\r
\r
  if (Instance == NULL) {\r
    return EFI_OUT_OF_RESOURCES;\r
  }\r
\r
  DhcpSb = DHCP_SERVICE_FROM_THIS (This);\r
  DhcpInitProtocol (DhcpSb, Instance);\r
\r
  //\r
  // Install DHCP4 onto ChildHandle\r
  //\r
  Status = gBS->InstallMultipleProtocolInterfaces (\r
                  ChildHandle,\r
                  &gEfiDhcp4ProtocolGuid,\r
                  &Instance->Dhcp4Protocol,\r
                  NULL\r
                  );\r
\r
  if (EFI_ERROR (Status)) {\r
    NetFreePool (Instance);\r
    return Status;\r
  }\r
\r
  Instance->Handle  = *ChildHandle;\r
\r
  //\r
  // Open the Udp4 protocol BY_CHILD.\r
  //\r
  Status = gBS->OpenProtocol (\r
                  DhcpSb->UdpIo->UdpHandle,\r
                  &gEfiUdp4ProtocolGuid,\r
                  (VOID **) &Udp4,\r
                  gDhcp4DriverBinding.DriverBindingHandle,\r
                  Instance->Handle,\r
                  EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER\r
                  );\r
  if (EFI_ERROR (Status)) {\r
    gBS->UninstallMultipleProtocolInterfaces (\r
           Instance->Handle,\r
           &gEfiDhcp4ProtocolGuid,\r
           &Instance->Dhcp4Protocol,\r
           NULL\r
           );\r
\r
    NetFreePool (Instance);\r
    return Status;\r
  }\r
\r
  OldTpl = NET_RAISE_TPL (NET_TPL_LOCK);\r
\r
  NetListInsertTail (&DhcpSb->Children, &Instance->Link);\r
  DhcpSb->NumChildren++;\r
\r
  NET_RESTORE_TPL (OldTpl);\r
\r
  return EFI_SUCCESS;\r
}\r
\r
\r
/**\r
  Destroys a child handle with a set of DHCP4 services.\r
\r
  @param  This                   Protocol instance pointer.\r
  @param  ChildHandle            Handle of the child to destroy\r
\r
  @retval EFI_SUCCES             The DHCP4 service is removed from the child handle\r
  @retval EFI_UNSUPPORTED        The child handle does not support the DHCP4\r
                                 service\r
  @retval EFI_INVALID_PARAMETER  Child handle is not a valid EFI Handle.\r
  @retval EFI_ACCESS_DENIED      The child handle could not be destroyed because\r
                                 its  DHCP4 services are being used.\r
  @retval other                  The child handle was not destroyed\r
\r
**/\r
EFI_STATUS\r
EFIAPI\r
Dhcp4ServiceBindingDestroyChild (\r
  IN EFI_SERVICE_BINDING_PROTOCOL  *This,\r
  IN EFI_HANDLE                    ChildHandle\r
  )\r
{\r
  DHCP_SERVICE              *DhcpSb;\r
  DHCP_PROTOCOL             *Instance;\r
  EFI_DHCP4_PROTOCOL        *Dhcp;\r
  EFI_TPL                   OldTpl;\r
  EFI_STATUS                Status;\r
\r
  if ((This == NULL) || (ChildHandle == NULL)) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  //\r
  // Retrieve the private context data structures\r
  //\r
  Status = gBS->OpenProtocol (\r
                  ChildHandle,\r
                  &gEfiDhcp4ProtocolGuid,\r
                  (VOID **) &Dhcp,\r
                  gDhcp4DriverBinding.DriverBindingHandle,\r
                  ChildHandle,\r
                  EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
                  );\r
\r
  if (EFI_ERROR (Status)) {\r
    return EFI_UNSUPPORTED;\r
  }\r
\r
  Instance  = DHCP_INSTANCE_FROM_THIS (Dhcp);\r
  DhcpSb    = DHCP_SERVICE_FROM_THIS (This);\r
\r
  if (Instance->Service != DhcpSb) {\r
    return EFI_INVALID_PARAMETER;\r
  }\r
\r
  //\r
  // A child can be destoried more than once. For example,\r
  // Dhcp4DriverBindingStop will destory all of its children.\r
  // when caller driver is being stopped, it will destory the\r
  // dhcp child it opens.\r
  //\r
  if (Instance->InDestory) {\r
    return EFI_SUCCESS;\r
  }\r
\r
  OldTpl = NET_RAISE_TPL (NET_TPL_LOCK);\r
  Instance->InDestory = TRUE;\r
\r
  //\r
  // Close the Udp4 protocol.\r
  //\r
  gBS->CloseProtocol (\r
         DhcpSb->UdpIo->UdpHandle,\r
         &gEfiUdp4ProtocolGuid,\r
         gDhcp4DriverBinding.DriverBindingHandle,\r
         ChildHandle\r
         );\r
\r
  //\r
  // Uninstall the DHCP4 protocol first to enable a top down destruction.\r
  //\r
  Status = gBS->UninstallProtocolInterface (\r
                  ChildHandle,\r
                  &gEfiDhcp4ProtocolGuid,\r
                  Dhcp\r
                  );\r
\r
  if (EFI_ERROR (Status)) {\r
    Instance->InDestory = FALSE;\r
\r
    NET_RESTORE_TPL (OldTpl);\r
    return Status;\r
  }\r
\r
  if (DhcpSb->ActiveChild == Instance) {\r
    DhcpYieldControl (DhcpSb);\r
  }\r
\r
  NetListRemoveEntry (&Instance->Link);\r
  DhcpSb->NumChildren--;\r
\r
  NET_RESTORE_TPL (OldTpl);\r
\r
  NetFreePool (Instance);\r
  return EFI_SUCCESS;\r
}\r
Commit	Line	Data
772db4bb	1	/** @file\r
	2	\r
	3	Copyright (c) 2006 - 2007, Intel Corporation\r
	4	All rights reserved. This program and the accompanying materials\r
	5	are licensed and made available under the terms and conditions of the BSD License\r
	6	which accompanies this distribution. The full text of the license may be found at\r
	7	http://opensource.org/licenses/bsd-license.php\r
	8	\r
	9	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
	10	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
	11	\r
	12	\r
	13	Module Name:\r
	14	\r
	15	Dhcp4Driver.c\r
	16	\r
	17	Abstract:\r
	18	\r
	19	\r
	20	**/\r
	21	\r
	22	#include "Dhcp4Impl.h"\r
	23	#include "Dhcp4Driver.h"\r
	24	\r
	25	EFI_DRIVER_BINDING_PROTOCOL gDhcp4DriverBinding = {\r
	26	Dhcp4DriverBindingSupported,\r
	27	Dhcp4DriverBindingStart,\r
	28	Dhcp4DriverBindingStop,\r
	29	0xa,\r
	30	NULL,\r
	31	NULL\r
	32	};\r
	33	\r
	34	EFI_SERVICE_BINDING_PROTOCOL mDhcp4ServiceBindingTemplete = {\r
	35	Dhcp4ServiceBindingCreateChild,\r
	36	Dhcp4ServiceBindingDestroyChild\r
	37	};\r
	38	\r
772db4bb	39	\r
	40	EFI_STATUS\r
	41	EFIAPI\r
	42	Dhcp4DriverEntryPoint (\r
	43	IN EFI_HANDLE ImageHandle,\r
	44	IN EFI_SYSTEM_TABLE *SystemTable\r
	45	)\r
	46	/*++\r
	47	\r
	48	Routine Description:\r
	49	\r
	50	Entry point of the DHCP driver to install various protocols.\r
	51	\r
	52	Arguments:\r
	53	\r
	54	ImageHandle - The driver's image handle\r
	55	SystemTable - The system table\r
	56	\r
	57	Returns:\r
	58	\r
	59	EFI_SUCCESS - All the related protocols are installed.\r
	60	Others - Failed to install the protocols.\r
	61	\r
	62	--*/\r
	63	{\r
83cbd279	64	return EfiLibInstallDriverBindingComponentName2 (\r
772db4bb	65	ImageHandle,\r
	66	SystemTable,\r
	67	&gDhcp4DriverBinding,\r
	68	ImageHandle,\r
	69	&gDhcp4ComponentName,\r
83cbd279	70	&gDhcp4ComponentName2\r
772db4bb	71	);\r
	72	}\r
	73	\r
	74	\r
	75	/**\r
	76	Test to see if DHCP driver supports the ControllerHandle.\r
	77	\r
	78	@param This Protocol instance pointer.\r
	79	@param ControllerHandle Handle of device to test\r
	80	@param RemainingDevicePath Optional parameter use to pick a specific child\r
	81	device to start.\r
	82	\r
	83	@retval EFI_SUCCES This driver supports this device\r
	84	@retval other This driver does not support this device\r
	85	\r
	86	**/\r
	87	EFI_STATUS\r
	88	EFIAPI\r
	89	Dhcp4DriverBindingSupported (\r
	90	IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
	91	IN EFI_HANDLE ControllerHandle,\r
	92	IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath OPTIONAL\r
	93	)\r
	94	{\r
	95	EFI_STATUS Status;\r
	96	\r
	97	Status = gBS->OpenProtocol (\r
	98	ControllerHandle,\r
	99	&gEfiUdp4ServiceBindingProtocolGuid,\r
	100	NULL,\r
	101	This->DriverBindingHandle,\r
	102	ControllerHandle,\r
	103	EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
	104	);\r
	105	\r
	106	return Status;\r
	107	}\r
	108	\r
	109	\r
	110	\r
	111	/**\r
	112	Configure the default UDP child to receive all the DHCP traffics\r
	113	on this network interface.\r
	114	\r
	115	@param UdpIo The UDP IO port to configure\r
	116	@param Context The context to the function\r
	117	\r
	118	@retval EFI_SUCCESS The UDP IO port is successfully configured.\r
	119	@retval Others Failed to configure the UDP child.\r
	120	\r
	121	**/\r
	122	EFI_STATUS\r
	123	DhcpConfigUdpIo (\r
	124	IN UDP_IO_PORT *UdpIo,\r
	125	IN VOID *Context\r
	126	)\r
	127	{\r
	128	EFI_UDP4_CONFIG_DATA UdpConfigData;\r
	129	\r
	130	UdpConfigData.AcceptBroadcast = TRUE;\r
	131	UdpConfigData.AcceptPromiscuous = FALSE;\r
	132	UdpConfigData.AcceptAnyPort = FALSE;\r
	133	UdpConfigData.AllowDuplicatePort = TRUE;\r
	134	UdpConfigData.TypeOfService = 0;\r
135	UdpConfigData.TimeToLive = 64;\r
136	UdpConfigData.DoNotFragment = FALSE;\r
137	UdpConfigData.ReceiveTimeout = 0;\r
138	UdpConfigData.TransmitTimeout = 0;\r
139	\r
140	UdpConfigData.UseDefaultAddress = FALSE;\r
141	UdpConfigData.StationPort = DHCP_CLIENT_PORT;\r
142	UdpConfigData.RemotePort = DHCP_SERVER_PORT;\r
143	\r
144	NetZeroMem (&UdpConfigData.StationAddress, sizeof (EFI_IPv4_ADDRESS));\r
145	NetZeroMem (&UdpConfigData.SubnetMask, sizeof (EFI_IPv4_ADDRESS));\r
146	NetZeroMem (&UdpConfigData.RemoteAddress, sizeof (EFI_IPv4_ADDRESS));\r
147	\r
148	return UdpIo->Udp->Configure (UdpIo->Udp, &UdpConfigData);;\r
149	}\r
150	\r
151	\r
152	\r
153	/**\r
154	Destory the DHCP service. The Dhcp4 service may be partly initialized,\r
155	or partly destoried. If a resource is destoried, it is marked as so in\r
156	case the destory failed and being called again later.\r
157	\r
158	@param DhcpSb The DHCP service instance to destory.\r
159	\r
160	@retval EFI_SUCCESS The DHCP service is successfully closed.\r
161	\r
162	**/\r
163	EFI_STATUS\r
164	Dhcp4CloseService (\r
165	IN DHCP_SERVICE *DhcpSb\r
166	)\r
167	{\r
168	DhcpCleanLease (DhcpSb);\r
169	\r
170	if (DhcpSb->UdpIo != NULL) {\r
171	UdpIoFreePort (DhcpSb->UdpIo);\r
172	DhcpSb->UdpIo = NULL;\r
173	}\r
174	\r
175	if (DhcpSb->Timer != NULL) {\r
176	gBS->SetTimer (DhcpSb->Timer, TimerCancel, 0);\r
177	gBS->CloseEvent (DhcpSb->Timer);\r
178	\r
179	DhcpSb->Timer = NULL;\r
180	}\r
181	\r
182	return EFI_SUCCESS;\r
183	}\r
184	\r
185	\r
186	\r
187	/**\r
188	Create a new DHCP service binding instance for the controller.\r
189	\r
190	@param Controller The controller to install DHCP service binding\r
191	protocol onto\r
192	@param ImageHandle The driver's image handle\r
193	@param Service The variable to receive the created DHCP service\r
194	instance.\r
195	\r
196	@retval EFI_OUT_OF_RESOURCES Failed to allocate resource .\r
197	@retval EFI_SUCCESS The DHCP service instance is created.\r
198	\r
199	**/\r
200	EFI_STATUS\r
201	Dhcp4CreateService (\r
202	IN EFI_HANDLE Controller,\r
203	IN EFI_HANDLE ImageHandle,\r
204	OUT DHCP_SERVICE **Service\r
205	)\r
206	{\r
207	DHCP_SERVICE *DhcpSb;\r
208	EFI_STATUS Status;\r
209	\r
210	*Service = NULL;\r
211	DhcpSb = NetAllocateZeroPool (sizeof (DHCP_SERVICE));\r
212	\r
213	if (DhcpSb == NULL) {\r
214	return EFI_OUT_OF_RESOURCES;\r
215	}\r
216	\r
217	DhcpSb->Signature = DHCP_SERVICE_SIGNATURE;\r
218	DhcpSb->ServiceBinding = mDhcp4ServiceBindingTemplete;\r
219	DhcpSb->ServiceState = DHCP_UNCONFIGED;\r
220	DhcpSb->InDestory = FALSE;\r
221	DhcpSb->Controller = Controller;\r
222	DhcpSb->Image = ImageHandle;\r
223	NetListInit (&DhcpSb->Children);\r
224	DhcpSb->DhcpState = Dhcp4Stopped;\r
225	DhcpSb->Xid = NET_RANDOM (NetRandomInitSeed ());\r
226	\r
227	//\r
228	// Create various resources, UdpIo, Timer, and get Mac address\r
229	//\r
230	Status = gBS->CreateEvent (\r
231	EVT_NOTIFY_SIGNAL \| EVT_TIMER,\r
232	TPL_CALLBACK,\r
233	DhcpOnTimerTick,\r
234	DhcpSb,\r
235	&DhcpSb->Timer\r
236	);\r
237	\r
238	if (EFI_ERROR (Status)) {\r
239	goto ON_ERROR;\r
240	}\r
241	\r
242	DhcpSb->UdpIo = UdpIoCreatePort (Controller, ImageHandle, DhcpConfigUdpIo, NULL);\r
243	\r
244	if (DhcpSb->UdpIo == NULL) {\r
245	Status = EFI_OUT_OF_RESOURCES;\r
246	goto ON_ERROR;\r
247	}\r
248	\r
249	DhcpSb->HwLen = (UINT8) DhcpSb->UdpIo->SnpMode.HwAddressSize;\r
250	DhcpSb->HwType = DhcpSb->UdpIo->SnpMode.IfType;\r
687a2e5f	251	CopyMem (&DhcpSb->Mac, &DhcpSb->UdpIo->SnpMode.CurrentAddress, sizeof (DhcpSb->Mac));\r
772db4bb	252	\r
	253	*Service = DhcpSb;\r
	254	return EFI_SUCCESS;\r
	255	\r
	256	ON_ERROR:\r
	257	Dhcp4CloseService (DhcpSb);\r
	258	NetFreePool (DhcpSb);\r
	259	\r
	260	return Status;\r
	261	}\r
	262	\r
	263	\r
	264	/**\r
	265	Start this driver on ControllerHandle.\r
	266	\r
	267	@param This Protocol instance pointer.\r
	268	@param ControllerHandle Handle of device to bind driver to\r
	269	@param RemainingDevicePath Optional parameter use to pick a specific child\r
	270	device to start.\r
	271	\r
	272	@retval EFI_SUCCES This driver is added to ControllerHandle\r
	273	@retval EFI_ALREADY_STARTED This driver is already running on ControllerHandle\r
	274	@retval other This driver does not support this device\r
	275	\r
	276	**/\r
	277	EFI_STATUS\r
	278	EFIAPI\r
	279	Dhcp4DriverBindingStart (\r
	280	IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
	281	IN EFI_HANDLE ControllerHandle,\r
	282	IN EFI_DEVICE_PATH_PROTOCOL *RemainingDevicePath OPTIONAL\r
	283	)\r
	284	{\r
	285	DHCP_SERVICE *DhcpSb;\r
	286	EFI_STATUS Status;\r
	287	\r
	288	//\r
	289	// First: test for the DHCP4 Protocol\r
	290	//\r
	291	Status = gBS->OpenProtocol (\r
	292	ControllerHandle,\r
	293	&gEfiDhcp4ServiceBindingProtocolGuid,\r
	294	NULL,\r
	295	This->DriverBindingHandle,\r
	296	ControllerHandle,\r
	297	EFI_OPEN_PROTOCOL_TEST_PROTOCOL\r
	298	);\r
	299	\r
	300	if (Status == EFI_SUCCESS) {\r
	301	return EFI_ALREADY_STARTED;\r
	302	}\r
	303	\r
	304	Status = Dhcp4CreateService (ControllerHandle, This->DriverBindingHandle, &DhcpSb);\r
	305	\r
	306	if (EFI_ERROR (Status)) {\r
	307	return Status;\r
	308	}\r
	309	\r
	310	Status = gBS->SetTimer (DhcpSb->Timer, TimerPeriodic, TICKS_PER_SECOND);\r
	311	\r
	312	if (EFI_ERROR (Status)) {\r
	313	goto ON_ERROR;\r
	314	}\r
	315	\r
316	//\r
317	// Install the Dhcp4ServiceBinding Protocol onto ControlerHandle\r
318	//\r
319	Status = gBS->InstallMultipleProtocolInterfaces (\r
320	&ControllerHandle,\r
321	&gEfiDhcp4ServiceBindingProtocolGuid,\r
322	&DhcpSb->ServiceBinding,\r
323	NULL\r
324	);\r
325	\r
326	if (EFI_ERROR (Status)) {\r
327	goto ON_ERROR;\r
328	}\r
329	\r
330	return Status;\r
331	\r
332	ON_ERROR:\r
333	Dhcp4CloseService (DhcpSb);\r
334	NetFreePool (DhcpSb);\r
335	return Status;\r
336	}\r
337	\r
338	\r
339	/**\r
340	Stop this driver on ControllerHandle.\r
341	\r
342	@param This Protocol instance pointer.\r
343	@param ControllerHandle Handle of device to stop driver on\r
344	@param NumberOfChildren Number of Handles in ChildHandleBuffer. If number\r
345	of children is zero stop the entire bus driver.\r
346	@param ChildHandleBuffer List of Child Handles to Stop.\r
347	\r
348	@retval EFI_SUCCES This driver is removed ControllerHandle\r
349	@retval other This driver was not removed from this device\r
350	\r
351	**/\r
352	EFI_STATUS\r
353	EFIAPI\r
354	Dhcp4DriverBindingStop (\r
355	IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
356	IN EFI_HANDLE ControllerHandle,\r
357	IN UINTN NumberOfChildren,\r
358	IN EFI_HANDLE *ChildHandleBuffer\r
359	)\r
360	{\r
361	EFI_SERVICE_BINDING_PROTOCOL *ServiceBinding;\r
362	DHCP_SERVICE *DhcpSb;\r
363	DHCP_PROTOCOL *Instance;\r
364	EFI_HANDLE NicHandle;\r
365	EFI_STATUS Status;\r
366	EFI_TPL OldTpl;\r
367	\r
368	//\r
369	// DHCP driver opens UDP child, So, the ControllerHandle is the\r
370	// UDP child handle. locate the Nic handle first.\r
371	//\r
372	NicHandle = NetLibGetNicHandle (ControllerHandle, &gEfiUdp4ProtocolGuid);\r
373	\r
374	if (NicHandle == NULL) {\r
375	return EFI_SUCCESS;\r
376	}\r
377	\r
378	Status = gBS->OpenProtocol (\r
379	NicHandle,\r
380	&gEfiDhcp4ServiceBindingProtocolGuid,\r
381	(VOID **) &ServiceBinding,\r
382	This->DriverBindingHandle,\r
383	NicHandle,\r
384	EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
385	);\r
386	\r
387	if (EFI_ERROR (Status)) {\r
388	return EFI_DEVICE_ERROR;\r
389	}\r
390	\r
391	DhcpSb = DHCP_SERVICE_FROM_THIS (ServiceBinding);\r
392	\r
393	if (DhcpSb->InDestory) {\r
394	return EFI_SUCCESS;\r
395	}\r
396	\r
397	OldTpl = NET_RAISE_TPL (NET_TPL_LOCK);\r
398	DhcpSb->InDestory = TRUE;\r
399	\r
400	//\r
401	// Don't use NET_LIST_FOR_EACH_SAFE here, Dhcp4ServiceBindingDestoryChild\r
402	// may cause other child to be deleted.\r
403	//\r
404	while (!NetListIsEmpty (&DhcpSb->Children)) {\r
405	Instance = NET_LIST_HEAD (&DhcpSb->Children, DHCP_PROTOCOL, Link);\r
406	Dhcp4ServiceBindingDestroyChild (ServiceBinding, Instance->Handle);\r
407	}\r
408	\r
409	if (DhcpSb->NumChildren != 0) {\r
410	Status = EFI_DEVICE_ERROR;\r
411	goto ON_ERROR;\r
412	}\r
413	\r
414	DhcpSb->ServiceState = DHCP_DESTORY;\r
415	\r
416	Status = gBS->UninstallProtocolInterface (\r
417	NicHandle,\r
418	&gEfiDhcp4ServiceBindingProtocolGuid,\r
419	ServiceBinding\r
420	);\r
421	\r
422	if (EFI_ERROR (Status)) {\r
423	goto ON_ERROR;\r
424	}\r
425	\r
426	Dhcp4CloseService (DhcpSb);\r
427	NET_RESTORE_TPL (OldTpl);\r
428	\r
429	NetFreePool (DhcpSb);\r
430	return EFI_SUCCESS;\r
431	\r
432	ON_ERROR:\r
433	DhcpSb->InDestory = FALSE;\r
434	NET_RESTORE_TPL (OldTpl);\r
435	return Status;\r
436	}\r
437	\r
438	\r
439	/**\r
440	Initialize a new DHCP child\r
441	\r
442	@param DhcpSb The dhcp service instance\r
443	@param Instance The dhcp instance to initialize\r
444	\r
445	@return None\r
446	\r
447	**/\r
448	VOID\r
449	DhcpInitProtocol (\r
450	IN DHCP_SERVICE *DhcpSb,\r
451	IN DHCP_PROTOCOL *Instance\r
452	)\r
453	{\r
454	Instance->Signature = DHCP_PROTOCOL_SIGNATURE;\r
687a2e5f	455	CopyMem (&Instance->Dhcp4Protocol, &mDhcp4ProtocolTemplate, sizeof (Instance->Dhcp4Protocol));\r
772db4bb	456	NetListInit (&Instance->Link);\r
	457	Instance->Handle = NULL;\r
	458	Instance->Service = DhcpSb;\r
	459	Instance->InDestory = FALSE;\r
	460	Instance->CompletionEvent = NULL;\r
	461	Instance->RenewRebindEvent = NULL;\r
	462	Instance->Token = NULL;\r
	463	}\r
	464	\r
	465	\r
	466	/**\r
	467	Creates a child handle with a set of DHCP4 services.\r
	468	\r
	469	@param This Protocol instance pointer.\r
	470	@param ChildHandle Pointer to the handle of the child to create. If\r
	471	it is NULL, then a new handle is created. If it\r
	472	is not NULL, then the DHCP4 services are added to\r
	473	the existing child handle.\r
	474	\r
	475	@retval EFI_SUCCES The child handle was created with the DHCP4\r
	476	services\r
	477	@retval EFI_OUT_OF_RESOURCES There are not enough resources to create the child\r
	478	@retval other The child handle was not created\r
	479	\r
	480	**/\r
	481	EFI_STATUS\r
	482	EFIAPI\r
	483	Dhcp4ServiceBindingCreateChild (\r
	484	IN EFI_SERVICE_BINDING_PROTOCOL *This,\r
	485	IN EFI_HANDLE *ChildHandle\r
	486	)\r
	487	{\r
	488	DHCP_SERVICE *DhcpSb;\r
	489	DHCP_PROTOCOL *Instance;\r
	490	EFI_STATUS Status;\r
	491	EFI_TPL OldTpl;\r
	492	VOID *Udp4;\r
	493	\r
	494	if ((This == NULL) \|\| (ChildHandle == NULL)) {\r
	495	return EFI_INVALID_PARAMETER;\r
	496	}\r
	497	\r
	498	Instance = NetAllocatePool (sizeof (*Instance));\r
	499	\r
	500	if (Instance == NULL) {\r
	501	return EFI_OUT_OF_RESOURCES;\r
	502	}\r
	503	\r
	504	DhcpSb = DHCP_SERVICE_FROM_THIS (This);\r
	505	DhcpInitProtocol (DhcpSb, Instance);\r
	506	\r
	507	//\r
	508	// Install DHCP4 onto ChildHandle\r
	509	//\r
	510	Status = gBS->InstallMultipleProtocolInterfaces (\r
	511	ChildHandle,\r
	512	&gEfiDhcp4ProtocolGuid,\r
	513	&Instance->Dhcp4Protocol,\r
	514	NULL\r
	515	);\r
	516	\r
	517	if (EFI_ERROR (Status)) {\r
	518	NetFreePool (Instance);\r
	519	return Status;\r
520	}\r
521	\r
522	Instance->Handle = *ChildHandle;\r
523	\r
524	//\r
525	// Open the Udp4 protocol BY_CHILD.\r
526	//\r
527	Status = gBS->OpenProtocol (\r
528	DhcpSb->UdpIo->UdpHandle,\r
529	&gEfiUdp4ProtocolGuid,\r
530	(VOID **) &Udp4,\r
531	gDhcp4DriverBinding.DriverBindingHandle,\r
532	Instance->Handle,\r
533	EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER\r
534	);\r
535	if (EFI_ERROR (Status)) {\r
536	gBS->UninstallMultipleProtocolInterfaces (\r
537	Instance->Handle,\r
538	&gEfiDhcp4ProtocolGuid,\r
539	&Instance->Dhcp4Protocol,\r
540	NULL\r
541	);\r
542	\r
543	NetFreePool (Instance);\r
544	return Status;\r
545	}\r
546	\r
547	OldTpl = NET_RAISE_TPL (NET_TPL_LOCK);\r
548	\r
549	NetListInsertTail (&DhcpSb->Children, &Instance->Link);\r
550	DhcpSb->NumChildren++;\r
551	\r
552	NET_RESTORE_TPL (OldTpl);\r
553	\r
554	return EFI_SUCCESS;\r
555	}\r
556	\r
557	\r
558	/**\r
559	Destroys a child handle with a set of DHCP4 services.\r
560	\r
561	@param This Protocol instance pointer.\r
562	@param ChildHandle Handle of the child to destroy\r
563	\r
564	@retval EFI_SUCCES The DHCP4 service is removed from the child handle\r
565	@retval EFI_UNSUPPORTED The child handle does not support the DHCP4\r
566	service\r
567	@retval EFI_INVALID_PARAMETER Child handle is not a valid EFI Handle.\r
568	@retval EFI_ACCESS_DENIED The child handle could not be destroyed because\r
569	its DHCP4 services are being used.\r
570	@retval other The child handle was not destroyed\r
571	\r
572	**/\r
573	EFI_STATUS\r
574	EFIAPI\r
575	Dhcp4ServiceBindingDestroyChild (\r
576	IN EFI_SERVICE_BINDING_PROTOCOL *This,\r
577	IN EFI_HANDLE ChildHandle\r
578	)\r
579	{\r
580	DHCP_SERVICE *DhcpSb;\r
581	DHCP_PROTOCOL *Instance;\r
582	EFI_DHCP4_PROTOCOL *Dhcp;\r
583	EFI_TPL OldTpl;\r
584	EFI_STATUS Status;\r
585	\r
586	if ((This == NULL) \|\| (ChildHandle == NULL)) {\r
587	return EFI_INVALID_PARAMETER;\r
588	}\r
589	\r
590	//\r
591	// Retrieve the private context data structures\r
592	//\r
593	Status = gBS->OpenProtocol (\r
594	ChildHandle,\r
595	&gEfiDhcp4ProtocolGuid,\r
596	(VOID **) &Dhcp,\r
597	gDhcp4DriverBinding.DriverBindingHandle,\r
598	ChildHandle,\r
599	EFI_OPEN_PROTOCOL_GET_PROTOCOL\r
600	);\r
601	\r
602	if (EFI_ERROR (Status)) {\r
603	return EFI_UNSUPPORTED;\r
604	}\r
605	\r
606	Instance = DHCP_INSTANCE_FROM_THIS (Dhcp);\r
607	DhcpSb = DHCP_SERVICE_FROM_THIS (This);\r
608	\r
609	if (Instance->Service != DhcpSb) {\r
610	return EFI_INVALID_PARAMETER;\r
611	}\r
612	\r
613	//\r
614	// A child can be destoried more than once. For example,\r
615	// Dhcp4DriverBindingStop will destory all of its children.\r
616	// when caller driver is being stopped, it will destory the\r
617	// dhcp child it opens.\r
618	//\r
619	if (Instance->InDestory) {\r
620	return EFI_SUCCESS;\r
621	}\r
622	\r
623	OldTpl = NET_RAISE_TPL (NET_TPL_LOCK);\r
624	Instance->InDestory = TRUE;\r
625	\r
626	//\r
627	// Close the Udp4 protocol.\r
628	//\r
629	gBS->CloseProtocol (\r
630	DhcpSb->UdpIo->UdpHandle,\r
631	&gEfiUdp4ProtocolGuid,\r
632	gDhcp4DriverBinding.DriverBindingHandle,\r
633	ChildHandle\r
634	);\r
635	\r
636	//\r
637	// Uninstall the DHCP4 protocol first to enable a top down destruction.\r
638	//\r
639	Status = gBS->UninstallProtocolInterface (\r
640	ChildHandle,\r
641	&gEfiDhcp4ProtocolGuid,\r
642	Dhcp\r
643	);\r
644	\r
645	if (EFI_ERROR (Status)) {\r
646	Instance->InDestory = FALSE;\r
647	\r
648	NET_RESTORE_TPL (OldTpl);\r
649	return Status;\r
650	}\r
651	\r
652	if (DhcpSb->ActiveChild == Instance) {\r
653	DhcpYieldControl (DhcpSb);\r
654	}\r
655	\r
656	NetListRemoveEntry (&Instance->Link);\r
657	DhcpSb->NumChildren--;\r
658	\r
659	NET_RESTORE_TPL (OldTpl);\r
660	\r
661	NetFreePool (Instance);\r
662	return EFI_SUCCESS;\r
663	}\r