/** @file\r
The entry point of IScsi driver.\r
\r
-Copyright (c) 2004 - 2008, Intel Corporation.<BR>\r
-All rights reserved. This program and the accompanying materials\r
+Copyright (c) 2004 - 2010, Intel Corporation. All rights reserved.<BR>\r
+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
NULL\r
};\r
\r
-EFI_GUID mIScsiPrivateGuid = ISCSI_PRIVATE_GUID;\r
+EFI_GUID gIScsiPrivateGuid = ISCSI_PRIVATE_GUID;\r
\r
\r
/**\r
\r
Status = gBS->OpenProtocol (\r
ControllerHandle,\r
- &mIScsiPrivateGuid,\r
+ &gIScsiPrivateGuid,\r
NULL,\r
This->DriverBindingHandle,\r
ControllerHandle,\r
}\r
\r
/**\r
- Start this driver on ControllerHandle. The Start() function is designed to be \r
- invoked from the EFI boot service ConnectController(). As a result, much of \r
- the error checking on the parameters to Start() has been moved into this \r
- common boot service. It is legal to call Start() from other locations, \r
- but the following calling restrictions must be followed or the system behavior will not be deterministic.\r
+ Start this driver on ControllerHandle. \r
+ \r
+ The Start() function is designed to be invoked from the EFI boot service ConnectController(). \r
+ As a result, much of the error checking on the parameters to Start() has been moved into this \r
+ common boot service. It is legal to call Start() from other locations, but the following calling \r
+ restrictions must be followed or the system behavior will not be deterministic.\r
1. ControllerHandle must be a valid EFI_HANDLE.\r
2. If RemainingDevicePath is not NULL, then it must be a pointer to a naturally aligned\r
EFI_DEVICE_PATH_PROTOCOL.\r
{\r
EFI_STATUS Status;\r
ISCSI_DRIVER_DATA *Private;\r
+ VOID *Interface;\r
+\r
+ Private = IScsiCreateDriverData (This->DriverBindingHandle, ControllerHandle);\r
+ if (Private == NULL) {\r
+ return EFI_OUT_OF_RESOURCES;\r
+ }\r
+\r
+ //\r
+ // Create a underlayer child instance, but not need to configure it. Just open ChildHandle\r
+ // via BY_DRIVER. That is, establishing the relationship between ControllerHandle and ChildHandle.\r
+ // Therefore, when DisconnectController(), especially VLAN virtual controller handle,\r
+ // IScsiDriverBindingStop() will be called.\r
+ //\r
+ Status = NetLibCreateServiceChild (\r
+ ControllerHandle,\r
+ This->DriverBindingHandle,\r
+ &gEfiTcp4ServiceBindingProtocolGuid,\r
+ &Private->ChildHandle\r
+ );\r
+\r
+ if (EFI_ERROR (Status)) {\r
+ goto ON_ERROR;\r
+ }\r
+\r
+ Status = gBS->OpenProtocol (\r
+ Private->ChildHandle,\r
+ &gEfiTcp4ProtocolGuid,\r
+ &Interface,\r
+ This->DriverBindingHandle,\r
+ ControllerHandle,\r
+ EFI_OPEN_PROTOCOL_BY_DRIVER\r
+ );\r
+ if (EFI_ERROR (Status)) {\r
+ goto ON_ERROR;\r
+ }\r
+\r
+ //
+ // Always install private protocol no matter what happens later. We need to \r
+ // keep the relationship between ControllerHandle and ChildHandle.\r
+ //\r
+ Status = gBS->InstallProtocolInterface (\r
+ &ControllerHandle,\r
+ &gIScsiPrivateGuid,\r
+ EFI_NATIVE_INTERFACE,\r
+ &Private->IScsiIdentifier\r
+ );\r
+ if (EFI_ERROR (Status)) {\r
+ goto ON_ERROR;\r
+ }\r
\r
//\r
// Try to add a port configuration page for this controller.\r
//\r
IScsiConfigUpdateForm (This->DriverBindingHandle, ControllerHandle, TRUE);\r
\r
- Private = IScsiCreateDriverData (This->DriverBindingHandle, ControllerHandle);\r
- if (Private == NULL) {\r
- return EFI_OUT_OF_RESOURCES;\r
- }\r
//\r
// Get the iSCSI configuration data of this controller.\r
//\r
if (EFI_ERROR (Status)) {\r
goto ON_ERROR;\r
}\r
- //\r
- // Install the iSCSI private stuff as a flag to indicate this controller\r
- // is already controlled by iSCSI driver.\r
- //\r
- Status = gBS->InstallProtocolInterface (\r
- &ControllerHandle,\r
- &mIScsiPrivateGuid,\r
- EFI_NATIVE_INTERFACE,\r
- &Private->IScsiIdentifier\r
- );\r
- if (EFI_ERROR (Status)) {\r
- goto ON_ERROR;\r
- }\r
+\r
//\r
// Update/Publish the iSCSI Boot Firmware Table.\r
//\r
ON_ERROR:\r
\r
IScsiSessionAbort (&Private->Session);\r
- IScsiCleanDriverData (Private);\r
\r
return Status;\r
}\r
IN EFI_DRIVER_BINDING_PROTOCOL *This,\r
IN EFI_HANDLE ControllerHandle,\r
IN UINTN NumberOfChildren,\r
- IN EFI_HANDLE *ChildHandleBuffer\r
+ IN EFI_HANDLE *ChildHandleBuffer OPTIONAL\r
)\r
{\r
EFI_HANDLE IScsiController;\r
\r
Status = gBS->OpenProtocol (\r
IScsiController,\r
- &mIScsiPrivateGuid,\r
+ &gIScsiPrivateGuid,\r
(VOID **)&IScsiIdentifier,\r
This->DriverBindingHandle,\r
ControllerHandle,\r
\r
Private = ISCSI_DRIVER_DATA_FROM_IDENTIFIER (IScsiIdentifier);\r
\r
+ if (Private->ChildHandle != NULL) {\r
+ Status = gBS->CloseProtocol (\r
+ Private->ChildHandle,\r
+ &gEfiTcp4ProtocolGuid,\r
+ This->DriverBindingHandle,\r
+ IScsiController\r
+ );\r
+\r
+ ASSERT (!EFI_ERROR (Status));\r
+\r
+ Status = NetLibDestroyServiceChild (\r
+ IScsiController,\r
+ This->DriverBindingHandle,\r
+ &gEfiTcp4ServiceBindingProtocolGuid,\r
+ Private->ChildHandle\r
+ );\r
+ ASSERT (!EFI_ERROR (Status));\r
+ }\r
+\r
+ IScsiConfigUpdateForm (This->DriverBindingHandle, IScsiController, FALSE);\r
+\r
//\r
// Uninstall the private protocol.\r
//\r
gBS->UninstallProtocolInterface (\r
IScsiController,\r
- &mIScsiPrivateGuid,\r
+ &gIScsiPrivateGuid,\r
&Private->IScsiIdentifier\r
);\r
\r
}\r
\r
if (DeviceHandleBuffer != NULL) {\r
- gBS->FreePool (DeviceHandleBuffer);\r
+ FreePool (DeviceHandleBuffer);\r
}\r
}\r
//\r