€•¡4Œ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Œ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.”…””}”(hhîhž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”…””}”(hhÿhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hhühž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 Khhühž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¹hj#hž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”…””}”(hj?hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj;ubhŒ 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]”j5)”}”(hhh]”(j:)”}”(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”…””}”(hjZhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhjVubhÊ)”}”(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.”…””}”(hjhhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhjVubeh}”(h]”h ]”h"]”h$]”h&]”uh1j9hjSubj:)”}”(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#hj|ubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hjSubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œ loweralpha”Œprefix”hŒsuffix”Œ)”uh1j4hjOubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhŸh³h Khj;ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j9hj6hžhhŸh³h Nubj:)”}”(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&]”uh1j9hj6hžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”jšŒarabic”jœhjjžuh1j4hj#hž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'hj#hžhubjN)”}”(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]”j5)”}”(hhh]”(j:)”}”(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.”…””}”(hjñhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K-hjßubeh}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÜubj:)”}”(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”…””}”(hj hž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.”…””}”(hjhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K2hjubeh}”(h]”h ]”h"]”h$]”h&]”uh1j9hjÜubeh}”(h]”h ]”h"]”h$]”h&]”jšj›jœhjjžuh1j4hjØubah}”(h]”h ]”h"]”h$]”h&]”uh1jMhŸh³h K+hj#hžhubj5)”}”(hhh]”j:)”}”(hŒ Device Usage ”h]”hÊ)”}”(hŒ Device Usage”h]”hŒ Device Usage”…””}”(hj>hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K5hj:ubah}”(h]”h ]”h"]”h$]”h&]”uh1j9hj7hžhhŸh³h Nubah}”(h]”h ]”h"]”h$]”h&]”jšjÉjœhjjžŒstart”Kuh1j4hj#hž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.”…””}”(hjYhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K7hj#hž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”}”(jtjqj jjljiuŒ nametypes”}”(jt‰j ‰jl‰uh}”(jqh¶jhüjij#uŒ 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Éhjþubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”h³Œline”Kuh1jühj#hžhhŸh³h K5ubaŒtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nhžhub.