tf6DhcpUserConfigAuth
Table of Contents >> Optional Protocols >> DHCPv6
| #include <trsocket.h> |
| int tf6DhcpUserConfigAuth | ( |
| ttUserInterface interfaceHandle, | |
| tt6DhcpAuthProtocol protocol, | |
| tt6DhcpAuthAlgorithm algorithm, | |
| tt6DhcpAuthRdm rdm, | |
| int flags | |
| ); |
Function Description
Set the preferred authentication protocol, algorithm, and replay detection method. If any authentication method other than TM_6_DHCP_AUTH_PROTO_NONE is chosen, the DHCPv6 client will require successful authentication with the server before configuration can occur. If authenticated is preferred but not required, attempt configuration initially with the desired authentication settings. If this fails, set the authentication protocol to TM_6_DHCP_AUTH_PROTO_NONE before starting DHCPv6 again.
Parameters
-
interfaceHandle
- Handle to the interface on which to configure authentication
-
protocol
- Authentication protocol to use. Valid values:
-
Name Description TM_6_DHCP_AUTH_PROTO_NONE Do not use authentication TM_6_DHCP_AUTH_PROTO_DELAYED Use Delayed Authentication Protocol (DAP)
-
algorithm
- Authentication algorithm to use. Valid values:
-
Name Description TM_6_DHCP_AUTH_ALG_MD5 Use MD5 as authentication algorithm
-
rdm
- Replay detection method to use. Valid values:
-
Name Description TM_6_DHCP_AUTH_RDM_MONO_INC Use a monotonically increasing counter as the RDM
-
flags
- Currently unused
Event Descriptions
- TM_6_DHCP_EVENT_SOLICIT_TIMEOUT
- Solicit timed out
- Note: By default, the Solicit phase cannot time out. See tf6DhcpSetOption()
- TM_6_DHCP_EVENT_NO_SERVER
- No DHCPv6 server available
- TM_6_DHCP_EVENT_CONFIRM_FAILED
- Confirm failed
- TM_6_DHCP_EVENT_CONFIRM_OK
- Confirm OK
- Note: This event also occurs if the Confirm message times out without receiving a reply. In this case, the client should continue to use any addresses granted to it
- TM_6_DHCP_EVENT_INFO_RECEIVED
- Received a valid Reply in response to an Information-Request message
- TM_6_DHCP_EVENT_LEASE_RENEWED
- The DHCPv6 server has extended the lifetimes of the addresses in the given IA
- TM_6_DHCP_EVENT_STOPPED
- The DHCPv6 client is shutting down
Returns
- TM_ENOERROR
- Sucessful
- TM_EINVAL
- Invalid parameter