Commit 8bf2464c authored by David S. Miller's avatar David S. Miller
Browse files

Merge branch 'Bare-UDP-L3-Encapsulation-Module' 

Martin Varghese says:

====================
Bare UDP L3 Encapsulation Module

There are various L3 encapsulation standards using UDP being discussed to
leverage the UDP based load balancing capability of different networks.
MPLSoUDP (__ https://tools.ietf.org/html/rfc7510

) is one among them.

The Bareudp tunnel module provides a generic L3 encapsulation tunnelling
support for tunnelling different L3 protocols like MPLS, IP, NSH etc. inside
a UDP tunnel.

Special Handling
----------------
The bareudp device supports special handling for MPLS & IP as they can have
multiple ethertypes.
MPLS procotcol can have ethertypes ETH_P_MPLS_UC  (unicast) & ETH_P_MPLS_MC (multicast).
IP protocol can have ethertypes ETH_P_IP (v4) & ETH_P_IPV6 (v6).
This special handling can be enabled only for ethertypes ETH_P_IP & ETH_P_MPLS_UC
with a flag called multiproto mode.

Usage
------

1) Device creation & deletion

    a) ip link add dev bareudp0 type bareudp dstport 6635 ethertype 0x8847.

       This creates a bareudp tunnel device which tunnels L3 traffic with ethertype
       0x8847 (MPLS traffic). The destination port of the UDP header will be set to
       6635.The device will listen on UDP port 6635 to receive traffic.

    b) ip link delete bareudp0

2) Device creation with multiple proto mode enabled

There are two ways to create a bareudp device for MPLS & IP with multiproto mode
enabled.

    a) ip link add dev  bareudp0 type bareudp dstport 6635 ethertype 0x8847 multiproto

    b) ip link add dev  bareudp0 type bareudp dstport 6635 ethertype mpls

3) Device Usage

The bareudp device could be used along with OVS or flower filter in TC.
The OVS or TC flower layer must set the tunnel information in SKB dst field before
sending packet buffer to the bareudp device for transmission. On reception the
bareudp device extracts and stores the tunnel information in SKB dst field before
passing the packet buffer to the network stack.

Why not FOU ?
------------
FOU by design does l4 encapsulation.It maps udp port to ipproto (IP protocol number for l4 protocol).
Bareudp acheives a generic l3 encapsulation.It maps udp port to l3 ethertype.
====================

Signed-off-by: default avatarDavid S. Miller <davem@davemloft.net>
parents 48851e9e 4b5f6723

Documentation/networking/bareudp.rst

0 → 100644
+52 −0
Original line number Diff line number Diff line 
.. SPDX-License-Identifier: GPL-2.0



========================================

Bare UDP Tunnelling Module Documentation

========================================



There are various L3 encapsulation standards using UDP being discussed to

leverage the UDP based load balancing capability of different networks.

MPLSoUDP (__ https://tools.ietf.org/html/rfc7510) is one among them.



The Bareudp tunnel module provides a generic L3 encapsulation tunnelling

support for tunnelling different L3 protocols like MPLS, IP, NSH etc. inside

a UDP tunnel.



Special Handling

----------------

The bareudp device supports special handling for MPLS & IP as they can have

multiple ethertypes.

MPLS procotcol can have ethertypes ETH_P_MPLS_UC  (unicast) & ETH_P_MPLS_MC (multicast).

IP protocol can have ethertypes ETH_P_IP (v4) & ETH_P_IPV6 (v6).

This special handling can be enabled only for ethertypes ETH_P_IP & ETH_P_MPLS_UC

with a flag called multiproto mode.



Usage

------



1) Device creation & deletion



    a) ip link add dev bareudp0 type bareudp dstport 6635 ethertype 0x8847.



       This creates a bareudp tunnel device which tunnels L3 traffic with ethertype

       0x8847 (MPLS traffic). The destination port of the UDP header will be set to

       6635.The device will listen on UDP port 6635 to receive traffic.



    b) ip link delete bareudp0



2) Device creation with multiple proto mode enabled



There are two ways to create a bareudp device for MPLS & IP with multiproto mode

enabled.



    a) ip link add dev  bareudp0 type bareudp dstport 6635 ethertype 0x8847 multiproto



    b) ip link add dev  bareudp0 type bareudp dstport 6635 ethertype mpls



3) Device Usage



The bareudp device could be used along with OVS or flower filter in TC.

The OVS or TC flower layer must set the tunnel information in SKB dst field before

sending packet buffer to the bareudp device for transmission. On reception the

bareudp device extracts and stores the tunnel information in SKB dst field before

passing the packet buffer to the network stack.

Documentation/networking/index.rst

+1 −0
Original line number Diff line number Diff line
@@ -8,6 +8,7 @@ Contents: 


   netdev-FAQ

   af_xdp

   bareudp

   batman-adv

   can

   can_ucan_protocol

drivers/net/Kconfig

+13 −0
Original line number Diff line number Diff line
@@ -258,6 +258,19 @@ config GENEVE 
	  To compile this driver as a module, choose M here: the module

	  will be called geneve.



config BAREUDP

       tristate "Bare UDP Encapsulation"

       depends on INET

       depends on IPV6 || !IPV6

       select NET_UDP_TUNNEL

       select GRO_CELLS

       help

          This adds a bare UDP tunnel module for tunnelling different

          kinds of traffic like MPLS, IP, etc. inside a UDP tunnel.



          To compile this driver as a module, choose M here: the module

          will be called bareudp.



config GTP

	tristate "GPRS Tunneling Protocol datapath (GTP-U)"

	depends on INET

drivers/net/Makefile

+1 −0
Original line number Diff line number Diff line
@@ -29,6 +29,7 @@ obj-$(CONFIG_VETH) += veth.o 
obj-$(CONFIG_VIRTIO_NET) += virtio_net.o

obj-$(CONFIG_VXLAN) += vxlan.o

obj-$(CONFIG_GENEVE) += geneve.o

obj-$(CONFIG_BAREUDP) += bareudp.o

obj-$(CONFIG_GTP) += gtp.o

obj-$(CONFIG_NLMON) += nlmon.o

obj-$(CONFIG_NET_VRF) += vrf.o

drivers/net/bareudp.c

0 → 100644
+804 −0

File added.

Preview size limit exceeded, changes collapsed.

CRA Git | Maintained and supported by SUSTech CRA and CCSE