This object contains parameters associated with the Generic Routing Encapsulation (GRE) Tunnel ({{bibref|RFC2784}}) with Key and Sequence Number extensions ({{bibref|RFC2890}}). This object also provides a means to treat packets that are encapsulated within a GRE Tunnel by using a set of {{object|Filter}} objects to determine the treatment of the packet. {{numentries}} {{numentries}} GRE Tunnel table, models the GRE Tunnel instance and represents the entry point and exit point of the tunnel in relation to the WAN interface. A {{object}} object has one or more {{object|Interface}} objects that further define the sessions or flows within the tunnel. Enables or disables the tunnel. The current operational state of the tunnel. The Fully Qualified Domain Name (FQDN) or IP address of the remote GRE tunnel endpoint. If more than one name/address is supplied, they will be tried in turn, i.e. they are in decreasing order of precedence. The mechanism used to keep the tunnel from timing out at the {{param|ConnectedRemoteEndpoint}}. The tunnel keepalive timeout in {{units}}. Number of KeepAlive messages unacknowledged by the {{param|ConnectedRemoteEndpoint}} before the {{object}} is perceived failed. The protocol used for the delivery header. If the specified entries in the {{object|#.Filter}} table do not match this {{object}} object or an instance of the {{object|Interface}} object for this {{object}} object, then the value of this parameter is applied to the delivery header of the packets in this {{object}}. The Fully Qualified Domain Name (FQDN) name or IP address of the connected remote GRE tunnel endpoint. Statistics for this GRE tunnel, i.e. all traffic that has passed through the tunnel. The device MUST reset the tunnel's Stats parameters (unless otherwise stated in individual object or parameter descriptions) either when the tunnel becomes operationally down due to a previous administrative down (i.e., Status parameter transitions to a disabled state after the tunnel has been disabled) or when the tunnel becomes administratively up (i.e. the Enable parameter transitioned from {{false}} to {{true}}). The total number of KeepAlive {{units}} sent out the tunnel. The total number of KeepAlive {{units}} received by the tunnel. The total number of {{units}} sent by the tunnel. The total number of {{units}} received by the tunnel. The total number of {{units}} sent by the tunnel. The total number of {{units}} received by the tunnel. The total number of {{units}} discarded by the tunnel due to any error. This can include packets dropped due to a lack of transmit buffers. The total number of {{units}} received by the tunnel that contained errors preventing them from being delivered to a higher-layer protocol. GRE Interface table (a stackable interface object as described in {{bibref|TR-181i2|Section 4.2}}). The {{object}} object models the GRE Header as defined in {{bibref|RFC2784}} and extensions to the GRE Header as defined in {{bibref|RFC2890}}. The {{object}} object provides a way to discriminate how sessions or flows are encapsulated within the GRE Tunnel. In addition the {{object}} object represents the entry point and exit point of the tunnel in relation to the LAN interface. Unless the Key Identifier of {{bibref|RFC2890}} is supported there is only one instance of this {{object}} object per tunnel. The Protocol ID assigned to this {{object}}. The Protocol Id is the EtherType value used to identify the encapsulated payload. When set to {{null}} the CPE determines the Protocol Id. When {{true}}, includes the "Checksum" field in the GRE header as defined in {{bibref|RFC2784}}. The method used to generate the Key Identifier extension as defined in.{{bibref|RFC2890}}. The generation of the Key field is CPE specific implementation. When the value of {{param|KeyIdentifierGenerationPolicy}} is {{enum|Provisioned|KeyIdentifierGenerationPolicy}} this {{param}} parameter is used to identify an individual traffic flow within a GRE tunnel, as defined in {{bibref|RFC2890}}. When {{true}}, includes the "SequenceNumber" field in the GRE header as defined in {{bibref|RFC2890}} This can include packets dropped due to a lack of transmit buffers. The total number of {{units}} received by the tunnel interface that are discarded because of Checksum errors. The total number of {{units}} received by the tunnel interface that are discarded because of Sequence Number errors. GRE Filter table. Entries in this table are applied against the packets that are to be encapsulated within the GRE Tunnel based on the following conditions: * If the value of the {{param|AllInterfaces}} is {{true}}, then this entry will be applied to all {{object|#.Tunnel}} and {{object|#.Tunnel.{i}.Interface}} instances. * If the value of {{param|AllInterfaces}} is {{false}} and the value of {{param|Interface}} parameter is a reference to a row in the {{object|#.Tunnel}} table then this entry is applied to all {{object|#.Tunnel.{i}.Interface}} instances of the {{object|#.Tunnel}} reference. * If the value of {{param|AllInterfaces}} is {{false}} and the value of {{param|Interface}} parameter is a reference to a row in the {{object|#.Tunnel.{i}.Interface}} table then this entry is applied to the {{object|#.Tunnel.{i}.Interface}} reference. * If no entries are matched for the packet, then the default treatment (e.g., {{param|#.Tunnel.{i}.DefaultDSCPMark}}) is applied to the packet. For enabled table entries, if {{param|Interface}} is not a valid reference and {{param|AllInterfaces}} is {{false}}, then the table entry is inoperable and the CPE MUST set {{param|Status}} to {{enum|Error_Misconfigured|Status}}. Enables or disables this filter. The status of this filter. {{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 packet, the highest ordered entry that matches the filter criteria is applied. All lower order entries are ignored. Filter criterion. {{reference}} Filter criterion. This specifies that all ingress GRE tunnel interfaces are associated with the entry. If {{true}}, the value of {{param|Interface}} is ignored since all ingress GRE tunnel interfaces are indicated. Filter criterion. Current outer Ethernet VLAN ID as defined in 802.1Q. A value of -1 indicates this criterion is not used for filtering. If {{false}}, the filter includes only those packets that match the {{param|VLANIDCheck}} entry, if specified. If {{true}}, the filter includes all packets except those that match the {{param|VLANIDCheck}} entry, if specified. DSCP with which to mark the outer IP header for traffic that is associated with the interface criterion. 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 upstream packet. * A value of -2 indicates automatic marking of DSCP.