tf6DhcpUserConfigAuth

Jump to: navigation, search

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
  • 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


Table of Contents >> Optional Protocols >> DHCPv6