ip4configdriver.c

来自「EFI BIOS是Intel提出的下一代的BIOS标准。这里上传的Edk源代码是」· C语言 代码 · 共 543 行

/*++

Copyright (c) 2006, Intel Corporation                                                         
All rights reserved. This program and the accompanying materials                          
are licensed and made available under the terms and conditions of the BSD License         
which accompanies this distribution.  The full text of the license may be found at        
http://opensource.org/licenses/bsd-license.php                                            
                                                                                          
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. 

Module Name:

  Ip4ConfigDriver.c

Abstract:

  The driver binding for IP4 CONFIG protocol.

--*/

#include "Ip4Config.h"

EFI_STATUS
EFIAPI
EfiIp4ConfigUnload (
  IN EFI_HANDLE             ImageHandle
  )
/*++

Routine Description:

  Stop all the auto configuration when the IP4 configure driver is 
  being unloaded.

Arguments:

  ImageHandle - The driver that is being unloaded

Returns:

  EFI_SUCCESS - The driver has been ready for unload.

--*/
{
  UINT32      Index;

  //
  //  Stop all the IP4_CONFIG instances
  //
  for (Index = 0; Index < MAX_IP4_CONFIG_IN_VARIABLE; Index++) {
    if (mIp4ConfigNicList[Index] == NULL) {
      continue;
    }

    gIp4ConfigDriverBinding.Stop (
                              &gIp4ConfigDriverBinding,
                              mIp4ConfigNicList[Index]->MnpHandle,
                              0,
                              NULL
                              );
  }

  return NetLibDefaultUnload (ImageHandle);
}

EFI_DRIVER_ENTRY_POINT (Ip4ConfigDriverEntryPoint)

EFI_STATUS
Ip4ConfigDriverEntryPoint (
  IN EFI_HANDLE             ImageHandle,
  IN EFI_SYSTEM_TABLE       *SystemTable
  )
/*++

Routine Description:

  The entry point for IP4 config driver which install the driver 
  binding and component name protocol on its image.

Arguments:

  ImageHandle - The Image handle of the driver
  SystemTable - The system table

Returns:

  EFI_SUCCESS - All the related protocols are installed on the driver
  Others      - Failed to install the protocol

--*/
{
  return NetLibInstallAllDriverProtocolsWithUnload (
           ImageHandle,
           SystemTable,
           &gIp4ConfigDriverBinding,
           ImageHandle,
           &gIp4ConfigComponentName,
           NULL,
           NULL,
           EfiIp4ConfigUnload
           );
}

EFI_STATUS
EFIAPI
Ip4ConfigDriverBindingSupported (
  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
  IN EFI_HANDLE                   ControllerHandle,
  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath  OPTIONAL
  )
/*++
 
  Routine Description:
    Test to see if this driver supports ControllerHandle. 
 
  Arguments:
    This                - Protocol instance pointer.
    ControllerHandle    - Handle of device to test
    RemainingDevicePath - Optional parameter use to pick a specific child 
                          device to start.
 
  Returns:
    EFI_SUCCES          - This driver supports this device
    EFI_ALREADY_STARTED - This driver is already running on this device
    other               - This driver does not support this device
 
--*/
{
  EFI_STATUS  Status;

  Status = gBS->OpenProtocol (
                  ControllerHandle,
                  &gEfiManagedNetworkServiceBindingProtocolGuid,
                  NULL,
                  This->DriverBindingHandle,
                  ControllerHandle,
                  EFI_OPEN_PROTOCOL_TEST_PROTOCOL
                  );

  return Status;
}

EFI_STATUS
EFIAPI
Ip4ConfigDriverBindingStart (
  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
  IN EFI_HANDLE                   ControllerHandle,
  IN EFI_DEVICE_PATH_PROTOCOL     *RemainingDevicePath OPTIONAL
  )
