.. _geneve-interface:

######
GENEVE
######

:abbr:`GENEVE (Generic Network Virtualization Encapsulation)` supports all of
the capabilities of :abbr:`VXLAN (Virtual Extensible LAN)`, :abbr:`NVGRE
(Network Virtualization using Generic Routing Encapsulation)`, and :abbr:`STT
(Stateless Transport Tunneling)` and was designed to overcome their perceived
limitations. Many believe GENEVE could eventually replace these earlier formats
entirely.

GENEVE is designed to support network virtualization use cases, where tunnels
are typically established to act as a backplane between the virtual switches
residing in hypervisors, physical switches, or middleboxes or other appliances.
An arbitrary IP network can be used as an underlay although Clos networks - A
technique for composing network fabrics larger than a single switch while
maintaining non-blocking bandwidth across connection points. ECMP is used to
divide traffic across the multiple links and switches that constitute the
fabric. Sometimes termed "leaf and spine" or "fat tree" topologies.

Geneve Header:

.. code-block:: none

  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  |Ver|  Opt Len  |O|C|    Rsvd.  |          Protocol Type        |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  |        Virtual Network Identifier (VNI)       |    Reserved   |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  |                    Variable Length Options                    |
  +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

*************
Configuration
*************

Common interface configuration
==============================

.. cmdinclude:: ../_include/interface-common-without-dhcp.txt
   :var0: geneve
   :var1: gnv0

GENEVE options
==============

.. cfgcmd:: set interfaces geneve gnv0 remote <address>

   Configure GENEVE tunnel far end/remote tunnel endpoint.

.. cfgcmd:: set interfaces geneve gnv0 vni <vni>

   :abbr:`VNI (Virtual Network Identifier)` is an identifier for a unique
   element of a virtual network.  In many situations this may represent an L2
   segment, however, the control plane defines the forwarding semantics of
   decapsulated packets. The VNI MAY be used as part of ECMP forwarding
   decisions or MAY be used as a mechanism to distinguish between overlapping
   address spaces contained in the encapsulated packet when load balancing
   across CPUs.