Merge pull request #1679 from zdc/vpp-current

VPP: Add comprehensive VPP documentation

1 files changed, 96 insertions, 0 deletions

diff --git a/docs/vpp/configuration/interfaces/ipip.rst b/docs/vpp/configuration/interfaces/ipip.rst
new file mode 100644
index 00000000..92ceba91
--- /dev/null
+++ b/docs/vpp/configuration/interfaces/ipip.rst
@@ -0,0 +1,96 @@
+:lastproofread: 2025-09-04
+
+.. _vpp_config_interfaces_ipip:
+
+.. include:: /_include/need_improvement.txt
+
+######################
+VPP IPIP Configuration
+######################
+
+VPP IPIP interfaces provide IP-in-IP tunneling with high-performance packet processing. IPIP tunnels encapsulate IP packets within IP packets, creating point-to-point connections across Layer 3 networks.
+
+Basic Configuration
+-------------------
+
+Creating an IPIP Interface
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. cfgcmd:: set vpp interfaces ipip <ipipN>
+
+   Create an IPIP interface where ``<ipipN>`` follows the naming convention ipip1, ipip2, etc.
+
+.. cfgcmd:: set vpp interfaces ipip <ipipN> remote <address>
+
+   Set the tunnel remote endpoint address. Supports both IPv4 and IPv6 addresses.
+
+.. cfgcmd:: set vpp interfaces ipip <ipipN> source-address <address>
+
+   Set the tunnel source address. Must match an address configured on the local system.
+
+**Basic Example:**
+
+.. code-block:: none
+
+   set vpp interfaces ipip ipip1
+   set vpp interfaces ipip ipip1 remote 203.0.113.2
+   set vpp interfaces ipip ipip1 source-address 192.168.1.1
+
+Interface Configuration
+-----------------------
+
+Description and Administrative Control
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. cfgcmd:: set vpp interfaces ipip <ipipN> description <description>
+
+   Set a descriptive name for the IPIP interface.
+
+.. cfgcmd:: set vpp interfaces ipip <ipipN> disable
+
+   Administratively disable the IPIP interface.
+
+Kernel Interface Integration
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. cfgcmd:: set vpp interfaces ipip <ipipN> kernel-interface <interface-name>
+
+   Bind a kernel interface to the IPIP tunnel for management and application compatibility.
+
+For detailed information about kernel interface integration, see :doc:`kernel`.
+
+Configuration Examples
+----------------------
+
+IPv4 IPIP Tunnel
+^^^^^^^^^^^^^^^^
+
+.. code-block:: none
+
+   # Basic IPv4 IPIP tunnel
+   set vpp interfaces ipip ipip1
+   set vpp interfaces ipip ipip1 description "Site-to-site IPIP tunnel"
+   set vpp interfaces ipip ipip1 remote 203.0.113.10
+   set vpp interfaces ipip ipip1 source-address 192.168.1.1
+
+IPv6 IPIP Tunnel
+^^^^^^^^^^^^^^^^
+
+.. code-block:: none
+
+   # IPv6 endpoints
+   set vpp interfaces ipip ipip2
+   set vpp interfaces ipip ipip2 remote 2001:db8::2
+   set vpp interfaces ipip ipip2 source-address 2001:db8::1
+
+IPIP with Kernel Interface
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. code-block:: none
+
+   # IPIP tunnel with management interface
+   set vpp interfaces ipip ipip3
+   set vpp interfaces ipip ipip3 remote 203.0.113.30
+   set vpp interfaces ipip ipip3 source-address 192.168.1.1
+   set vpp interfaces ipip ipip3 kernel-interface vpptun3
+   set vpp kernel-interfaces vpptun3 address 10.0.2.1/30