Add NetworkPkg (P.UDK2010.UP3.Network.P1)
git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@10986 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
597
NetworkPkg/Dhcp6Dxe/Dhcp6Impl.h
Normal file
597
NetworkPkg/Dhcp6Dxe/Dhcp6Impl.h
Normal file
@@ -0,0 +1,597 @@
|
||||
/** @file
|
||||
Dhcp6 internal data structure and definition declaration.
|
||||
|
||||
Copyright (c) 2009 - 2010, 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.
|
||||
|
||||
**/
|
||||
|
||||
#ifndef __EFI_DHCP6_IMPL_H__
|
||||
#define __EFI_DHCP6_IMPL_H__
|
||||
|
||||
|
||||
#include <Uefi.h>
|
||||
|
||||
#include <Protocol/Dhcp6.h>
|
||||
#include <Protocol/Udp6.h>
|
||||
#include <Protocol/ServiceBinding.h>
|
||||
#include <Protocol/DriverBinding.h>
|
||||
|
||||
#include <Library/UdpIoLib.h>
|
||||
#include <Library/DebugLib.h>
|
||||
#include <Library/BaseMemoryLib.h>
|
||||
#include <Library/MemoryAllocationLib.h>
|
||||
#include <Library/UefiBootServicesTableLib.h>
|
||||
#include <Library/UefiRuntimeServicesTableLib.h>
|
||||
#include <Library/UefiLib.h>
|
||||
#include <Library/BaseLib.h>
|
||||
#include <Library/NetLib.h>
|
||||
|
||||
|
||||
typedef struct _DHCP6_IA_CB DHCP6_IA_CB;
|
||||
typedef struct _DHCP6_INF_CB DHCP6_INF_CB;
|
||||
typedef struct _DHCP6_TX_CB DHCP6_TX_CB;
|
||||
typedef struct _DHCP6_SERVICE DHCP6_SERVICE;
|
||||
typedef struct _DHCP6_INSTANCE DHCP6_INSTANCE;
|
||||
|
||||
#include "Dhcp6Utility.h"
|
||||
#include "Dhcp6Io.h"
|
||||
#include "Dhcp6Driver.h"
|
||||
|
||||
#define DHCP6_SERVICE_SIGNATURE SIGNATURE_32 ('D', 'H', '6', 'S')
|
||||
#define DHCP6_INSTANCE_SIGNATURE SIGNATURE_32 ('D', 'H', '6', 'I')
|
||||
|
||||
//
|
||||
// Transmit parameters of solicit message, refers to section-5.5 of rfc-3315.
|
||||
//
|
||||
#define DHCP6_SOL_MAX_DELAY 1
|
||||
#define DHCP6_SOL_IRT 1
|
||||
#define DHCP6_SOL_MRC 0
|
||||
#define DHCP6_SOL_MRT 120
|
||||
#define DHCP6_SOL_MRD 0
|
||||
//
|
||||
// Transmit parameters of request message, refers to section-5.5 of rfc-3315.
|
||||
//
|
||||
#define DHCP6_REQ_IRT 1
|
||||
#define DHCP6_REQ_MRC 10
|
||||
#define DHCP6_REQ_MRT 30
|
||||
#define DHCP6_REQ_MRD 0
|
||||
//
|
||||
// Transmit parameters of confirm message, refers to section-5.5 of rfc-3315.
|
||||
//
|
||||
#define DHCP6_CNF_MAX_DELAY 1
|
||||
#define DHCP6_CNF_IRT 1
|
||||
#define DHCP6_CNF_MRC 0
|
||||
#define DHCP6_CNF_MRT 4
|
||||
#define DHCP6_CNF_MRD 10
|
||||
//
|
||||
// Transmit parameters of renew message, refers to section-5.5 of rfc-3315.
|
||||
//
|
||||
#define DHCP6_REN_IRT 10
|
||||
#define DHCP6_REN_MRC 0
|
||||
#define DHCP6_REN_MRT 600
|
||||
#define DHCP6_REN_MRD 0
|
||||
//
|
||||
// Transmit parameters of rebind message, refers to section-5.5 of rfc-3315.
|
||||
//
|
||||
#define DHCP6_REB_IRT 10
|
||||
#define DHCP6_REB_MRC 0
|
||||
#define DHCP6_REB_MRT 600
|
||||
#define DHCP6_REB_MRD 0
|
||||
//
|
||||
// Transmit parameters of information request message, refers to section-5.5 of rfc-3315.
|
||||
//
|
||||
#define DHCP6_INF_MAX_DELAY 1
|
||||
#define DHCP6_INF_IRT 1
|
||||
#define DHCP6_INF_MRC 0
|
||||
#define DHCP6_INF_MRT 120
|
||||
#define DHCP6_INF_MRD 0
|
||||
//
|
||||
// Transmit parameters of release message, refers to section-5.5 of rfc-3315.
|
||||
//
|
||||
#define DHCP6_REL_IRT 1
|
||||
#define DHCP6_REL_MRC 5
|
||||
#define DHCP6_REL_MRT 0
|
||||
#define DHCP6_REL_MRD 0
|
||||
//
|
||||
// Transmit parameters of decline message, refers to section-5.5 of rfc-3315.
|
||||
//
|
||||
#define DHCP6_DEC_IRT 1
|
||||
#define DHCP6_DEC_MRC 5
|
||||
#define DHCP6_DEC_MRT 0
|
||||
#define DHCP6_DEC_MRD 0
|
||||
|
||||
#define DHCP6_PACKET_ALL 0
|
||||
#define DHCP6_PACKET_STATEFUL 1
|
||||
#define DHCP6_PACKET_STATELESS 2
|
||||
|
||||
#define DHCP6_BASE_PACKET_SIZE 1024
|
||||
|
||||
#define DHCP6_PORT_CLIENT 546
|
||||
#define DHCP6_PORT_SERVER 547
|
||||
|
||||
#define DHCP6_INSTANCE_FROM_THIS(Instance) CR ((Instance), DHCP6_INSTANCE, Dhcp6, DHCP6_INSTANCE_SIGNATURE)
|
||||
#define DHCP6_SERVICE_FROM_THIS(Service) CR ((Service), DHCP6_SERVICE, ServiceBinding, DHCP6_SERVICE_SIGNATURE)
|
||||
|
||||
extern EFI_IPv6_ADDRESS mAllDhcpRelayAndServersAddress;
|
||||
extern EFI_IPv6_ADDRESS mAllDhcpServersAddress;
|
||||
extern EFI_DHCP6_PROTOCOL gDhcp6ProtocolTemplate;
|
||||
|
||||
//
|
||||
// Enumeration of Dhcp6 message type, refers to section-5.3 of rfc-3315.
|
||||
//
|
||||
typedef enum {
|
||||
Dhcp6MsgSolicit = 1,
|
||||
Dhcp6MsgAdvertise = 2,
|
||||
Dhcp6MsgRequest = 3,
|
||||
Dhcp6MsgConfirm = 4,
|
||||
Dhcp6MsgRenew = 5,
|
||||
Dhcp6MsgRebind = 6,
|
||||
Dhcp6MsgReply = 7,
|
||||
Dhcp6MsgRelease = 8,
|
||||
Dhcp6MsgDecline = 9,
|
||||
Dhcp6MsgReconfigure = 10,
|
||||
Dhcp6MsgInfoRequest = 11
|
||||
} DHCP6_MSG_TYPE;
|
||||
|
||||
//
|
||||
// Enumeration of option code in Dhcp6 packet, refers to section-24.3 of rfc-3315.
|
||||
//
|
||||
typedef enum {
|
||||
Dhcp6OptClientId = 1,
|
||||
Dhcp6OptServerId = 2,
|
||||
Dhcp6OptIana = 3,
|
||||
Dhcp6OptIata = 4,
|
||||
Dhcp6OptIaAddr = 5,
|
||||
Dhcp6OptRequestOption = 6,
|
||||
Dhcp6OptPreference = 7,
|
||||
Dhcp6OptElapsedTime = 8,
|
||||
Dhcp6OptReplayMessage = 9,
|
||||
Dhcp6OptAuthentication = 11,
|
||||
Dhcp6OptServerUnicast = 12,
|
||||
Dhcp6OptStatusCode = 13,
|
||||
Dhcp6OptRapidCommit = 14,
|
||||
Dhcp6OptUserClass = 15,
|
||||
Dhcp6OptVendorClass = 16,
|
||||
Dhcp6OptVendorInfo = 17,
|
||||
Dhcp6OptInterfaceId = 18,
|
||||
Dhcp6OptReconfigMessage = 19,
|
||||
Dhcp6OptReconfigureAccept = 20
|
||||
} DHCP6_OPT_CODE;
|
||||
|
||||
//
|
||||
// Enumeration of status code recorded by IANA, refers to section-24.4 of rfc-3315.
|
||||
//
|
||||
typedef enum {
|
||||
Dhcp6StsSuccess = 0,
|
||||
Dhcp6StsUnspecFail = 1,
|
||||
Dhcp6StsNoAddrsAvail = 2,
|
||||
Dhcp6StsNoBinding = 3,
|
||||
Dhcp6StsNotOnLink = 4,
|
||||
Dhcp6StsUseMulticast = 5
|
||||
} DHCP6_STS_CODE;
|
||||
|
||||
//
|
||||
// Enumeration of Duid type recorded by IANA, refers to section-24.5 of rfc-3315.
|
||||
//
|
||||
typedef enum {
|
||||
Dhcp6DuidTypeLlt = 1,
|
||||
Dhcp6DuidTypeEn = 2,
|
||||
Dhcp6DuidTypeLl = 3
|
||||
} DHCP6_DUID_TYPE;
|
||||
|
||||
//
|
||||
// Control block for each IA.
|
||||
//
|
||||
struct _DHCP6_IA_CB {
|
||||
EFI_DHCP6_IA *Ia;
|
||||
UINT32 T1;
|
||||
UINT32 T2;
|
||||
UINT32 AllExpireTime;
|
||||
UINT32 LeaseTime;
|
||||
};
|
||||
|
||||
//
|
||||
// Control block for each transmitted message.
|
||||
//
|
||||
struct _DHCP6_TX_CB {
|
||||
LIST_ENTRY Link;
|
||||
UINT32 Xid;
|
||||
EFI_DHCP6_PACKET *TxPacket;
|
||||
EFI_DHCP6_RETRANSMISSION RetryCtl;
|
||||
UINT32 RetryCnt;
|
||||
UINT32 RetryExp;
|
||||
UINT32 RetryLos;
|
||||
UINT32 TickTime;
|
||||
UINT16 *Elapsed;
|
||||
};
|
||||
|
||||
//
|
||||
// Control block for each info-request message.
|
||||
//
|
||||
struct _DHCP6_INF_CB {
|
||||
LIST_ENTRY Link;
|
||||
UINT32 Xid;
|
||||
EFI_DHCP6_INFO_CALLBACK ReplyCallback;
|
||||
VOID *CallbackContext;
|
||||
EFI_EVENT TimeoutEvent;
|
||||
};
|
||||
|
||||
//
|
||||
// Control block for Dhcp6 instance, it's per configuration data.
|
||||
//
|
||||
struct _DHCP6_INSTANCE {
|
||||
UINT32 Signature;
|
||||
EFI_HANDLE Handle;
|
||||
DHCP6_SERVICE *Service;
|
||||
LIST_ENTRY Link;
|
||||
EFI_DHCP6_PROTOCOL Dhcp6;
|
||||
EFI_EVENT Timer;
|
||||
EFI_DHCP6_CONFIG_DATA *Config;
|
||||
EFI_DHCP6_IA *CacheIa;
|
||||
DHCP6_IA_CB IaCb;
|
||||
LIST_ENTRY TxList;
|
||||
LIST_ENTRY InfList;
|
||||
EFI_DHCP6_PACKET *AdSelect;
|
||||
UINT8 AdPref;
|
||||
EFI_IPv6_ADDRESS *Unicast;
|
||||
EFI_STATUS UdpSts;
|
||||
BOOLEAN InDestory;
|
||||
BOOLEAN MediaPresent;
|
||||
UINT64 StartTime;
|
||||
};
|
||||
|
||||
//
|
||||
// Control block for Dhcp6 service, it's per Nic handle.
|
||||
//
|
||||
struct _DHCP6_SERVICE {
|
||||
UINT32 Signature;
|
||||
EFI_HANDLE Controller;
|
||||
EFI_HANDLE Image;
|
||||
EFI_SERVICE_BINDING_PROTOCOL ServiceBinding;
|
||||
EFI_SIMPLE_NETWORK_PROTOCOL *Snp;
|
||||
EFI_DHCP6_DUID *ClientId;
|
||||
UDP_IO *UdpIo;
|
||||
UINT32 Xid;
|
||||
LIST_ENTRY Child;
|
||||
UINTN NumOfChild;
|
||||
BOOLEAN InDestory;
|
||||
};
|
||||
|
||||
/**
|
||||
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
|
||||
completed when CompletionEvent was 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.
|
||||
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
EfiDhcp6Start (
|
||||
IN EFI_DHCP6_PROTOCOL *This
|
||||
);
|
||||
|
||||
/**
|
||||
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 the 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
|
||||
);
|
||||
|
||||
/**
|
||||
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 has not
|
||||
been configured when Dhcp6ConfigData is
|
||||
not NULL.
|
||||
**/
|
||||
EFI_STATUS
|
||||
EFIAPI
|
||||
EfiDhcp6GetModeData (
|
||||
IN EFI_DHCP6_PROTOCOL *This,
|
||||
OUT EFI_DHCP6_MODE_DATA *Dhcp6ModeData OPTIONAL,
|
||||
OUT EFI_DHCP6_CONFIG_DATA *Dhcp6ConfigData OPTIONAL
|
||||
);
|
||||
|
||||
/**
|
||||
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 has been already configured
|
||||
when Dhcp6CfgData is not NULL.
|
||||
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
|
||||
);
|
||||
|
||||
/**
|
||||
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. Client sends
|
||||
out Information Request packet to obtain the required configuration
|
||||
information, and DHCPv6 server responds with Reply packet containing
|
||||
the information for the client. The received Reply packet will be passed
|
||||
to the user by ReplyCallback function. If 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 a 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 to by DHCPv6 servers when Timeout happened.
|
||||
@retval EFI_ABORTED The DHCPv6 information request exchange process was aborted
|
||||
by the 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
|
||||
);
|
||||
|
||||
/**
|
||||
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.
|
||||
|
||||
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 a Renew or Rebind packet.
|
||||
- When RebindRequest is FALSE and the state of the configured IA is Dhcp6Bound,
|
||||
it will send 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 a 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
|
||||
completed and at least one IPv6 address of the
|
||||
configured IA was bound again when
|
||||
EFI_DHCP6_CONFIG_DATA.IaInfoEvent was 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 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
|
||||
);
|
||||
|
||||
/**
|
||||
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 the 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 has sent Decline 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_ABORTED The DHCPv6 decline exchange process was aborted by the 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
|
||||
);
|
||||
|
||||
/**
|
||||
Release one or more addresses associated with the configured Ia
|
||||
for the current instance.
|
||||
|
||||
The Release() function is used to manually release the one or more
|
||||
IPv6 address. 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 a 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 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 has
|
||||
completed when EFI_DHCP6_CONFIG_DATA.IaInfoEvent
|
||||
is NULL. The Dhcp6 instance has sent Release
|
||||
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_ABORTED The DHCPv6 release exchange process was aborted by the 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
|
||||
);
|
||||
|
||||
/**
|
||||
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 the 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
|
||||
);
|
||||
|
||||
#endif
|
Reference in New Issue
Block a user