diff options
Diffstat (limited to 'NetworkPkg/Dhcp6Dxe/Dhcp6Impl.c')
| -rw-r--r-- | NetworkPkg/Dhcp6Dxe/Dhcp6Impl.c | 1216 |
1 files changed, 0 insertions, 1216 deletions
diff --git a/NetworkPkg/Dhcp6Dxe/Dhcp6Impl.c b/NetworkPkg/Dhcp6Dxe/Dhcp6Impl.c deleted file mode 100644 index d8c0ad0d24..0000000000 --- a/NetworkPkg/Dhcp6Dxe/Dhcp6Impl.c +++ /dev/null @@ -1,1216 +0,0 @@ -/** @file
- This EFI_DHCP6_PROTOCOL interface implementation.
-
- Copyright (c) 2009 - 2012, Intel Corporation. All rights reserved.<BR>
-
- 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.
-
-**/
-
-#include "Dhcp6Impl.h"
-
-//
-// Well-known multi-cast address defined in section-24.1 of rfc-3315
-//
-// ALL_DHCP_Relay_Agents_and_Servers address: FF02::1:2
-// ALL_DHCP_Servers address: FF05::1:3
-//
-EFI_IPv6_ADDRESS mAllDhcpRelayAndServersAddress = {{0xFF, 2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 2}};
-EFI_IPv6_ADDRESS mAllDhcpServersAddress = {{0xFF, 5, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 3}};
-
-EFI_DHCP6_PROTOCOL gDhcp6ProtocolTemplate = {
- EfiDhcp6GetModeData,
- EfiDhcp6Configure,
- EfiDhcp6Start,
- EfiDhcp6InfoRequest,
- EfiDhcp6RenewRebind,
- EfiDhcp6Decline,
- EfiDhcp6Release,
- EfiDhcp6Stop,
- EfiDhcp6Parse
-};
-
-/**
- Starts the DHCPv6 standard S.A.R.R. process.
-
- The Start() function starts the DHCPv6 standard process. This function can
- be called only when the state of Dhcp6 instance is in the Dhcp6Init state.
- If the DHCP process completes successfully, the state of the Dhcp6 instance
- will be transferred through Dhcp6Selecting and Dhcp6Requesting to the
- Dhcp6Bound state.
- Refer to rfc-3315 for precise state transitions during this process. At the
- time when each event occurs in this process, the callback function that was set
- by EFI_DHCP6_PROTOCOL.Configure() will be called, and the user can take this
- opportunity to control the process.
-
- @param[in] This The pointer to Dhcp6 protocol.
-
- @retval EFI_SUCCESS The DHCPv6 standard process has started, or it has
- completed when CompletionEvent is NULL.
- @retval EFI_ACCESS_DENIED The EFI DHCPv6 Child instance hasn't been configured.
- @retval EFI_INVALID_PARAMETER This is NULL.
- @retval EFI_OUT_OF_RESOURCES Required system resources could not be allocated.
- @retval EFI_TIMEOUT The DHCPv6 configuration process failed because no
- response was received from the server within the
- specified timeout value.
- @retval EFI_ABORTED The user aborted the DHCPv6 process.
- @retval EFI_ALREADY_STARTED Some other Dhcp6 instance already started the DHCPv6
- standard process.
- @retval EFI_DEVICE_ERROR An unexpected system or network error occurred.
- @retval EFI_NO_MEDIA There was a media error.
-
-**/
-EFI_STATUS
-EFIAPI
-EfiDhcp6Start (
- IN EFI_DHCP6_PROTOCOL *This
- )
-{
- EFI_STATUS Status;
- EFI_TPL OldTpl;
- DHCP6_INSTANCE *Instance;
- DHCP6_SERVICE *Service;
-
- if (This == NULL) {
- return EFI_INVALID_PARAMETER;
- }
-
- Instance = DHCP6_INSTANCE_FROM_THIS (This);
- Service = Instance->Service;
-
- //
- // The instance hasn't been configured.
- //
- if (Instance->Config == NULL) {
- return EFI_ACCESS_DENIED;
- }
-
- ASSERT (Instance->IaCb.Ia != NULL);
-
- //
- // The instance has already been started.
- //
- if (Instance->IaCb.Ia->State != Dhcp6Init) {
- return EFI_ALREADY_STARTED;
- }
-
- OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
- Instance->UdpSts = EFI_ALREADY_STARTED;
-
- //
- // Send the solicit message to start S.A.R.R process.
- //
- Status = Dhcp6SendSolicitMsg (Instance);
-
- if (EFI_ERROR (Status)) {
- goto ON_ERROR;
- }
-
- //
- // Register receive callback for the stateful exchange process.
- //
- Status = UdpIoRecvDatagram(
- Service->UdpIo,
- Dhcp6ReceivePacket,
- Service,
- 0
- );
-
- if (EFI_ERROR (Status) && (Status != EFI_ALREADY_STARTED)) {
- goto ON_ERROR;
- }
-
- gBS->RestoreTPL (OldTpl);
-
- //
- // Poll udp out of the net tpl if synchronous call.
- //
- if (Instance->Config->IaInfoEvent == NULL) {
-
- while (Instance->UdpSts == EFI_ALREADY_STARTED) {
- Service->UdpIo->Protocol.Udp6->Poll (Service->UdpIo->Protocol.Udp6);
- }
- return Instance->UdpSts;
- }
-
- return EFI_SUCCESS;
-
-ON_ERROR:
-
- gBS->RestoreTPL (OldTpl);
- return Status;
-}
-
-
-/**
- Stops the DHCPv6 standard S.A.R.R. process.
-
- The Stop() function is used to stop the DHCPv6 standard process. After this
- function is called successfully, the state of Dhcp6 instance is transferred
- into Dhcp6Init. EFI_DHCP6_PROTOCOL.Configure() needs to be called
- before DHCPv6 standard process can be started again. This function can be
- called when the Dhcp6 instance is in any state.
-
- @param[in] This The pointer to the Dhcp6 protocol.
-
- @retval EFI_SUCCESS The Dhcp6 instance is now in the Dhcp6Init state.
- @retval EFI_INVALID_PARAMETER This is NULL.
-
-**/
-EFI_STATUS
-EFIAPI
-EfiDhcp6Stop (
- IN EFI_DHCP6_PROTOCOL *This
- )
-{
- EFI_TPL OldTpl;
- EFI_STATUS Status;
- EFI_UDP6_PROTOCOL *Udp6;
- DHCP6_INSTANCE *Instance;
- DHCP6_SERVICE *Service;
-
- if (This == NULL) {
- return EFI_INVALID_PARAMETER;
- }
-
- Instance = DHCP6_INSTANCE_FROM_THIS (This);
- Service = Instance->Service;
- Udp6 = Service->UdpIo->Protocol.Udp6;
- Status = EFI_SUCCESS;
-
- //
- // The instance hasn't been configured.
- //
- if (Instance->Config == NULL) {
- return Status;
- }
-
- ASSERT (Instance->IaCb.Ia != NULL);
-
- //
- // No valid REPLY message received yet, cleanup this instance directly.
- //
- if (Instance->IaCb.Ia->State == Dhcp6Init ||
- Instance->IaCb.Ia->State == Dhcp6Selecting ||
- Instance->IaCb.Ia->State == Dhcp6Requesting
- ) {
- goto ON_EXIT;
- }
-
- //
- // Release the current ready Ia.
- //
- OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
-
- Instance->UdpSts = EFI_ALREADY_STARTED;
- Status = Dhcp6SendReleaseMsg (Instance, Instance->IaCb.Ia);
- gBS->RestoreTPL (OldTpl);
- if (EFI_ERROR (Status)) {
- goto ON_EXIT;
- }
-
- //
- // Poll udp out of the net tpl if synchoronus call.
- //
- if (Instance->Config->IaInfoEvent == NULL) {
- ASSERT (Udp6 != NULL);
- while (Instance->UdpSts == EFI_ALREADY_STARTED) {
- Udp6->Poll (Udp6);
- }
- Status = Instance->UdpSts;
- }
-
-ON_EXIT:
- //
- // Clean up the session data for the released Ia.
- //
- OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
- Dhcp6CleanupSession (Instance, EFI_SUCCESS);
- gBS->RestoreTPL (OldTpl);
-
- return Status;
-}
-
-
-/**
- Returns the current operating mode data for the Dhcp6 instance.
-
- The GetModeData() function returns the current operating mode and
- cached data packet for the Dhcp6 instance.
-
- @param[in] This The pointer to the Dhcp6 protocol.
- @param[out] Dhcp6ModeData The pointer to the Dhcp6 mode data.
- @param[out] Dhcp6ConfigData The pointer to the Dhcp6 configure data.
-
- @retval EFI_SUCCESS The mode data was returned.
- @retval EFI_INVALID_PARAMETER This is NULL.
- @retval EFI_ACCESS_DENIED The EFI DHCPv6 Protocol instance was not
- configured.
-**/
-EFI_STATUS
-EFIAPI
-EfiDhcp6GetModeData (
- IN EFI_DHCP6_PROTOCOL *This,
- OUT EFI_DHCP6_MODE_DATA *Dhcp6ModeData OPTIONAL,
- OUT EFI_DHCP6_CONFIG_DATA *Dhcp6ConfigData OPTIONAL
- )
-{
- EFI_TPL OldTpl;
- EFI_DHCP6_IA *Ia;
- DHCP6_INSTANCE *Instance;
- DHCP6_SERVICE *Service;
- UINT32 IaSize;
- UINT32 IdSize;
-
- if (This == NULL || (Dhcp6ModeData == NULL && Dhcp6ConfigData == NULL)) {
- return EFI_INVALID_PARAMETER;
- }
-
- Instance = DHCP6_INSTANCE_FROM_THIS (This);
- Service = Instance->Service;
-
- if (Instance->Config == NULL && Dhcp6ConfigData != NULL) {
- return EFI_ACCESS_DENIED;
- }
-
- ASSERT (Service->ClientId != NULL);
-
- OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
-
- //
- // User needs a copy of instance config data.
- //
- if (Dhcp6ConfigData != NULL) {
- ZeroMem (Dhcp6ConfigData, sizeof(EFI_DHCP6_CONFIG_DATA));
- //
- // Duplicate config data, including all reference buffers.
- //
- if (EFI_ERROR (Dhcp6CopyConfigData (Dhcp6ConfigData, Instance->Config))) {
- goto ON_ERROR;
- }
- }
-
- //
- // User need a copy of instance mode data.
- //
- if (Dhcp6ModeData != NULL) {
- ZeroMem (Dhcp6ModeData, sizeof (EFI_DHCP6_MODE_DATA));
- //
- // Duplicate a copy of EFI_DHCP6_DUID for client Id.
- //
- IdSize = Service->ClientId->Length + sizeof (Service->ClientId->Length);
-
- Dhcp6ModeData->ClientId = AllocateZeroPool (IdSize);
- if (Dhcp6ModeData->ClientId == NULL) {
- goto ON_ERROR;
- }
-
- CopyMem (
- Dhcp6ModeData->ClientId,
- Service->ClientId,
- IdSize
- );
-
- Ia = Instance->IaCb.Ia;
- if (Ia != NULL) {
- //
- // Duplicate a copy of EFI_DHCP6_IA for configured Ia.
- //
- IaSize = sizeof (EFI_DHCP6_IA) + (Ia->IaAddressCount -1) * sizeof (EFI_DHCP6_IA_ADDRESS);
-
- Dhcp6ModeData->Ia = AllocateZeroPool (IaSize);
- if (Dhcp6ModeData->Ia == NULL) {
- goto ON_ERROR;
- }
-
- CopyMem (
- Dhcp6ModeData->Ia,
- Ia,
- IaSize
- );
-
- //
- // Duplicate a copy of reply packet if has.
- //
- if (Ia->ReplyPacket != NULL) {
- Dhcp6ModeData->Ia->ReplyPacket = AllocateZeroPool (Ia->ReplyPacket->Size);
- if (Dhcp6ModeData->Ia->ReplyPacket == NULL) {
- goto ON_ERROR;
- }
- CopyMem (
- Dhcp6ModeData->Ia->ReplyPacket,
- Ia->ReplyPacket,
- Ia->ReplyPacket->Size
- );
- }
- }
- }
-
- gBS->RestoreTPL (OldTpl);
-
- return EFI_SUCCESS;
-
-ON_ERROR:
-
- if (Dhcp6ConfigData != NULL) {
- Dhcp6CleanupConfigData (Dhcp6ConfigData);
- }
- if (Dhcp6ModeData != NULL) {
- Dhcp6CleanupModeData (Dhcp6ModeData);
- }
- gBS->RestoreTPL (OldTpl);
-
- return EFI_OUT_OF_RESOURCES;
-}
-
-
-/**
- Initializes, changes, or resets the operational settings for the Dhcp6 instance.
-
- The Configure() function is used to initialize or clean up the configuration
- data of the Dhcp6 instance:
- - When Dhcp6CfgData is not NULL and Configure() is called successfully, the
- configuration data will be initialized in the Dhcp6 instance, and the state
- of the configured IA will be transferred into Dhcp6Init.
- - When Dhcp6CfgData is NULL and Configure() is called successfully, the
- configuration data will be cleaned up and no IA will be associated with
- the Dhcp6 instance.
- To update the configuration data for an Dhcp6 instance, the original data
- must be cleaned up before setting the new configuration data.
-
- @param[in] This The pointer to the Dhcp6 protocol
- @param[in] Dhcp6CfgData The pointer to the EFI_DHCP6_CONFIG_DATA.
-
- @retval EFI_SUCCESS The Dhcp6 is configured successfully with the
- Dhcp6Init state, or cleaned up the original
- configuration setting.
- @retval EFI_ACCESS_DENIED The Dhcp6 instance was already configured.
- The Dhcp6 instance has already started the
- DHCPv6 S.A.R.R when Dhcp6CfgData is NULL.
- @retval EFI_INVALID_PARAMETER Some of the parameter is invalid.
- @retval EFI_OUT_OF_RESOURCES Required system resources could not be allocated.
- @retval EFI_DEVICE_ERROR An unexpected system or network error occurred.
-
-**/
-EFI_STATUS
-EFIAPI
-EfiDhcp6Configure (
- IN EFI_DHCP6_PROTOCOL *This,
- IN EFI_DHCP6_CONFIG_DATA *Dhcp6CfgData OPTIONAL
- )
-{
- EFI_TPL OldTpl;
- EFI_STATUS Status;
- LIST_ENTRY *Entry;
- DHCP6_INSTANCE *Other;
- DHCP6_INSTANCE *Instance;
- DHCP6_SERVICE *Service;
- UINTN Index;
-
- if (This == NULL) {
- return EFI_INVALID_PARAMETER;
- }
-
- Instance = DHCP6_INSTANCE_FROM_THIS (This);
- Service = Instance->Service;
-
- //
- // Check the parameter of configure data.
- //
- if (Dhcp6CfgData != NULL) {
- if (Dhcp6CfgData->OptionCount > 0 && Dhcp6CfgData->OptionList == NULL) {
- return EFI_INVALID_PARAMETER;
- }
- if (Dhcp6CfgData->OptionList != NULL) {
- for (Index = 0; Index < Dhcp6CfgData->OptionCount; Index++) {
- if (Dhcp6CfgData->OptionList[Index]->OpCode == Dhcp6OptClientId ||
- Dhcp6CfgData->OptionList[Index]->OpCode == Dhcp6OptRapidCommit ||
- Dhcp6CfgData->OptionList[Index]->OpCode == Dhcp6OptReconfigureAccept ||
- Dhcp6CfgData->OptionList[Index]->OpCode == Dhcp6OptIana ||
- Dhcp6CfgData->OptionList[Index]->OpCode == Dhcp6OptIata
- ) {
- return EFI_INVALID_PARAMETER;
- }
- }
- }
-
- if (Dhcp6CfgData->IaDescriptor.Type != EFI_DHCP6_IA_TYPE_NA &&
- Dhcp6CfgData->IaDescriptor.Type != EFI_DHCP6_IA_TYPE_TA
- ) {
- return EFI_INVALID_PARAMETER;
- }
-
- if (Dhcp6CfgData->IaInfoEvent == NULL && Dhcp6CfgData->SolicitRetransmission == NULL) {
- return EFI_INVALID_PARAMETER;
- }
-
- if (Dhcp6CfgData->SolicitRetransmission != NULL &&
- Dhcp6CfgData->SolicitRetransmission->Mrc == 0 &&
- Dhcp6CfgData->SolicitRetransmission->Mrd == 0
- ) {
- return EFI_INVALID_PARAMETER;
- }
-
- //
- // Make sure the (IaId, IaType) is unique over all the instances.
- //
- NET_LIST_FOR_EACH (Entry, &Service->Child) {
- Other = NET_LIST_USER_STRUCT (Entry, DHCP6_INSTANCE, Link);
- if (Other->IaCb.Ia != NULL &&
- Other->IaCb.Ia->Descriptor.Type == Dhcp6CfgData->IaDescriptor.Type &&
- Other->IaCb.Ia->Descriptor.IaId == Dhcp6CfgData->IaDescriptor.IaId
- ) {
- return EFI_INVALID_PARAMETER;
- }
- }
- }
-
- OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
-
- if (Dhcp6CfgData != NULL) {
- //
- // It's not allowed to configure one instance twice without configure null.
- //
- if (Instance->Config != NULL) {
- gBS->RestoreTPL (OldTpl);
- return EFI_ACCESS_DENIED;
- }
-
- //
- // Duplicate config data including all reference buffers.
- //
- Instance->Config = AllocateZeroPool (sizeof (EFI_DHCP6_CONFIG_DATA));
- if (Instance->Config == NULL) {
- gBS->RestoreTPL (OldTpl);
- return EFI_OUT_OF_RESOURCES;
- }
-
- Status = Dhcp6CopyConfigData (Instance->Config, Dhcp6CfgData);
- if (EFI_ERROR(Status)) {
- FreePool (Instance->Config);
- gBS->RestoreTPL (OldTpl);
- return EFI_OUT_OF_RESOURCES;
- }
-
- //
- // Initialize the Ia descriptor from the config data, and leave the other
- // fields of the Ia as default value 0.
- //
- Instance->IaCb.Ia = AllocateZeroPool (sizeof(EFI_DHCP6_IA));
- if (Instance->IaCb.Ia == NULL) {
- Dhcp6CleanupConfigData (Instance->Config);
- FreePool (Instance->Config);
- gBS->RestoreTPL (OldTpl);
- return EFI_OUT_OF_RESOURCES;
- }
- CopyMem (
- &Instance->IaCb.Ia->Descriptor,
- &Dhcp6CfgData->IaDescriptor,
- sizeof(EFI_DHCP6_IA_DESCRIPTOR)
- );
-
- } else {
-
- if (Instance->Config == NULL) {
- ASSERT (Instance->IaCb.Ia == NULL);
- gBS->RestoreTPL (OldTpl);
- return EFI_SUCCESS;
- }
-
- //
- // It's not allowed to configure a started instance as null.
- //
- if (Instance->IaCb.Ia->State != Dhcp6Init) {
- gBS->RestoreTPL (OldTpl);
- return EFI_ACCESS_DENIED;
- }
-
- Dhcp6CleanupConfigData (Instance->Config);
- FreePool (Instance->Config);
- Instance->Config = NULL;
-
- FreePool (Instance->IaCb.Ia);
- Instance->IaCb.Ia = NULL;
- }
-
- gBS->RestoreTPL (OldTpl);
-
- return EFI_SUCCESS;
-}
-
-
-/**
- Request configuration information without the assignment of any
- Ia addresses of the client.
-
- The InfoRequest() function is used to request configuration information
- without the assignment of any IPv6 address of the client. The client sends
- out an Information Request packet to obtain the required configuration
- information, and DHCPv6 server responds with a Reply packet containing
- the information for the client. The received Reply packet will be passed
- to the user by ReplyCallback function. If the user returns EFI_NOT_READY from
- ReplyCallback, the Dhcp6 instance will continue to receive other Reply
- packets unless timeout according to the Retransmission parameter.
- Otherwise, the Information Request exchange process will be finished
- successfully if user returns EFI_SUCCESS from ReplyCallback.
-
- @param[in] This The pointer to the Dhcp6 protocol.
- @param[in] SendClientId If TRUE, the DHCPv6 protocol instance will build Client
- Identifier option and include it into Information Request
- packet. Otherwise, Client Identifier option will not be included.
- @param[in] OptionRequest The pointer to the buffer of option request options.
- @param[in] OptionCount The option number in the OptionList.
- @param[in] OptionList The list of appended options.
- @param[in] Retransmission The pointer to the retransmission of the message.
- @param[in] TimeoutEvent The event of timeout.
- @param[in] ReplyCallback The callback function when the reply was received.
- @param[in] CallbackContext The pointer to the parameter passed to the callback.
-
- @retval EFI_SUCCESS The DHCPv6 information request exchange process
- completed when TimeoutEvent is NULL. Information
- Request packet has been sent to DHCPv6 server when
- TimeoutEvent is not NULL.
- @retval EFI_NO_RESPONSE The DHCPv6 information request exchange process failed
- because of no response, or not all requested-options
- are responded by DHCPv6 servers when Timeout happened.
- @retval EFI_ABORTED The DHCPv6 information request exchange process was aborted
- by user.
- @retval EFI_INVALID_PARAMETER Some parameter is NULL.
- @retval EFI_OUT_OF_RESOURCES Required system resources could not be allocated.
- @retval EFI_DEVICE_ERROR An unexpected system or network error occurred.
-
-**/
-EFI_STATUS
-EFIAPI
-EfiDhcp6InfoRequest (
- IN EFI_DHCP6_PROTOCOL *This,
- IN BOOLEAN SendClientId,
- IN EFI_DHCP6_PACKET_OPTION *OptionRequest,
- IN UINT32 OptionCount,
- IN EFI_DHCP6_PACKET_OPTION *OptionList[] OPTIONAL,
- IN EFI_DHCP6_RETRANSMISSION *Retransmission,
- IN EFI_EVENT TimeoutEvent OPTIONAL,
- IN EFI_DHCP6_INFO_CALLBACK ReplyCallback,
- IN VOID *CallbackContext OPTIONAL
- )
-{
- EFI_STATUS Status;
- DHCP6_INSTANCE *Instance;
- DHCP6_SERVICE *Service;
- UINTN Index;
- EFI_EVENT Timer;
- EFI_STATUS TimerStatus;
- UINTN GetMappingTimeOut;
-
- if (This == NULL || OptionRequest == NULL || Retransmission == NULL || ReplyCallback == NULL) {
- return EFI_INVALID_PARAMETER;
- }
-
- if (Retransmission != NULL && Retransmission->Mrc == 0 && Retransmission->Mrd == 0) {
- return EFI_INVALID_PARAMETER;
- }
-
- if (OptionCount > 0 && OptionList == NULL) {
- return EFI_INVALID_PARAMETER;
- }
-
- if (OptionList != NULL) {
- for (Index = 0; Index < OptionCount; Index++) {
- if (OptionList[Index]->OpCode == Dhcp6OptClientId || OptionList[Index]->OpCode == Dhcp6OptRequestOption) {
- return EFI_INVALID_PARAMETER;
- }
- }
- }
-
- Instance = DHCP6_INSTANCE_FROM_THIS (This);
- Service = Instance->Service;
-
- Status = Dhcp6StartInfoRequest (
- Instance,
- SendClientId,
- OptionRequest,
- OptionCount,
- OptionList,
- Retransmission,
- TimeoutEvent,
- ReplyCallback,
- CallbackContext
- );
- if (Status == EFI_NO_MAPPING) {
- //
- // The link local address is not ready, wait for some time and restart
- // the DHCP6 information request process.
- //
- Status = Dhcp6GetMappingTimeOut(Service->Ip6Cfg, &GetMappingTimeOut);
- if (EFI_ERROR(Status)) {
- return Status;
- }
-
- Status = gBS->CreateEvent (EVT_TIMER, TPL_CALLBACK, NULL, NULL, &Timer);
- if (EFI_ERROR (Status)) {
- return Status;
- }
-
- //
- // Start the timer, wait for link local address DAD to finish.
- //
- Status = gBS->SetTimer (Timer, TimerRelative, GetMappingTimeOut);
- if (EFI_ERROR (Status)) {
- gBS->CloseEvent (Timer);
- return Status;
- }
-
- do {
- TimerStatus = gBS->CheckEvent (Timer);
- if (!EFI_ERROR (TimerStatus)) {
- Status = Dhcp6StartInfoRequest (
- Instance,
- SendClientId,
- OptionRequest,
- OptionCount,
- OptionList,
- Retransmission,
- TimeoutEvent,
- ReplyCallback,
- CallbackContext
- );
- }
- } while (TimerStatus == EFI_NOT_READY);
-
- gBS->CloseEvent (Timer);
- }
- if (EFI_ERROR (Status)) {
- return Status;
- }
-
- //
- // Poll udp out of the net tpl if synchoronus call.
- //
- if (TimeoutEvent == NULL) {
-
- while (Instance->UdpSts == EFI_ALREADY_STARTED) {
- Service->UdpIo->Protocol.Udp6->Poll (Service->UdpIo->Protocol.Udp6);
- }
- return Instance->UdpSts;
- }
-
- return EFI_SUCCESS;
-}
-
-
-/**
- Manually extend the valid and preferred lifetimes for the IPv6 addresses
- of the configured IA and update other configuration parameters by sending a
- Renew or Rebind packet.
-
- The RenewRebind() function is used to manually extend the valid and preferred
- lifetimes for the IPv6 addresses of the configured IA, and update other
- configuration parameters by sending Renew or Rebind packet.
- - When RebindRequest is FALSE and the state of the configured IA is Dhcp6Bound,
- it sends Renew packet to the previously DHCPv6 server and transfer the
- state of the configured IA to Dhcp6Renewing. If valid Reply packet received,
- the state transfers to Dhcp6Bound and the valid and preferred timer restarts.
- If fails, the state transfers to Dhcp6Bound, but the timer continues.
- - When RebindRequest is TRUE and the state of the configured IA is Dhcp6Bound,
- it will send a Rebind packet. If valid Reply packet is received, the state transfers
- to Dhcp6Bound and the valid and preferred timer restarts. If it fails, the state
- transfers to Dhcp6Init, and the IA can't be used.
-
- @param[in] This The pointer to the Dhcp6 protocol.
- @param[in] RebindRequest If TRUE, Rebind packet will be sent and enter Dhcp6Rebinding state.
- Otherwise, Renew packet will be sent and enter Dhcp6Renewing state.
-
- @retval EFI_SUCCESS The DHCPv6 renew/rebind exchange process has
- completed and at least one IPv6 address of the
- configured IA has been bound again when
- EFI_DHCP6_CONFIG_DATA.IaInfoEvent is NULL.
- The EFI DHCPv6 Protocol instance has sent Renew
- or Rebind packet when
- EFI_DHCP6_CONFIG_DATA.IaInfoEvent is not NULL.
- @retval EFI_ACCESS_DENIED The Dhcp6 instance hasn't been configured, or the
- state of the configured IA is not in Dhcp6Bound.
- @retval EFI_ALREADY_STARTED The state of the configured IA has already entered
- Dhcp6Renewing when RebindRequest is FALSE.
- The state of the configured IA has already entered
- Dhcp6Rebinding when RebindRequest is TRUE.
- @retval EFI_ABORTED The DHCPv6 renew/rebind exchange process aborted
- by the user.
- @retval EFI_NO_RESPONSE The DHCPv6 renew/rebind exchange process failed
- because of no response.
- @retval EFI_NO_MAPPING No IPv6 address has been bound to the configured
- IA after the DHCPv6 renew/rebind exchange process.
- @retval EFI_INVALID_PARAMETER Some parameter is NULL.
- @retval EFI_DEVICE_ERROR An unexpected system or network error occurred.
-
-**/
-EFI_STATUS
-EFIAPI
-EfiDhcp6RenewRebind (
- IN EFI_DHCP6_PROTOCOL *This,
- IN BOOLEAN RebindRequest
- )
-{
- EFI_STATUS Status;
- EFI_TPL OldTpl;
- DHCP6_INSTANCE *Instance;
- DHCP6_SERVICE *Service;
-
- if (This == NULL) {
- return EFI_INVALID_PARAMETER;
- }
-
- Instance = DHCP6_INSTANCE_FROM_THIS (This);
- Service = Instance->Service;
-
- //
- // The instance hasn't been configured.
- //
- if (Instance->Config == NULL) {
- return EFI_ACCESS_DENIED;
- }
-
- ASSERT (Instance->IaCb.Ia != NULL);
-
- //
- // The instance has already entered renewing or rebinding state.
- //
- if ((Instance->IaCb.Ia->State == Dhcp6Rebinding && RebindRequest) ||
- (Instance->IaCb.Ia->State == Dhcp6Renewing && !RebindRequest)
- ) {
- return EFI_ALREADY_STARTED;
- }
-
- if (Instance->IaCb.Ia->State != Dhcp6Bound) {
- return EFI_ACCESS_DENIED;
- }
-
- OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
- Instance->UdpSts = EFI_ALREADY_STARTED;
-
- //
- // Send renew/rebind message to start exchange process.
- //
- Status = Dhcp6SendRenewRebindMsg (Instance, RebindRequest);
-
- if (EFI_ERROR (Status)) {
- goto ON_ERROR;
- }
-
- //
- // Register receive callback for the stateful exchange process.
- //
- Status = UdpIoRecvDatagram(
- Service->UdpIo,
- Dhcp6ReceivePacket,
- Service,
- 0
- );
-
- if (EFI_ERROR (Status) && (Status != EFI_ALREADY_STARTED)) {
- goto ON_ERROR;
- }
-
- gBS->RestoreTPL (OldTpl);
-
- //
- // Poll udp out of the net tpl if synchoronus call.
- //
- if (Instance->Config->IaInfoEvent == NULL) {
-
- while (Instance->UdpSts == EFI_ALREADY_STARTED) {
- Service->UdpIo->Protocol.Udp6->Poll (Service->UdpIo->Protocol.Udp6);
- }
- return Instance->UdpSts;
- }
-
- return EFI_SUCCESS;
-
-ON_ERROR:
-
- gBS->RestoreTPL (OldTpl);
- return Status;
-}
-
-
-/**
- Inform that one or more addresses assigned by a server are already
- in use by another node.
-
- The Decline() function is used to manually decline the assignment of
- IPv6 addresses, which have been already used by another node. If all
- IPv6 addresses of the configured IA are declined through this function,
- the state of the IA will switch through Dhcp6Declining to Dhcp6Init.
- Otherwise, the state of the IA will restore to Dhcp6Bound after the
- declining process. The Decline() can only be called when the IA is in
- Dhcp6Bound state. If the EFI_DHCP6_CONFIG_DATA.IaInfoEvent is NULL,
- this function is a blocking operation. It will return after the
- declining process finishes, or aborted by user.
-
- @param[in] This The pointer to EFI_DHCP6_PROTOCOL.
- @param[in] AddressCount The number of declining addresses.
- @param[in] Addresses The pointer to the buffer stored the declining
- addresses.
-
- @retval EFI_SUCCESS The DHCPv6 decline exchange process completed
- when EFI_DHCP6_CONFIG_DATA.IaInfoEvent was NULL.
- The Dhcp6 instance sent Decline packet when
- EFI_DHCP6_CONFIG_DATA.IaInfoEvent was not NULL.
- @retval EFI_ACCESS_DENIED The Dhcp6 instance hasn't been configured, or the
- state of the configured IA is not in Dhcp6Bound.
- @retval EFI_ABORTED The DHCPv6 decline exchange process aborted by user.
- @retval EFI_NOT_FOUND Any specified IPv6 address is not correlated with
- the configured IA for this instance.
- @retval EFI_INVALID_PARAMETER Some parameter is NULL.
- @retval EFI_DEVICE_ERROR An unexpected system or network error occurred.
-
-**/
-EFI_STATUS
-EFIAPI
-EfiDhcp6Decline (
- IN EFI_DHCP6_PROTOCOL *This,
- IN UINT32 AddressCount,
- IN EFI_IPv6_ADDRESS *Addresses
- )
-{
- EFI_STATUS Status;
- EFI_TPL OldTpl;
- EFI_DHCP6_IA *DecIa;
- DHCP6_INSTANCE *Instance;
- DHCP6_SERVICE *Service;
-
- if (This == NULL || AddressCount == 0 || Addresses == NULL) {
- return EFI_INVALID_PARAMETER;
- }
-
- Instance = DHCP6_INSTANCE_FROM_THIS (This);
- Service = Instance->Service;
-
- //
- // The instance hasn't been configured.
- //
- if (Instance->Config == NULL) {
- return EFI_ACCESS_DENIED;
- }
-
- ASSERT (Instance->IaCb.Ia != NULL);
-
- if (Instance->IaCb.Ia->State != Dhcp6Bound) {
- return EFI_ACCESS_DENIED;
- }
-
- //
- // Check whether all the declined addresses belongs to the configured Ia.
- //
- Status = Dhcp6CheckAddress (Instance->IaCb.Ia, AddressCount, Addresses);
-
- if (EFI_ERROR(Status)) {
- return Status;
- }
-
- OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
- Instance->UdpSts = EFI_ALREADY_STARTED;
-
- //
- // Deprive of all the declined addresses from the configured Ia, and create a
- // DeclineIa used to create decline message.
- //
- DecIa = Dhcp6DepriveAddress (Instance->IaCb.Ia, AddressCount, Addresses);
-
- if (DecIa == NULL) {
- Status = EFI_OUT_OF_RESOURCES;
- goto ON_ERROR;
- }
-
- //
- // Send the decline message to start exchange process.
- //
- Status = Dhcp6SendDeclineMsg (Instance, DecIa);
-
- if (EFI_ERROR (Status)) {
- goto ON_ERROR;
- }
-
- //
- // Register receive callback for the stateful exchange process.
- //
- Status = UdpIoRecvDatagram(
- Service->UdpIo,
- Dhcp6ReceivePacket,
- Service,
- 0
- );
-
- if (EFI_ERROR (Status) && (Status != EFI_ALREADY_STARTED)) {
- goto ON_ERROR;
- }
-
- FreePool (DecIa);
- gBS->RestoreTPL (OldTpl);
-
- //
- // Poll udp out of the net tpl if synchoronus call.
- //
- if (Instance->Config->IaInfoEvent == NULL) {
-
- while (Instance->UdpSts == EFI_ALREADY_STARTED) {
- Service->UdpIo->Protocol.Udp6->Poll (Service->UdpIo->Protocol.Udp6);
- }
- return Instance->UdpSts;
- }
-
- return EFI_SUCCESS;
-
-ON_ERROR:
-
- if (DecIa != NULL) {
- FreePool (DecIa);
- }
- gBS->RestoreTPL (OldTpl);
-
- return Status;
-}
-
-
-/**
- Release one or more addresses associated with the configured Ia
- for current instance.
-
- The Release() function is used to manually release one or more
- IPv6 addresses. If AddressCount is zero, it will release all IPv6
- addresses of the configured IA. If all IPv6 addresses of the IA are
- released through this function, the state of the IA will switch
- through Dhcp6Releasing to Dhcp6Init, otherwise, the state of the
- IA will restore to Dhcp6Bound after the releasing process.
- The Release() can only be called when the IA is in Dhcp6Bound state.
- If the EFI_DHCP6_CONFIG_DATA.IaInfoEvent is NULL, the function is
- a blocking operation. It will return after the releasing process
- finishes, or is aborted by user.
-
- @param[in] This The pointer to the Dhcp6 protocol.
- @param[in] AddressCount The number of releasing addresses.
- @param[in] Addresses The pointer to the buffer stored the releasing
- addresses.
-
- @retval EFI_SUCCESS The DHCPv6 release exchange process
- completed when EFI_DHCP6_CONFIG_DATA.IaInfoEvent
- was NULL. The Dhcp6 instance was sent Release
- packet when EFI_DHCP6_CONFIG_DATA.IaInfoEvent
- was not NULL.
- @retval EFI_ACCESS_DENIED The Dhcp6 instance hasn't been configured, or the
- state of the configured IA is not in Dhcp6Bound.
- @retval EFI_ABORTED The DHCPv6 release exchange process aborted by user.
- @retval EFI_NOT_FOUND Any specified IPv6 address is not correlated with
- the configured IA for this instance.
- @retval EFI_INVALID_PARAMETER Some parameter is NULL.
- @retval EFI_DEVICE_ERROR An unexpected system or network error occurred.
-
-**/
-EFI_STATUS
-EFIAPI
-EfiDhcp6Release (
- IN EFI_DHCP6_PROTOCOL *This,
- IN UINT32 AddressCount,
- IN EFI_IPv6_ADDRESS *Addresses
- )
-{
- EFI_STATUS Status;
- EFI_TPL OldTpl;
- EFI_DHCP6_IA *RelIa;
- DHCP6_INSTANCE *Instance;
- DHCP6_SERVICE *Service;
-
- if (This == NULL || (AddressCount != 0 && Addresses == NULL)) {
- return EFI_INVALID_PARAMETER;
- }
-
- Instance = DHCP6_INSTANCE_FROM_THIS (This);
- Service = Instance->Service;
-
- //
- // The instance hasn't been configured.
- //
- if (Instance->Config == NULL) {
- return EFI_ACCESS_DENIED;
- }
-
- ASSERT (Instance->IaCb.Ia != NULL);
-
- if (Instance->IaCb.Ia->State != Dhcp6Bound) {
- return EFI_ACCESS_DENIED;
- }
-
- //
- // Check whether all the released addresses belongs to the configured Ia.
- //
- Status = Dhcp6CheckAddress (Instance->IaCb.Ia, AddressCount, Addresses);
-
- if (EFI_ERROR(Status)) {
- return Status;
- }
-
- OldTpl = gBS->RaiseTPL (TPL_CALLBACK);
- Instance->UdpSts = EFI_ALREADY_STARTED;
-
- //
- // Deprive of all the released addresses from the configured Ia, and create a
- // ReleaseIa used to create release message.
- //
- RelIa = Dhcp6DepriveAddress (Instance->IaCb.Ia, AddressCount, Addresses);
-
- if (RelIa == NULL) {
- Status = EFI_OUT_OF_RESOURCES;
- goto ON_ERROR;
- }
-
- //
- // Send the release message to start exchange process.
- //
- Status = Dhcp6SendReleaseMsg (Instance, RelIa);
-
- if (EFI_ERROR (Status)) {
- goto ON_ERROR;
- }
-
- //
- // Register receive callback for the stateful exchange process.
- //
- Status = UdpIoRecvDatagram(
- Service->UdpIo,
- Dhcp6ReceivePacket,
- Service,
- 0
- );
-
- if (EFI_ERROR (Status) && (Status != EFI_ALREADY_STARTED)) {
- goto ON_ERROR;
- }
-
- FreePool (RelIa);
- gBS->RestoreTPL (OldTpl);
-
- //
- // Poll udp out of the net tpl if synchoronus call.
- //
- if (Instance->Config->IaInfoEvent == NULL) {
- while (Instance->UdpSts == EFI_ALREADY_STARTED) {
- Service->UdpIo->Protocol.Udp6->Poll (Service->UdpIo->Protocol.Udp6);
- }
- return Instance->UdpSts;
- }
-
- return EFI_SUCCESS;
-
-ON_ERROR:
-
- if (RelIa != NULL) {
- FreePool (RelIa);
- }
- gBS->RestoreTPL (OldTpl);
-
- return Status;
-}
-
-
-/**
- Parse the option data in the Dhcp6 packet.
-
- The Parse() function is used to retrieve the option list in the DHCPv6 packet.
-
- @param[in] This The pointer to the Dhcp6 protocol.
- @param[in] Packet The pointer to the Dhcp6 packet.
- @param[in, out] OptionCount The number of option in the packet.
- @param[out] PacketOptionList The array of pointers to each option in the packet.
-
- @retval EFI_SUCCESS The packet was successfully parsed.
- @retval EFI_INVALID_PARAMETER Some parameter is NULL.
- @retval EFI_BUFFER_TOO_SMALL *OptionCount is smaller than the number of options
- that were found in the Packet.
-
-**/
-EFI_STATUS
-EFIAPI
-EfiDhcp6Parse (
- IN EFI_DHCP6_PROTOCOL *This,
- IN EFI_DHCP6_PACKET *Packet,
- IN OUT UINT32 *OptionCount,
- OUT EFI_DHCP6_PACKET_OPTION *PacketOptionList[] OPTIONAL
- )
-{
- UINT32 OptCnt;
- UINT32 OptLen;
- UINT16 DataLen;
- UINT8 *Start;
- UINT8 *End;
-
- if (This == NULL || Packet == NULL || OptionCount == NULL) {
- return EFI_INVALID_PARAMETER;
- }
-
- if (*OptionCount != 0 && PacketOptionList == NULL) {
- return EFI_INVALID_PARAMETER;
- }
-
- if (Packet->Length > Packet->Size || Packet->Length < sizeof (EFI_DHCP6_HEADER)) {
- return EFI_INVALID_PARAMETER;
- }
-
- //
- // The format of Dhcp6 option:
- //
- // 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
- // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- // | option-code | option-len (option data) |
- // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- // | option-data |
- // | (option-len octets) |
- // +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- //
-
- OptCnt = 0;
- OptLen = Packet->Length - sizeof (EFI_DHCP6_HEADER);
- Start = Packet->Dhcp6.Option;
- End = Start + OptLen;
-
- //
- // Calculate the number of option in the packet.
- //
- while (Start < End) {
- DataLen = ((EFI_DHCP6_PACKET_OPTION *) Start)->OpLen;
- Start += (NTOHS (DataLen) + 4);
- OptCnt++;
- }
-
- //
- // It will return buffer too small if pass-in option count is smaller than the
- // actual count of options in the packet.
- //
- if (OptCnt > *OptionCount) {
- *OptionCount = OptCnt;
- return EFI_BUFFER_TOO_SMALL;
- }
-
- ZeroMem (
- PacketOptionList,
- (*OptionCount * sizeof (EFI_DHCP6_PACKET_OPTION *))
- );
-
- OptCnt = 0;
- Start = Packet->Dhcp6.Option;
-
- while (Start < End) {
-
- PacketOptionList[OptCnt] = (EFI_DHCP6_PACKET_OPTION *) Start;
- DataLen = ((EFI_DHCP6_PACKET_OPTION *) Start)->OpLen;
- Start += (NTOHS (DataLen) + 4);
- OptCnt++;
- }
-
- return EFI_SUCCESS;
-}
-
|