/*++
 
  Routine Description:
    Start this driver on ControllerHandle.
 
  Arguments:
    This                - Protocol instance pointer.
    ControllerHandle    - Handle of device to bind driver to
    RemainingDevicePath - Optional parameter use to pick a specific child 
                          device to start.
 
  Returns:
    EFI_SUCCES          - This driver is added to ControllerHandle
    EFI_ALREADY_STARTED - This driver is already running on ControllerHandle
    other               - This driver does not support this device
 
--*/
{
  EFI_IP4_CONFIG_PROTOCOL       *Ip4Config;
  EFI_MANAGED_NETWORK_PROTOCOL  *Mnp;
  EFI_HANDLE                    MnpHandle;
  IP4_CONFIG_INSTANCE           *Instance;
  EFI_SIMPLE_NETWORK_MODE       SnpMode;
  IP4_CONFIG_VARIABLE           *Variable;
  NIC_IP4_CONFIG_INFO           *NicConfig;
  IP4_CONFIG_VARIABLE           *NewVariable;
  EFI_STATUS                    Status;
  UINT32                        Index;

  //
  // Check for multiple start.
  //
  Status = gBS->OpenProtocol (
                  ControllerHandle,
                  &gEfiIp4ConfigProtocolGuid,
                  &Ip4Config,
                  This->DriverBindingHandle,
                  ControllerHandle,
                  EFI_OPEN_PROTOCOL_GET_PROTOCOL
                  );

  if (!EFI_ERROR (Status)) {
    return EFI_ALREADY_STARTED;
  }
  
  //
  // Create a MNP child
  //
  Mnp       = NULL;
  MnpHandle = NULL;
  Instance  = NULL;

  Status    = NetLibCreateServiceChild (
                ControllerHandle,
                This->DriverBindingHandle,
                &gEfiManagedNetworkServiceBindingProtocolGuid,
                &MnpHandle
                );
 
  if (EFI_ERROR (Status)) {
    return Status;
  }

  Status = gBS->OpenProtocol (
                  MnpHandle,
                  &gEfiManagedNetworkProtocolGuid,
                  (VOID **) &Mnp,
                  This->DriverBindingHandle,
                  ControllerHandle,
                  EFI_OPEN_PROTOCOL_BY_DRIVER
                  );

  if (EFI_ERROR (Status)) {
    goto ON_ERROR;
  }
  
  //
  // Allocate an instance then initialize it
  //
  Instance = NetAllocatePool (sizeof (IP4_CONFIG_INSTANCE));

  if (Instance == NULL) {
    Status = EFI_OUT_OF_RESOURCES;
    goto ON_ERROR;
  }

  Instance->Signature         = IP4_CONFIG_INSTANCE_SIGNATURE;
  Instance->Controller        = ControllerHandle;
  Instance->Image             = This->DriverBindingHandle;

  Instance->Ip4ConfigProtocol = mIp4ConfigProtocolTemplate;
  Instance->NicIp4Protocol    = mNicIp4ConfigProtocolTemplate;

  Instance->State             = IP4_CONFIG_STATE_IDLE;
  Instance->Mnp               = Mnp;
  Instance->MnpHandle         = MnpHandle;

  Instance->DoneEvent         = NULL;
  Instance->ReconfigEvent     = NULL;
  Instance->Result            = EFI_NOT_READY;
  Instance->NicConfig         = NULL;

  Instance->Dhcp4             = NULL;
  Instance->Dhcp4Handle       = NULL;
  Instance->Dhcp4Event        = NULL;

  Status = Mnp->GetModeData (Mnp, NULL, &SnpMode);

  if (EFI_ERROR (Status) && (Status != EFI_NOT_STARTED)) {
    goto ON_ERROR;
  }

  Instance->NicAddr.Type    = (UINT16) SnpMode.IfType;
  Instance->NicAddr.Len     = (UINT8) SnpMode.HwAddressSize;
  Instance->NicAddr.MacAddr = SnpMode.CurrentAddress;

  //
  // Add it to the global list, and compose the name
  //
  for (Index = 0; Index < MAX_IP4_CONFIG_IN_VARIABLE; Index++) {
    if (mIp4ConfigNicList[Index] == NULL) {
      mIp4ConfigNicList[Index]  = Instance;
      Instance->NicIndex        = Index;

      if (Instance->NicAddr.Type == NET_IFTYPE_ETHERNET) {
        Instance->NicName[0]  = 'e';
        Instance->NicName[1]  = 't';
        Instance->NicName[2]  = 'h';
        Instance->NicName[3]  = (UINT16) ('0' + Index);
        Instance->NicName[4]  = 0;
      } else {
        Instance->NicName[0]  = 'u';
        Instance->NicName[1]  = 'n';
        Instance->NicName[2]  = 'k';
        Instance->NicName[3]  = (UINT16) ('0' + Index);
        Instance->NicName[4]  = 0;
      }

      break;
    }
  }

  if (Index == MAX_IP4_CONFIG_IN_VARIABLE) {
    Status = EFI_OUT_OF_RESOURCES;
    goto ON_ERROR;
  }
  
  //
  // Install the IP4_CONFIG and NIC_IP4CONFIG protocols
  //
  Status = gBS->InstallMultipleProtocolInterfaces (
                  &ControllerHandle,
                  &gEfiIp4ConfigProtocolGuid,
                  &Instance->Ip4ConfigProtocol,
                  &gEfiNicIp4ConfigProtocolGuid,
                  &Instance->NicIp4Protocol,
                  NULL
                  );

  if (EFI_ERROR (Status)) {
    mIp4ConfigNicList[Index] = NULL;
    goto ON_ERROR;
  }
  
  //
  // Get the previous configure parameters. If an error happend here, 
  // just ignore it because the driver should be able to operate. 
  //
  Variable = Ip4ConfigReadVariable ();

  if (Variable == NULL) {
    return EFI_SUCCESS;
  }

  NicConfig = Ip4ConfigFindNicVariable (Variable, &Instance->NicAddr);

  if (NicConfig == NULL) {
    goto ON_EXIT;
  }
  
  //
  // Don't modify the permant static configuration
  //
  if (NicConfig->Perment && (NicConfig->Source == IP4_CONFIG_SOURCE_STATIC)) {
    goto ON_EXIT;
  }
  
  //
  // Delete the non-permant configuration and remove the previous
  // acquired DHCP parameters. Only doing DHCP itself is permant
  //
  NewVariable = NULL;

  if (!NicConfig->Perment) {
    NewVariable = Ip4ConfigModifyVariable (Variable, &Instance->NicAddr, NULL);
    
  } else if (NicConfig->Source == IP4_CONFIG_SOURCE_DHCP) {
    NetZeroMem (&NicConfig->Ip4Info, sizeof (EFI_IP4_IPCONFIG_DATA));
    NewVariable = Ip4ConfigModifyVariable (Variable, &Instance->NicAddr, NicConfig);
    
  }

  Ip4ConfigWriteVariable (NewVariable);

  if (NewVariable != NULL) {
    NetFreePool (NewVariable);
  }

ON_EXIT:
  NetFreePool (Variable);

  if (NicConfig != NULL) {
    NetFreePool (NicConfig);
  }

  return EFI_SUCCESS;

ON_ERROR:
  if (Instance != NULL) {
    NetFreePool (Instance);
  }

  if (Mnp != NULL) {
    gBS->CloseProtocol (
          MnpHandle,
          &gEfiManagedNetworkProtocolGuid,
          This->DriverBindingHandle,
          ControllerHandle
          );
  }

  NetLibDestroyServiceChild (
    ControllerHandle,
    This->DriverBindingHandle,
    &gEfiManagedNetworkProtocolGuid,
    MnpHandle
    );

  return Status;
}

