€•‚5Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ&/translations/zh_CN/networking/bareudp”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/zh_TW/networking/bareudp”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/it_IT/networking/bareudp”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/ja_JP/networking/bareudp”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/ko_KR/networking/bareudp”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/pt_BR/networking/bareudp”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/sp_SP/networking/bareudp”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh·sbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1hµhhh²hh³Œ@/var/lib/git/docbuild/linux/Documentation/networking/bareudp.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ(Bare UDP Tunnelling Module Documentation”h]”hŒ(Bare UDP Tunnelling Module Documentation”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhŒ paragraph”“”)”}”(hŒÓ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.”h]”(hŒœThere are various L3 encapsulation standards using UDP being discussed to leverage the UDP based load balancing capability of different networks. MPLSoUDP (”…””}”(hhßh²hh³Nh´NubhŒ reference”“”)”}”(hŒ#https://tools.ietf.org/html/rfc7510”h]”hŒ#https://tools.ietf.org/html/rfc7510”…””}”(hhéh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”hëuh1hçhhßubhŒ) is one among them.”…””}”(hhßh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubhÞ)”}”(hŒ˜The Bareudp tunnel module provides a generic L3 encapsulation support for tunnelling different L3 protocols like MPLS, IP, NSH etc. inside a UDP tunnel.”h]”hŒ˜The Bareudp tunnel module provides a generic L3 encapsulation support for tunnelling different L3 protocols like MPLS, IP, NSH etc. inside a UDP tunnel.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K hhÊh²hubhÉ)”}”(hhh]”(hÎ)”}”(hŒSpecial Handling”h]”hŒSpecial Handling”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjh²hh³hÇh´KubhÞ)”}”(hXrThe bareudp device supports special handling for MPLS & IP as they can have multiple ethertypes. The MPLS protocol 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.”h]”hXrThe bareudp device supports special handling for MPLS & IP as they can have multiple ethertypes. The MPLS protocol 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.”…””}”(hj!h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khjh²hubeh}”(h]”Œspecial-handling”ah ]”h"]”Œspecial handling”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KubhÉ)”}”(hhh]”(hÎ)”}”(hŒUsage”h]”hŒUsage”…””}”(hj:h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj7h²hh³hÇh´KubhŒenumerated_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hXjDevice creation & deletion a) ip link add dev bareudp0 type bareudp dstport 6635 ethertype mpls_uc 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 ”h]”(hÞ)”}”(hŒDevice creation & deletion”h]”hŒDevice creation & deletion”…””}”(hjSh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhjOubhŒ block_quote”“”)”}”(hXIa) ip link add dev bareudp0 type bareudp dstport 6635 ethertype mpls_uc 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 ”h]”jI)”}”(hhh]”(jN)”}”(hX!ip link add dev bareudp0 type bareudp dstport 6635 ethertype mpls_uc 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. ”h]”(hÞ)”}”(hŒDip link add dev bareudp0 type bareudp dstport 6635 ethertype mpls_uc”h]”hŒDip link add dev bareudp0 type bareudp dstport 6635 ethertype mpls_uc”…””}”(hjnh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhjjubhÞ)”}”(hŒÚ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.”h]”hŒÚ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.”…””}”(hj|h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khjjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jMhjgubjN)”}”(hŒip link delete bareudp0 ”h]”hÞ)”}”(hŒip link delete bareudp0”h]”hŒip link delete bareudp0”…””}”(hj”h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K#hjubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhjgubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œ loweralpha”Œprefix”hŒsuffix”Œ)”uh1jHhjcubah}”(h]”h ]”h"]”h$]”h&]”uh1jah³hÇh´KhjOubeh}”(h]”h ]”h"]”h$]”h&]”uh1jMhjJh²hh³hÇh´NubjN)”}”(hŒ-Device creation with multiproto mode enabled ”h]”hÞ)”}”(hŒ,Device creation with multiproto mode enabled”h]”hŒ,Device creation with multiproto mode enabled”…””}”(hjÃh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K%hj¿ubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhjJh²hh³hÇh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j®Œarabic”j°hj±j²uh1jHhj7h²hh³hÇh´KubhÞ)”}”(hŒÍThe multiproto mode allows bareudp tunnels to handle several protocols of the same family. It is currently only available for IP and MPLS. This mode has to be enabled explicitly with the "multiproto" flag.”h]”hŒÑThe multiproto mode allows bareudp tunnels to handle several protocols of the same family. It is currently only available for IP and MPLS. This mode has to be enabled explicitly with the “multiproto†flag.”…””}”(hjÞh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K'hj7h²hubjb)”}”(hXca) ip link add dev bareudp0 type bareudp dstport 6635 ethertype ipv4 multiproto For an IPv4 tunnel the multiproto mode allows the tunnel to also handle IPv6. b) ip link add dev bareudp0 type bareudp dstport 6635 ethertype mpls_uc multiproto For MPLS, the multiproto mode allows the tunnel to handle both unicast and multicast MPLS packets. ”h]”jI)”}”(hhh]”(jN)”}”(hŒœip link add dev bareudp0 type bareudp dstport 6635 ethertype ipv4 multiproto For an IPv4 tunnel the multiproto mode allows the tunnel to also handle IPv6. ”h]”(hÞ)”}”(hŒLip link add dev bareudp0 type bareudp dstport 6635 ethertype ipv4 multiproto”h]”hŒLip link add dev bareudp0 type bareudp dstport 6635 ethertype ipv4 multiproto”…””}”(hj÷h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K+hjóubhÞ)”}”(hŒMFor an IPv4 tunnel the multiproto mode allows the tunnel to also handle IPv6.”h]”hŒMFor an IPv4 tunnel the multiproto mode allows the tunnel to also handle IPv6.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K-hjóubeh}”(h]”h ]”h"]”h$]”h&]”uh1jMhjðubjN)”}”(hŒ´ip link add dev bareudp0 type bareudp dstport 6635 ethertype mpls_uc multiproto For MPLS, the multiproto mode allows the tunnel to handle both unicast and multicast MPLS packets. ”h]”(hÞ)”}”(hŒOip link add dev bareudp0 type bareudp dstport 6635 ethertype mpls_uc multiproto”h]”hŒOip link add dev bareudp0 type bareudp dstport 6635 ethertype mpls_uc multiproto”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K0hjubhÞ)”}”(hŒbFor MPLS, the multiproto mode allows the tunnel to handle both unicast and multicast MPLS packets.”h]”hŒbFor MPLS, the multiproto mode allows the tunnel to handle both unicast and multicast MPLS packets.”…””}”(hj+h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K2hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1jMhjðubeh}”(h]”h ]”h"]”h$]”h&]”j®j¯j°hj±j²uh1jHhjìubah}”(h]”h ]”h"]”h$]”h&]”uh1jah³hÇh´K+hj7h²hubjI)”}”(hhh]”jN)”}”(hŒ Device Usage ”h]”hÞ)”}”(hŒ Device Usage”h]”hŒ Device Usage”…””}”(hjRh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K5hjNubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhjKh²hh³hÇh´Nubah}”(h]”h ]”h"]”h$]”h&]”j®jÝj°hj±j²Œstart”Kuh1jHhj7h²hh³hÇh´K5ubhÞ)”}”(hXxThe 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 the SKB dst field before sending the packet buffer to the bareudp device for transmission. On reception, the bareUDP device extracts and stores the tunnel information in the SKB dst field before passing the packet buffer to the network stack.”h]”hXxThe 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 the SKB dst field before sending the packet buffer to the bareudp device for transmission. On reception, the bareUDP device extracts and stores the tunnel information in the SKB dst field before passing the packet buffer to the network stack.”…””}”(hjmh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K7hj7h²hubeh}”(h]”Œusage”ah ]”h"]”Œusage”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´Kubeh}”(h]”Œ(bare-udp-tunnelling-module-documentation”ah ]”h"]”Œ(bare udp tunnelling module documentation”ah$]”h&]”uh1hÈhhh²hh³hÇh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÇuh1hŒcurrent_source”NŒ current_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hÍNŒ generator”NŒ datestamp”NŒ source_link”NŒ source_url”NŒ toc_backlinks”Œentry”Œfootnote_backlinks”KŒ sectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒ strip_classes”NŒ report_level”KŒ halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ traceback”ˆŒinput_encoding”Œ utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j®Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œ language_code”Œen”Œrecord_dependencies”NŒconfig”NŒ id_prefix”hŒauto_id_prefix”Œid”Œ dump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÇŒ _destination”NŒ _config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒ raw_enabled”KŒline_length_limit”M'Œpep_references”NŒ pep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒ rfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œ smart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œ docinfo_xform”KŒsectsubtitle_xform”‰Œ image_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jˆj…j4j1j€j}uŒ nametypes”}”(jˆ‰j4‰j€‰uh}”(j…hÊj1jj}j7uŒ footnote_refs”}”Œ citation_refs”}”Œ autofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ footnotes”]”Œ citations”]”Œautofootnote_start”KŒsymbol_footnote_start”KŒ id_counter”Œ collections”ŒCounter”“”}”…”R”Œparse_messages”]”hŒsystem_message”“”)”}”(hhh]”hÞ)”}”(hŒ:Enumerated list start value not ordinal-1: "3" (ordinal 3)”h]”hŒ>Enumerated list start value not ordinal-1: “3†(ordinal 3)”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝhjubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”hÇŒline”Kuh1jhj7h²hh³hÇh´K5ubaŒtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nh²hub.