gre

The list of GRE interfaces on the device.

vrouter running config# vrf <vrf> interface gre <gre>

<gre>

An interface name.

mtu

Set the max transmission unit size in octets.

vrouter running config# vrf <vrf> interface gre <gre>
vrouter running gre <gre># mtu <uint32>

promiscuous

Set promiscuous mode.

vrouter running config# vrf <vrf> interface gre <gre>
vrouter running gre <gre># promiscuous true|false

description

A textual description of the interface.

vrouter running config# vrf <vrf> interface gre <gre>
vrouter running gre <gre># description <string>

enabled

The desired (administrative) state of the interface.

vrouter running config# vrf <vrf> interface gre <gre>
vrouter running gre <gre># enabled true|false
Default value
true

local (mandatory)

The source address that should be used for the tunnel.

vrouter running config# vrf <vrf> interface gre <gre>
vrouter running gre <gre># local LOCAL

LOCAL values

Description

<A.B.C.D>

An IPv4 address.

<X:X::X:X>

An IPv6 address.

remote (mandatory)

The destination address that should be used for the tunnel.

vrouter running config# vrf <vrf> interface gre <gre>
vrouter running gre <gre># remote REMOTE

REMOTE values

Description

<A.B.C.D>

An IPv4 address.

<X:X::X:X>

An IPv6 address.

ttl

The time-to-live (or hop limit) that should be utilised for the IP packets used for the tunnel transport.

vrouter running config# vrf <vrf> interface gre <gre>
vrouter running gre <gre># ttl <uint8>

tos

Set the DSCP bits in the Type of Service field.

vrouter running config# vrf <vrf> interface gre <gre>
vrouter running gre <gre># tos <uint8>

checksum

Enable checksum features for this tunnel.

vrouter running config# vrf <vrf> interface gre <gre>
vrouter running gre <gre># checksum CHECKSUM

CHECKSUM values

Description

input

Verify checksum for all input packets.

output

Calculate checksum for outgoing packets.

both

Calculate checksum for outgoing packets, and verify it for all input packets.

sequence-number

Enable sequence number for this tunnel.

vrouter running config# vrf <vrf> interface gre <gre>
vrouter running gre <gre># sequence-number SEQUENCE-NUMBER

SEQUENCE-NUMBER values

Description

input

All input packet must be serialized.

output

Enable sequencing of outgoing packets.

both

Enable sequencing of outgoing packet and check serialization of all input packets.

ifindex (state only)

System assigned number for each interface. Corresponds to ifIndex object in SNMP Interface MIB.

vrouter> show state vrf <vrf> interface gre <gre> ifindex

admin-status (state only)

The desired state of the interface. In RFC 7223 this leaf has the same read semantics as ifAdminStatus. Here, it reflects the administrative state as set by enabling or disabling the interface.

vrouter> show state vrf <vrf> interface gre <gre> admin-status

oper-status (state only)

The current operational state of the interface. This leaf has the same semantics as ifOperStatus.

vrouter> show state vrf <vrf> interface gre <gre> oper-status

last-change (state only)

This timestamp indicates the time of the last state change of the interface (e.g., up-to-down transition). This corresponds to the ifLastChange object in the standard interface MIB. The value is the timestamp in nanoseconds relative to the Unix Epoch (Jan 1, 1970 00:00:00 UTC).

vrouter> show state vrf <vrf> interface gre <gre> last-change

ipv4

Parameters for the IPv4 address family.

vrouter running config# vrf <vrf> interface gre <gre> ipv4

enabled

Controls whether IPv4 is enabled or disabled on this interface. When IPv4 is enabled, this interface is connected to an IPv4 stack, and the interface can send and receive IPv4 packets.

vrouter running config# vrf <vrf> interface gre <gre> ipv4
vrouter running ipv4# enabled true|false
Default value
true

address

The list of configured IPv4 addresses on the interface.

vrouter running config# vrf <vrf> interface gre <gre> ipv4
vrouter running ipv4# address <address> peer PEER

<address> values

Description

<A.B.C.D>

An IPv4 address.

<A.B.C.D/M>

An IPv4 prefix: address and CIDR mask.

peer

The IPv4 address of the remote endpoint for point to point interfaces.

peer PEER

PEER

An IPv4 address.

origin (state only)

The origin of this address, e.g., statically configured, assigned by DHCP, etc..

vrouter> show state vrf <vrf> interface gre <gre> ipv4 address <address> origin

ipv6

Parameters for the IPv6 address family.

vrouter running config# vrf <vrf> interface gre <gre> ipv6

enabled

Controls whether IPv6 is enabled or disabled on this interface. When IPv6 is enabled, this interface is connected to an IPv6 stack, and the interface can send and receive IPv6 packets.

vrouter running config# vrf <vrf> interface gre <gre> ipv6
vrouter running ipv6# enabled true|false
Default value
true

address

The list of configured IPv6 addresses on the interface.

vrouter running config# vrf <vrf> interface gre <gre> ipv6
vrouter running ipv6# address <address> peer PEER

<address> values

Description

<X:X::X:X>

An IPv6 address.

<X:X::X:X/M>