EFI_STATUS
EFIAPI
Ip4ConfigDriverBindingStop (
  IN EFI_DRIVER_BINDING_PROTOCOL  *This,
  IN EFI_HANDLE                   ControllerHandle,
  IN UINTN                        NumberOfChildren,
  IN EFI_HANDLE                   *ChildHandleBuffer
  )
/*++
 
  Routine Description:
    Stop this driver on ControllerHandle.
 
  Arguments:
    This              - Protocol instance pointer.
    ControllerHandle  - Handle of device to stop driver on 
    NumberOfChildren  - Number of Handles in ChildHandleBuffer. If number of 
                        children is zero stop the entire bus driver.
    ChildHandleBuffer - List of Child Handles to Stop.
 
  Returns:
    EFI_SUCCES          - This driver is removed ControllerHandle
    other               - This driver was not removed from this device
 
--*/
{
  IP4_CONFIG_INSTANCE       *Instance;
  EFI_IP4_CONFIG_PROTOCOL   *Ip4Config;
  EFI_HANDLE                NicHandle;
  EFI_STATUS                Status;

  //
  // IP4_CONFIG instance opens an MNP child. It may also create and open
  // a DHCP child. If this is the DHCP handle, stop the DHCP process. If
  // it is the MNP child, stop the whole driver.
  //
  //
  NicHandle = NetLibGetNicHandle (ControllerHandle, &gEfiDhcp4ProtocolGuid);

  if (NicHandle != NULL) {
    //
    // Get our context back then clean the DHCP up. Notify the user if necessary.
    //
    Status = gBS->OpenProtocol (
                    NicHandle,
                    &gEfiIp4ConfigProtocolGuid,
                    (VOID **) &Ip4Config,
                    This->DriverBindingHandle,
                    ControllerHandle,
                    EFI_OPEN_PROTOCOL_GET_PROTOCOL
                    );

    if (EFI_ERROR (Status)) {
      return Status;
    }

    Instance = IP4_CONFIG_INSTANCE_FROM_IP4CONFIG (Ip4Config);
    ASSERT (ControllerHandle == Instance->Dhcp4Handle);

    Ip4ConfigCleanDhcp4 (Instance);

    Instance->State   = IP4_CONFIG_STATE_CONFIGURED;
    Instance->Result  = EFI_DEVICE_ERROR;

    if (Instance->DoneEvent != NULL) {
      gBS->SignalEvent (Instance->DoneEvent);
    }

    return EFI_SUCCESS;
  }
  
  //
  // This is a MNP handle, stop the whole driver
  //
  NicHandle = NetLibGetNicHandle (ControllerHandle, &gEfiManagedNetworkProtocolGuid);

  if (NicHandle == NULL) {
    return EFI_SUCCESS;
  }
  
  //
  // Get our context back.
  //
  Status = gBS->OpenProtocol (
                  NicHandle,
                  &gEfiIp4ConfigProtocolGuid,
                  (VOID **) &Ip4Config,
                  This->DriverBindingHandle,
                  ControllerHandle,
                  EFI_OPEN_PROTOCOL_GET_PROTOCOL
                  );

  if (EFI_ERROR (Status)) {
    return Status;
  }

  Instance = IP4_CONFIG_INSTANCE_FROM_IP4CONFIG (Ip4Config);

  //
  // Unload the protocols first to inform the top drivers
  //
  Status = gBS->UninstallMultipleProtocolInterfaces (
                  NicHandle,
                  &gEfiIp4ConfigProtocolGuid,
                  &Instance->Ip4ConfigProtocol,
                  &gEfiNicIp4ConfigProtocolGuid,
                  &Instance->NicIp4Protocol,
                  NULL
                  );

  if (EFI_ERROR (Status)) {
    return Status;
  }
  
  //
  // Release all the resources
  //
  if (Instance->MnpHandle != NULL) {
    gBS->CloseProtocol (
          Instance->MnpHandle,
          &gEfiManagedNetworkProtocolGuid,
          This->DriverBindingHandle,
          NicHandle
          );

    NetLibDestroyServiceChild (
      NicHandle,
      Instance->Image,
      &gEfiManagedNetworkServiceBindingProtocolGuid,
      Instance->MnpHandle
      );

    Instance->Mnp       = NULL;
    Instance->MnpHandle = NULL;
  }

  Ip4ConfigCleanConfig (Instance);
  mIp4ConfigNicList[Instance->NicIndex] = NULL;
  NetFreePool (Instance);

  return EFI_SUCCESS;
}

EFI_DRIVER_BINDING_PROTOCOL gIp4ConfigDriverBinding = {
  Ip4ConfigDriverBindingSupported,
  Ip4ConfigDriverBindingStart,
  Ip4ConfigDriverBindingStop,
  0x10,
  NULL,
  NULL
};