The Dynamic Host Configuration Protocol (DHCP) IPv6 object {{bibref|RFC8415}}. This entire object applies to IPv6 only. It contains the {{object|Client}} and {{object|Server}} objects. {{numentries}} This object contains DHCPv6 client settings for an associated ''IP Interface'' indicated by {{param|Interface}}. For enabled table entries, if {{param|Interface}} is not a valid reference to an IPv6-capable interface (that is attached to the IPv6 stack), then the table entry is inoperable and the CPE MUST set {{param|Status}} to {{enum|Error_Misconfigured|Status}}. Note: The {{object}} table includes a unique key parameter that is a strong reference. If a strongly referenced object is deleted, the CPE will set the referencing parameter to {{empty}}. However, doing so under these circumstances might cause the updated {{object}} row to then violate the table's unique key constraint; if this occurs, the CPE MUST set {{param|Status}} to {{enum|Error_Misconfigured|Status}} and disable the offending {{object}} row. Enables or disables this {{object}} entry. {{reference}} The IP Interface associated with the {{object}} entry. This will reference an IPv6-capable interface (that is attached to the IPv6 stack), otherwise the table entry will be inoperable. The status of this table entry. {{enum}} The {{enum|Error_Misconfigured}} value indicates that a necessary configuration value is undefined or invalid. The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. The client's DHCP Unique Identifier (DUID) {{bibref|RFC8415|Section 11}}. {{param}} is set by the CPE. Enables or disables inclusion of the ''Identity Association (IA) for Non-Temporary Address'' option OPTION_IA_NA(3) {{bibref|RFC8415|Section 21.4}} in Solicit messages. Enables or disables inclusion of the ''Identity Association (IA) for Prefix Delegation'' option OPTION_IA_PD(25) {{bibref|RFC8415|Section 21.22}} in Solicit messages. Note that this is only appropriate for an upstream interface on a requesting router, e.g. for an RG WAN interface. Enables or disables inclusion of the ''Rapid Commit'' option OPTION_RAPID_COMMIT(14) {{bibref|RFC8415|Section 21.14}} in Solicit messages. T1 value, in {{units}}, that the client SHOULD use when sending IA options, e.g. OPTION_IA_NA {{bibref|RFC8415|Section 21.4}} and OPTION_IA_PD {{bibref|RFC8415|Section 10}}. A value of -1 indicates that no T1 value is specified. T2 value, in {{units}}, that the client SHOULD use when sending IA options, e.g. OPTION_IA_NA {{bibref|RFC8415|Section 21.4}} and OPTION_IA_PD {{bibref|RFC8415|Section 21.22}}. A value of -1 indicates that no T2 value is specified. {{list}} The options that the client is able to process in server responses. This list MUST include both top-level and encapsulated options, e.g. if the client is able to process OPTION_IA_NA (3) with an encapsulated OPTION_IAADDR (5), the list would be expected to include both 3 and 5. {{list}} An ordered list of the top-level options (i.e. not encapsulated options) that the client will explicitly request from the server. This parameter is intended only for options that are not necessary for the basic operation of the protocol, and are not modeled elsewhere. For example, it is appropriate for OPTION_DNS_SERVERS {{bibref|RFC3646}} but is not appropriate for OPTION_SERVERID (which is part of the protocol), OPTION_IA_NA (which is modeled via {{param|RequestAddresses}}) or OPTION_IA_PD (which is modeled via {{param|RequestPrefixes}}). However, the CPE MUST NOT reject an attempt to set this parameter to a value that includes options that it regards as inappropriate; instead, it MUST accept the requested options and handle them as best it can. Loosely speaking, these are the options that the client will include in OPTION_ORO {{bibref|RFC8415}} but the client is free to decide (in accordance with {{bibref|RFC8415}}) in which messages to request which option, whether also to request additional options, whether not to request inappropriate options, and in which order to request any options that are also in {{param|SupportedOptions}}. {{numentries}} {{numentries}} {{numentries}} This is a transitory table that lists the discovered DHCPv6 servers (it does ''not'' model a local DHCP server). Table entries are automatically created to correspond with these servers. However, it is a local matter to the CPE when to delete old table entries. The IP address from which the message most recently received from this server was sent. The server's DHCP Unique Identifier (DUID) {{bibref|RFC8415|Section 11}} as received via OPTION_SERVERID. The OPTION_INFORMATION_REFRESH_TIME value {{bibref|RFC4242}} that was most recently received from this server, converted to the ''dateTime'' at which the associated information will expire. If no such option has been received, the parameter value MUST be the "Unknown Time" {{null}}. If the information will never expire, the parameter value MUST be infinite time 9999-12-31T23:59:59Z. The top-level options and option values (including any encapsulated options) that the client will send to the server. This table is intended only for options that are not part of the basic operation of the protocol, and whose values are simple, do not often change and are not modeled elsewhere. For example, it is appropriate for OPTION_USER_CLASS (whose value is a list of user classes) but is not appropriate for OPTION_RECONF_MSG (which is part of the protocol), OPTION_IA_NA (which is modeled via {{param|#.RequestAddresses}}) or OPTION_RAPID_COMMIT (which is modeled via {{param|#.RapidCommit}}). Enables or disables this {{object}} entry. Option tag (code) {{bibref|RFC8415|Section 21.1}}. A hexbinary encoded option data {{bibref|RFC8415|Section 21.1}}. Note: The length of the option data is ''option-len'' octets, as specified in {{bibref|RFC8415|Section 21.1}}. This is a transitory table that lists all the options received from all servers. Table entries are automatically created to correspond with received options. However, it is a local matter to the CPE when to delete old table entries. If the same option is received multiple times, whether from one or more servers, it is up to the CPE to decide which entries to include (i.e. whether the same option will be present multiple times). In order to allow for the same option to be present multiple times within the table, this table has no unique key defined. Option tag (code) {{bibref|RFC8415|Section 21.1}}. A hexbinary encoded option data {{bibref|RFC8415|Section 21.1}}. {{reference}} This is the server that sent the option to the client. Each {{object}} entry MUST have an associated server. This object enables the configurion of the DHCPv6 retransmission behavior according to the guidelines described in {{bibref|RFC8415|Section 7.6}}. Maximum delay of first Solicit, expressed in {{units}}. Initial solicit, expressed in {{units}}. Maximum solicit timeout value, expressed in {{units}}. Initial request timeout, expressed in {{units}}. Maximum request timeout, expressed in {{units}}. Maximum request retry attempts. Maximum delay of first confirm, expressed in {{units}}. Initial confirm timeout, expressed in {{units}}. Maximum confirm timeout, expressed in {{units}}. Maximum confirm duration, expressed in {{units}}. Initial renew timeout, expressed in {{units}}. Maximum renew timeout value, expressed in {{units}}. Initial rebind timeout, expressed in {{units}}. Maximum rebind timeout value, expressed in {{units}}. Maximum delay of first information-request, expressed in {{units}}. Initial information-request timeout, expressed in {{units}}. Maximum information-request timeout, expressed in {{units}}. Initial Release timeout, expressed in {{units}}. Maximum release retry attempts. Initial Decline timeout, expressed in {{units}}. Maximum decline retry attempts. Initial reconfigure timeout, expressed in {{units}}. Maximum reconfigure attempts. Maximum hop count in a relay-forward message. Default information refresh time, expressed in {{units}}. Minimum information refresh time, expressed in {{units}}. Maximum required time to wait for a response, expressed in {{units}}. The Randomization factor for the retransmission timeout, in {{units}}, as defined in {{bibref|RFC8415|15 Reliability of Client-Initiated Message Exchanges}}. E.g. a timeout of 1000ms with a randomization of 100 will end up between 900 and 1100 ms. DHCPv6 server configuration. Enables or disables the DHCPv6 server function. {{numentries}} DHCPv6 server pool table. Each instance of this object defines a DHCPv6 server pool. Client requests are associated with pools based on criteria such as source interface, supplied DHCPv6 options, and source address. Overlapping pool ranges MUST be supported. For enabled table entries, if {{param|Interface}} is not a valid reference to an IPv6-capable interface (that is attached to the IPv6 stack) then the table entry is inoperable and the CPE MUST set {{param|Status}} to {{enum|Error_Misconfigured|Status}}. Enables or disables this {{object}} entry. The status of this entry. {{enum}} The {{enum|Error_Misconfigured}} value indicates that a necessary configuration value is undefined or invalid. The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} For each DHCPv6 request, the highest ordered entry that matches the association criteria is applied. All lower order entries are ignored. {{reference}} The IP Interface associated with the {{object}} entry. Pool association criterion. A hexbinary string used to identify one or more LAN devices, value of the DHCPv6 Client Identifier (Option 1) {{bibref|RFC8415|Section 21.2}}. The option value is binary, so an exact match is REQUIRED. {{empty}} indicates this criterion is not used. Note: DHCPv6 Option 1 (DUID) is sometimes referred to as ''Client Identifier''. If {{false}}, matching packets are those that match the {{param|DUID}} entry, if specified. If {{true}}, matching packets are those that do not match the {{param|DUID}} entry, if specified. Pool association criterion. A hexbinary string used to identify one or more LAN devices, value of the DHCPv6 Vendor Class Identifier (Option 16) {{bibref|RFC8415|Section 21.16}}. The option value is binary, so an exact match is REQUIRED. {{empty}} indicates this criterion is not used. If {{false}}, matching packets are those that match the {{param|VendorClassID}} entry, if specified. If {{true}}, matching packets are those that do not match the {{param|VendorClassID}} entry, if specified. Pool association criterion. A hexbinary string used to identify one or more LAN devices, value of the DHCPv6 User Class Identifier (Option 15) {{bibref|RFC8415|Section 21.15}}. {{empty}} indicates this criterion is not used. If {{false}}, matching packets are those that match the {{param|UserClassID}} entry, if specified. If {{true}}, matching packets are those that do not match the {{param|UserClassID}} entry, if specified. Pool association criterion. Source address (link-layer address) of DHCPv6 messages sent from the DHCPv6 client. This criterion is only likely to be useful if this is a link-layer address. {{empty}} indicates this criterion is not used for serving. Bit-mask for the source address, where matching of a packet's source address with the {{param|SourceAddress}} is only to be done for bit positions set to one in the mask. A mask of {{empty}} indicates all bits of the {{param|SourceAddress}} are to be used. If {{false}}, matching packets are those that match the (masked) {{param|SourceAddress}} entry, if specified. If {{true}}, matching packets are those that do not match the (masked) {{param|SourceAddress}} entry, if specified. Enables or disables IANA offers. {{list}} {{reference}} Manually-configured prefixes from which IA_NA addresses will be assigned. Each referenced prefix MUST have a {{param|###.IP.Interface.{i}.IPv6Prefix.{i}.StaticType}} of {{enum|Static|###.IP.Interface.{i}.IPv6Prefix.{i}.StaticType}} or {{enum|Child|###.IP.Interface.{i}.IPv6Prefix.{i}.StaticType}}. All clients that request IA_NA and match filter criteria on this {{param|Interface}} MUST be offered IA_NA addresses from all of the ''Valid'' ({{param|###.IP.Interface.{i}.IPv6Prefix.{i}.ValidLifetime}} is infinite or in the future) /64 prefixes in this list. Prefixes MUST be associated with the interface instance referenced by {{param|Interface}}. {{list}} {{reference}} All prefixes from which IA_NA addresses will be assigned. This list can include: * Prefixes from {{param|IANAManualPrefixes}} that are used for IA_NA offers. * Prefixes with {{param|###.IP.Interface.{i}.IPv6Prefix.{i}.Origin}} = {{enum|Child|###.IP.Interface.{i}.IPv6Prefix.{i}.Origin}} or {{enum|AutoConfigured|###.IP.Interface.{i}.IPv6Prefix.{i}.Origin}} associated with the interface instance referenced by {{param|Interface}}. Enables or disables IAPD offers. {{list}} {{reference}} Manually-configured prefixes from which IA_PD prefixes will be derived. This list can include: * Prefixes with {{param|###.IP.Interface.{i}.IPv6Prefix.{i}.Origin}} = {{enum|Static|###.IP.Interface.{i}.IPv6Prefix.{i}.Origin}} or {{enum|PrefixDelegation|###.IP.Interface.{i}.IPv6Prefix.{i}.Origin}} associated with upstream interfaces (i.e. interfaces for which the physical layer interface object has ''Upstream'' = {{true}}). * Prefixes with {{param|###.IP.Interface.{i}.IPv6Prefix.{i}.StaticType}} = {{enum|Static|###.IP.Interface.{i}.IPv6Prefix.{i}.StaticType}} or {{enum|Child|###.IP.Interface.{i}.IPv6Prefix.{i}.StaticType}} associated with with the interface instance referenced by {{param|Interface}}. All clients that request IA_PD and match filter criteria on this {{param|Interface}} MUST be offered IA_PD prefixes derived from all of the ''Valid'' ({{param|###.IP.Interface.{i}.IPv6Prefix.{i}.ValidLifetime}} is infinite or in the future) prefixes in this list. {{list}} {{reference}} All prefixes for which IA_PD prefixes will be assigned. This list can include: * Prefixes from {{param|IAPDManualPrefixes}} that are used for IA_PD offers. * Prefixes with {{param|###.IP.Interface.{i}.IPv6Prefix.{i}.Origin}} = {{enum|PrefixDelegation|###.IP.Interface.{i}.IPv6Prefix.{i}.Origin}} or {{enum|AutoConfigured|###.IP.Interface.{i}.IPv6Prefix.{i}.Origin}} associated with upstream interfaces (i.e. interfaces for which the physical layer interface object has ''Upstream'' = {{true}}). * Prefixes with {{param|###.IP.Interface.{i}.IPv6Prefix.{i}.Origin}} = {{enum|Child|###.IP.Interface.{i}.IPv6Prefix.{i}.Origin}} or {{enum|AutoConfigured|###.IP.Interface.{i}.IPv6Prefix.{i}.Origin}} associated with the interface instance referenced by {{param|Interface}}. The RECOMMENDED minimum number of bits to add to {{param|IAPDManualPrefixes}} or {{param|IAPDPrefixes}} in order to determine the length of prefixes that are offered in an IA_PD. The device is responsible for ensuring that it does not delegate a prefix longer than /64. The device can have additional logic that is used (in conjunction with this parameter) to determine the actual length of prefixes offered in an IA_PD. {{numentries}} {{numentries}} DHCPv6 client table. This table lists details of DHCPv6 clients that matched the filter criteria of this {{object|#}} entry. Note: There is no guarantee that the {{param}} value on automatically-created {{object}} instances will be retained. This is because automatically-created {{object}} instances can be transitory. Source address of the DHCPv6 client. Whether or not the DHCPv6 client is currently present on the LAN. The method of presence detection is a local matter to the CPE. The ability to list inactive DHCPv6 clients is OPTIONAL. If the CPE includes inactive DHCPv6 clients in this table, {{param}} MUST be set to {{false}} for each inactive DHCPv6 client. The length of time an inactive DHCPv6 client remains listed in this table is a local matter to the CPE. {{numentries}} {{numentries}} {{numentries}} IPv6 addresses assigned to this client via IA_NA. IPv6 address. The time at which this address will cease to be preferred (i.e. will become deprecated), or {{null}} if not known. For an infinite lifetime, the parameter value MUST be 9999-12-31T23:59:59Z. The time at which this address will cease to be valid (i.e. will become invalid), or {{null}} if unknown. For an infinite lifetime, the parameter value MUST be 9999-12-31T23:59:59Z. IPv6 prefixes delegated to this client via IA_PD. IPv6 address prefix. The time at which this prefix will cease to be preferred (i.e. will become deprecated), or {{null}} if not known. For an infinite lifetime, the parameter value MUST be 9999-12-31T23:59:59Z. The time at which this prefix will cease to be valid (i.e. will become invalid), or {{null}} if unknown. For an infinite lifetime, the parameter value MUST be 9999-12-31T23:59:59Z. DHCPv6 options supplied by this client, e.g. ''DUID'' (Option 1), ''UserClassID'' (Option 15) or ''VendorClassID'' (option 16). Option tag (code) {{bibref|RFC8415|Section 21.1}}. A hexbinary encoded option value. This object specifies the DHCPv6 options that MUST, if enabled, be offered to clients whose DHCPv6 requests are associated with this pool. If {{param|PassthroughClient}} is specified, and the referenced client has a value for a given option then the {{param|PassthroughClient}} option value will be sent instead of {{param|Value}}. Otherwise, {{param|Value}} will be sent. Enables or disables this {{object}} entry. Option tag (code) {{bibref|RFC8415|Section 21.1}}. A hexbinary encoded option value. {{reference}} Indicates whether this {{object}} entry is configured for passthrough. If {{param}} is specified, and the referenced client (since boot) has received a value from an associated upstream DHCPv6 server for the given {{param|Tag}} option, then the referenced client's option value will be sent instead of {{param|Value}}. Otherwise, {{param|Value}} will be sent. {{empty}} indicates that passthrough is not configured for this {{object}} entry.