An IPv6 prefix: address and CIDR mask.

peer

The IPv6 address of the remote endpoint for point to point interfaces.

peer PEER

PEER

An IPv6 address.

origin (state only)

The origin of this address, e.g., static, dhcp, etc.

vrouter> show state vrf <vrf> interface gre <gre> ipv6 address <address> origin

status (state only)

The status of an address. Most of the states correspond to states from the IPv6 Stateless Address Autoconfiguration protocol.

vrouter> show state vrf <vrf> interface gre <gre> ipv6 address <address> status

key

Set the value of the GRE key for this interface.

vrouter running config# vrf <vrf> interface gre <gre> key

input

GRE key of incoming packets (overrides the value specified in both).

vrouter running config# vrf <vrf> interface gre <gre> key
vrouter running key# input INPUT

INPUT values

Description

<uint32>

GRE key type.

<A.B.C.D>

An IPv4 address.

output

GRE key for outgoing packets (overrides the value specified in both).

vrouter running config# vrf <vrf> interface gre <gre> key
vrouter running key# output OUTPUT

OUTPUT values

Description

<uint32>

GRE key type.

<A.B.C.D>

An IPv4 address.

both

GRE key for incoming and outgoing packets.

vrouter running config# vrf <vrf> interface gre <gre> key
vrouter running key# both BOTH

BOTH values

Description

<uint32>

GRE key type.

<A.B.C.D>

An IPv4 address.

qos

QoS configuration.

vrouter running config# vrf <vrf> interface gre <gre> qos

ingress

Ingress QoS configuration.

vrouter running config# vrf <vrf> interface gre <gre> qos ingress

rate-limit

Rate limit configuration.

vrouter running config# vrf <vrf> interface gre <gre> qos ingress rate-limit
policer (config only)

Traffic policer defined in the QoS context.

vrouter running config# vrf <vrf> interface gre <gre> qos ingress rate-limit
vrouter running rate-limit# policer <leafref>
shared-policer (config only)

Traffic shared policer defined in the QoS context.

vrouter running config# vrf <vrf> interface gre <gre> qos ingress rate-limit
vrouter running rate-limit# shared-policer <leafref>
policer (state only)

Traffic policer.

bandwidth (state only)

Maximum bandwidth of regular traffic, a.k.a. CIR (Committed Information Rate), in bps. 0 allows no regular traffic.

vrouter> show state vrf <vrf> interface gre <gre> qos ingress rate-limit policer bandwidth
burst (state only)

Maximum burst size of regular traffic, a.k.a. CBS (Committed Burst Size), in bytes. 0 allows no regular traffic.

vrouter> show state vrf <vrf> interface gre <gre> qos ingress rate-limit policer burst
excess-bandwidth (state only)

Maximum bandwidth of excess traffic, a.k.a. EIR (Excess Information Rate), in bps. 0 allows no excess traffic.

vrouter> show state vrf <vrf> interface gre <gre> qos ingress rate-limit policer excess-bandwidth
excess-burst (state only)

Maximum burst size of excess traffic, a.k.a. EBS (Excess Burst Size), in bytes. 0 allows no excess traffic.

vrouter> show state vrf <vrf> interface gre <gre> qos ingress rate-limit policer excess-burst
shared-policer (state only)

Shared policer name.

vrouter> show state vrf <vrf> interface gre <gre> qos ingress rate-limit policer shared-policer
stats (state only)

Traffic policer statistics.

pass-packets (state only)

