The Mapping of Address and Port (MAP) object {{bibref|RFC7597}} {{bibref|RFC7599}} {{bibref|RFC7598}}. This object applies only to gateway devices that support IPv4 on the LAN side, include a {{object|#.NAT}}, and typically have only IPv6 connectivity on the WAN side. See the MAP Theory of Operation {{bibref|TR-181i2|Appendix XV}} for a description of the working of this MAP data model. Enables or disables MAP. {{numentries}} MAP domain settings {{bibref|RFC7597}} {{bibref|RFC7599}}. Each instance models a MAP domain. MAP supports two transport modes, both of which use NAPT44 (modified to use a restricted port range): * MAP-E ({{param|TransportMode}} = {{enum|Encapsulation|TransportMode}}) uses an IPv4-in-IPv6 tunnel. * MAP-T ({{param|TransportMode}} = {{enum|Translation|TransportMode}}) uses stateless NAT64. Note: There is an n:1 relationship between a MAP domain and the associated {{param|WANInterface}}, i.e. in theory multiple MAP domains can be associated with a single WAN IP interface (each domain would have its own ''End-user IPv6 prefix'' and ''MAP IPv6 address''). Note: The {{object}} table includes unique key parameters that are strong references. 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 the MAP domain. The current operational state of the MAP domain. The {{enum|Error_Misconfigured}} value indicates that a necessary configuration value is undefined or invalid. {{datatype|expand}} The transport mode to use. Corresponds to the {{bibref|RFC7598}} ''S46_CONT_MAPE'' and ''S46_CONT_MAPT'' container options. MAP-E {{bibref|RFC7597}} MAP-T {{bibref|RFC7599}} The IP interface with which this MAP domain is associated. This will always be a NAT-ted upstream (WAN) interface. The ''End-user IPv6 prefix'' {{param|IPv6Prefix}} is one of this IP interface's prefixes. The ''MAP IPv6 address'' is derived from the ''End-user IPv6 prefix'' and is one of this IP interface's IP addresses, with an {{param|##.IP.Interface.{i}.IPv6Address.{i}.Origin}} of {{enum|MAP|##.IP.Interface.{i}.IPv6Address.{i}.Origin}}. The MAP domain's ''End-user IPv6 prefix''. This MUST reference one of {{param|WANInterface}}'s prefixes. If the Controller configures this prefix directly, the CPE MUST use the Controller-configured prefix. Otherwise, the CPE MUST select one of {{param|WANInterface}}'s prefixes; the selected prefix will typically have {{param|##.IP.Interface.{i}.IPv6Prefix.{i}.Origin}} = {{enum|PrefixDelegation|##.IP.Interface.{i}.IPv6Prefix.{i}.Origin}}. The MAP Border Relay (BR) address or prefix. * For MAP-E this is the BR address and therefore MUST be a /128 {{bibref|RFC7597}}. Note this address can be an IPv6 anycast address. This address corresponds to the {{bibref|RFC7598}} ''OPTION_S46_BR'' (Border Relay) option. * For MAP-T this is the BR prefix {{bibref|RFC7599}}. This address prefix corresponds to the {{bibref|RFC7598}} ''OPTION_S46_DMR'' (Default Mapping Rule) option. Note: There will be a corresponding {{object|.Routing.Router.{i}.IPv4Forwarding}} default rule. DSCP with which to mark the outer IP header for traffic that is associated with this MAP domain. Downstream packets are never re-marked. Automatic DSCP marking behavior is a local matter to the device, possibly influenced by other Broadband Forum standards that it supports. * A value of -1 indicates copy from the incoming packet. * A value of -2 indicates automatic marking of DSCP. ''Port-set ID'' (PSID) offset in {{units}}. The number of Port-sets is 2^{{param}}. Corresponds to the {{bibref|RFC7598}} ''S46_PORTPARAMS'' (Port Parameters) option's ''offset'' field. {{deprecated|2.12|because details changed between drafting this data model and the RFC being published. This parameter has been moved to the proper location within the {{object|Rule.{i}.}} object}} {{obsoleted|2.14-2.15}} The length in {{units}} of the ''Port-set id'' (PSID) configured in the {{param|PSID}} parameter. Corresponds to the {{bibref|RFC7598}} ''S46_PORTPARAMS'' (Port Parameters) option's ''PSID-len'' field. {{deprecated|2.12|because details changed between drafting this data model and the RFC being published. This parameter has been moved to the proper location within the {{object|Rule.{i}.}} object}} {{obsoleted|2.14-2.15}} ''Port-set ID'' (PSID) to use in preference to the value extracted from the ''Embedded Address'' (EA) bits. Only the high order {{param|PSIDLength}} bits of the {{param}} value are used, so the parameter is ignored when {{param|PSIDLength}} is zero. Corresponds to the {{bibref|RFC7598}} ''S46_PORTPARAMS'' (Port Parameters) option's ''PSID'' field. {{deprecated|2.12|because details changed between drafting this data model and the RFC being published. This parameter has been moved to the proper location within the {{object|Rule.{i}.}} object}} {{obsoleted|2.14-2.15}} Whether to include low-numbered (system) ports in the Port-sets. Normally ports in the range [0:2^(16-{{param|PSIDOffset|obsoleted}})-1] are excluded, e.g. for the default {{param|PSIDOffset|obsoleted}} value of 6, ports [0:1023] are not included in the Port-sets. This parameter is related to {{bibref|RFC7597}}'s ''N'', which is defined as ''the number of ports (e.g., 1024) excluded from the lower end of the range''. The parameter is relevant only when {{param|PSIDOffset|obsoleted}} is 0; {{false}} corresponds to ''N=1024'' and {{true}} corresponds to ''N=0''. {{deprecated|2.15|because details changed between drafting this data model and the RFC being published. This parameter has been moved to the proper location within the {{object|Rule.{i}.}} object}} {{numentries}} The MAP domain's Mapping Rules {{bibref|RFC7597}}. The rule with the longest match between its {{param|IPv6Prefix}} and the end-user {{param|#.IPv6Prefix}} is the Basic Mapping Rule (BMR). Any of the rules (including the BMR) can be a Forwarding Mapping Rule. Enable or disable this {{object}} instance. The status of this {{object}} instance. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} The mechanism via which the {{object}} was created. If the CPE supports MAP configuration via both DHCPv6 and CWMP, it is up to the implementation to determine how the two mechanisms will interact. Created via a {{bibref|RFC7598}} ''S46_RULE'' option. Present in the factory default configuration, created by the Controller, or created by some other management entity (e.g. via a GUI) The ''Rule IPv6 prefix''. The Rule IPv6 prefix is a leading part of the end-user {{param|#.IPv6Prefix}}, i.e. its length MUST be less than or equal to the length of the end-user ''IPv6Prefix'', and it MUST match the end-user ''IPv6Prefix''. Corresponds to the {{bibref|RFC7598}} ''S46_RULE'' option's ''ipv6-prefix'' field. The ''Rule IPv4 prefix''. Corresponds to the {{bibref|RFC7598}} ''S46_RULE'' option's ''ipv4-prefix'' field. The length in {{units}} of the ''Embedded Address (EA) bits'' in the end-user {{param|#.IPv6Prefix}}. Corresponds to the {{bibref|RFC7598}} ''S46_RULE'' option's ''ea-len'' field. Indicates whether this rule is a ''Forwarding Mapping Rule'' (FMR), i.e. can be used for forwarding. Corresponds to the {{bibref|RFC7598}} ''S46_RULE'' option's ''flags'' field's ''F-Flag''. ''Port-set ID'' (PSID) offset in {{units}}. The number of Port-sets is 2^{{param}}. Corresponds to the {{bibref|RFC7598}} ''S46_PORTPARAMS'' (Port Parameters) option's ''offset'' field. The length in {{units}} of the ''Port-set id'' (PSID) configured in the {{param|PSID}} parameter. Corresponds to the {{bibref|RFC7598}} ''S46_PORTPARAMS'' (Port Parameters) option's ''PSID-len'' field. ''Port-set ID'' (PSID) to use in preference to the value extracted from the ''Embedded Address'' (EA) bits. Only the high order {{param|PSIDLength}} bits of the {{param}} value are used, so the parameter is ignored when {{param|PSIDLength}} is zero. Corresponds to the {{bibref|RFC7598}} ''S46_PORTPARAMS'' (Port Parameters) option's ''PSID'' field. Whether to include low-numbered (system) ports in the Port-sets. Normally ports in the range [0:2^(16-{{param|PSIDOffset}})-1] are excluded, e.g. for the default {{param|PSIDOffset}} value of 6, ports [0:1023] are not included in the Port-sets. This parameter is related to {{bibref|RFC7597}}'s ''N'', which is defined as ''the number of ports (e.g., 1024) excluded from the lower end of the range''. The parameter is relevant only when {{param|PSIDOffset}} is 0; {{false}} corresponds to ''N=1024'' and {{true}} corresponds to ''N=0''. MAP interface (a stackable interface object as described in {{bibref|TR-181i2|Section 4.2}}). This models the LAN side MAP domain interface. Enables or disables the interface. This parameter is based on ''ifAdminStatus'' from {{bibref|RFC2863}}. The current operational state of the interface (see {{bibref|TR-181i2|Section 4.2.2}}). {{enum}} When {{param|Enable}} is {{false}} then {{param}} SHOULD normally be {{enum|Down}} (or {{enum|NotPresent}} or {{enum|Error}} if there is a fault condition on the interface). When {{param|Enable}} is changed to {{true}} then {{param}} SHOULD change to {{enum|Up}} if and only if the interface is able to transmit and receive network traffic; it SHOULD change to {{enum|Dormant}} if and only if the interface is operable but is waiting for external actions before it can transmit and receive network traffic (and subsequently change to {{enum|Up}} if still operable when the expected actions have completed); it SHOULD change to {{enum|LowerLayerDown}} if and only if the interface is prevented from entering the {{enum|Up}} state because one or more of the interfaces beneath it is down; it SHOULD remain in the {{enum|Error}} state if there is an error or other fault condition detected on the interface; it SHOULD remain in the {{enum|NotPresent}} state if the interface has missing (typically hardware) components; it SHOULD change to {{enum|Unknown}} if the state of the interface can not be determined for some reason. This parameter is based on ''ifOperStatus'' from {{bibref|RFC2863}}. {{datatype|expand}} The textual name of the interface as assigned by the CPE. The accumulated time in {{units}} since the interface entered its current operational state. {{list}} {{reference|an interface object that is stacked immediately below this interface object}} See {{bibref|TR-181i2|Section 4.2.1}}. Note: Since this interface object is a MAP domain interface, it is expected that {{param}} will not be used. Throughput statistics for this MAP domain interface. The CPE MUST reset the interface's Stats parameters (unless otherwise stated in individual object or parameter descriptions) either when the interface becomes operationally down due to a previous administrative down (i.e. the interface's {{param|#.Status}} parameter transitions to a down state after the interface is disabled) or when the interface becomes administratively up (i.e. the interface's {{param|#.Enable}} parameter transitions from {{false}} to {{true}}). Administrative and operational interface status is discussed in {{bibref|TR-181i2|section 4.2.2}}. The total number of bytes transmitted out of the interface, including framing characters. The total number of bytes received on the interface, including framing characters. The total number of packets transmitted out of the interface. The total number of packets received on the interface. The total number of outbound packets that could not be transmitted because of errors. The total number of inbound packets that contained errors preventing them from being delivered to a higher-layer protocol. The total number of packets requested for transmission which were not addressed to a multicast or broadcast address at this layer, including those that were discarded or not sent. The total number of received packets, delivered by this layer to a higher layer, which were not addressed to a multicast or broadcast address at this layer. The total number of outbound packets which were chosen to be discarded even though no errors had been detected to prevent their being transmitted. One possible reason for discarding such a packet could be to free up buffer space. The total number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being delivered. One possible reason for discarding such a packet could be to free up buffer space. The total number of packets that higher-level protocols requested for transmission and which were addressed to a multicast address at this layer, including those that were discarded or not sent. The total number of received packets, delivered by this layer to a higher layer, which were addressed to a multicast address at this layer. The total number of packets that higher-level protocols requested for transmission and which were addressed to a broadcast address at this layer, including those that were discarded or not sent. Note that IPv6 does not define broadcast addresses, so IPv6 packets will never cause this counter to increment. The total number of received packets, delivered by this layer to a higher layer, which were addressed to a broadcast address at this layer. Note that IPv6 does not define broadcast addresses, so IPv6 packets will never cause this counter to increment. The total number of packets received via the interface which were discarded because of an unknown or unsupported protocol.