Number of packets passed (regular traffic that conforms to (bandwidth, burst) specification.

vrouter> show state vrf <vrf> interface gre <gre> qos ingress rate-limit policer stats pass-packets
pass-bytes (state only)

Number of bytes passed (regular traffic that conforms to (bandwidth, burst) specification.

vrouter> show state vrf <vrf> interface gre <gre> qos ingress rate-limit policer stats pass-bytes
pass-excess-packets (state only)

Number of excess packets passed (excess traffic that conforms to (excess-bandwidth, excess-burst) specification.

vrouter> show state vrf <vrf> interface gre <gre> qos ingress rate-limit policer stats pass-excess-packets
pass-excess-bytes (state only)

Number of excess bytes passed (excess traffic that conforms to (excess-bandwidth, excess-burst) specification.

vrouter> show state vrf <vrf> interface gre <gre> qos ingress rate-limit policer stats pass-excess-bytes
drop-packets (state only)

Number of packets dropped (traffic that does not conform to bandwidth or excess-bandwidth).

vrouter> show state vrf <vrf> interface gre <gre> qos ingress rate-limit policer stats drop-packets
drop-bytes (state only)

Number of bytes dropped (traffic that does not conform to bandwidth or excess-bandwidth).

vrouter> show state vrf <vrf> interface gre <gre> qos ingress rate-limit policer stats drop-bytes

egress

Egress QoS configuration.

vrouter running config# vrf <vrf> interface gre <gre> qos egress

rate-limit

Rate limit configuration.

vrouter running config# vrf <vrf> interface gre <gre> qos egress rate-limit
policer (config only)

Traffic policer defined in the QoS context.

vrouter running config# vrf <vrf> interface gre <gre> qos egress rate-limit
vrouter running rate-limit# policer <leafref>
shared-policer (config only)

Traffic shared policer defined in the QoS context.

vrouter running config# vrf <vrf> interface gre <gre> qos egress rate-limit
vrouter running rate-limit# shared-policer <leafref>
policer (state only)

Traffic policer.

bandwidth (state only)

Maximum bandwidth of regular traffic, a.k.a. CIR (Committed Information Rate), in bps. 0 allows no regular traffic.

vrouter> show state vrf <vrf> interface gre <gre> qos egress rate-limit policer bandwidth
burst (state only)

Maximum burst size of regular traffic, a.k.a. CBS (Committed Burst Size), in bytes. 0 allows no regular traffic.

vrouter> show state vrf <vrf> interface gre <gre> qos egress rate-limit policer burst
excess-bandwidth (state only)

Maximum bandwidth of excess traffic, a.k.a. EIR (Excess Information Rate), in bps. 0 allows no excess traffic.

vrouter> show state vrf <vrf> interface gre <gre> qos egress rate-limit policer excess-bandwidth
excess-burst (state only)

Maximum burst size of excess traffic, a.k.a. EBS (Excess Burst Size), in bytes. 0 allows no excess traffic.

vrouter> show state vrf <vrf> interface gre <gre> qos egress rate-limit policer excess-burst
shared-policer (state only)

Shared policer name.

vrouter> show state vrf <vrf> interface gre <gre> qos egress rate-limit policer shared-policer
stats (state only)

Traffic policer statistics.

pass-packets (state only)

Number of packets passed (regular traffic that conforms to (bandwidth, burst) specification.

vrouter> show state vrf <vrf> interface gre <gre> qos egress rate-limit policer stats pass-packets
pass-bytes (state only)

Number of bytes passed (regular traffic that conforms to (bandwidth, burst) specification.

vrouter> show state vrf <vrf> interface gre <gre> qos egress rate-limit policer stats pass-bytes
pass-excess-packets (state only)

Number of excess packets passed (excess traffic that conforms to (excess-bandwidth, excess-burst) specification.

vrouter> show state vrf <vrf> interface gre <gre> qos egress rate-limit policer stats pass-excess-packets
pass-excess-bytes (state only)

Number of excess bytes passed (excess traffic that conforms to (excess-bandwidth, excess-burst) specification.

vrouter> show state vrf <vrf> interface gre <gre> qos egress rate-limit policer stats pass-excess-bytes
drop-packets (state only)

Number of packets dropped (traffic that does not conform to bandwidth or excess-bandwidth).

vrouter> show state vrf <vrf> interface gre <gre> qos egress rate-limit policer stats drop-packets
drop-bytes (state only)

Number of bytes dropped (traffic that does not conform to bandwidth or excess-bandwidth).

vrouter> show state vrf <vrf> interface gre <gre> qos egress rate-limit policer stats drop-bytes

counters (state only)

A collection of interface-related statistics objects.

in-octets (state only)

The total number of octets received on the interface, including framing characters. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ‘last-clear’.

vrouter> show state vrf <vrf> interface gre <gre> counters in-octets

in-unicast-pkts (state only)

The number of packets, delivered by this sub-layer to a higher (sub-)layer, that were not addressed to a multicast or broadcast address at this sub-layer. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ‘last-clear’.

vrouter> show state vrf <vrf> interface gre <gre> counters in-unicast-pkts

in-discards (state only)

The number of inbound packets that were chosen to be discarded even though no errors had been detected to prevent their being deliverable to a higher-layer protocol. One possible reason for discarding such a packet could be to free up buffer space. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ‘last-clear’.

vrouter> show state vrf <vrf> interface gre <gre> counters in-discards

in-errors (state only)

For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being deliverable to a higher- layer protocol. For character- oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol. Discontinuities in the value of this counter can occur at re- initialization of the management system, and at other times as indicated by the value of ‘last-clear’.

vrouter> show state vrf <vrf> interface gre <gre> counters in-errors

out-octets (state only)

The total number of octets transmitted out of the interface, including framing characters. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ‘last-clear’.

vrouter> show state vrf <vrf> interface gre <gre> counters out-octets

out-unicast-pkts (state only)

The total number of packets that higher-level protocols requested be transmitted, and that were not addressed to a multicast or broadcast address at this sub-layer, including those that were discarded or not sent. Discontinuities in the value of this counter can occur at re- initialization of the management system, and at other times as indicated by the value of ‘last-clear’.

vrouter> show state vrf <vrf> interface gre <gre> counters out-unicast-pkts

out-discards (state only)

The number of outbound packets that 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. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ‘last-clear’.

vrouter> show state vrf <vrf> interface gre <gre> counters out-discards

out-errors (state only)

For packet-oriented interfaces, the number of outbound packets that could not be transmitted because of errors. For character-oriented or fixed-length interfaces, the number of outbound transmission units that could not be transmitted because of errors. Discontinuities in the value of this counter can occur at re-initialization of the management system, and at other times as indicated by the value of ‘last-clear’.

vrouter> show state vrf <vrf> interface gre <gre> counters out-errors