summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRenato Botelho do Couto <renato@netgate.com>2024-06-05 18:11:46 +0000
committerDamjan Marion <dmarion@0xa5.net>2024-06-10 13:13:31 +0000
commit893dacae3f93dcab24fdeb0c7e4a44d30b2db0ee (patch)
tree56d5bfe824098b8c729bebaf87cfef056c8b97f4
parentfa500e98543989e4cdcbedac19a525d55a8558d5 (diff)
build: Use $(MAKE) instead of direct call to make
No functional changes, just make it to respect original make binary name used to start building Type: improvement Change-Id: Ic8568237fbb39c6a0d3b7405a9670e9410aeb752 Signed-off-by: Renato Botelho do Couto <renato@netgate.com>
-rw-r--r--Makefile12
-rw-r--r--build-root/Makefile2
-rw-r--r--build/external/Makefile4
-rw-r--r--build/external/packages/ipsec-mb.mk2
-rw-r--r--build/external/packages/xdp-tools.mk6
-rw-r--r--docs/Makefile6
-rw-r--r--extras/hs-test/Makefile10
-rw-r--r--extras/strongswan/vpp_sswan/Makefile4
8 files changed, 23 insertions, 23 deletions
diff --git a/Makefile b/Makefile
index 1ab387e94d4..18908faf537 100644
--- a/Makefile
+++ b/Makefile
@@ -495,17 +495,17 @@ test-cov:
.PHONY: test-cov-hs
test-cov-hs:
- @make -C extras/hs-test build-cov
- @make -C extras/hs-test test-cov
+ @$(MAKE) -C extras/hs-test build-cov
+ @$(MAKE) -C extras/hs-test test-cov
.PHONY: test-cov-both
test-cov-both:
@echo "Running Python, Golang tests and merging coverage reports."
find $(BR) -name '*.gcda' -delete
- @make test-cov
+ @$(MAKE) test-cov
find $(BR) -name '*.gcda' -delete
- @make test-cov-hs
- @make cov-merge
+ @$(MAKE) test-cov-hs
+ @$(MAKE) cov-merge
.PHONY: test-cov-build
test-cov-build:
@@ -580,7 +580,7 @@ test-shell-cov:
.PHONY: test-dep
test-dep:
- @make -C test test-dep
+ @$(MAKE) -C test test-dep
.PHONY: test-doc
test-doc:
diff --git a/build-root/Makefile b/build-root/Makefile
index d69a94c1e41..df4434d7629 100644
--- a/build-root/Makefile
+++ b/build-root/Makefile
@@ -997,7 +997,7 @@ $(PLATFORM_IMAGE_DIR)/ro.img ro-image: $(patsubst %,%-find-source,$(ROOT_PACKAGE
| xargs sign $($(PLATFORM)_public_key) \
$($(PLATFORM)_private_key_passphrase) ; \
fi ; \
- : make read-only file system ; \
+ : $(MAKE) read-only file system ; \
mksquashfs \
$${tmp_dir} $${ro_image} \
-no-exports -no-progress -no-recovery ; \
diff --git a/build/external/Makefile b/build/external/Makefile
index 046dd7484ae..3cb7b47f436 100644
--- a/build/external/Makefile
+++ b/build/external/Makefile
@@ -94,7 +94,7 @@ build-deb: $(DEV_DEB)
install-deb:
ifneq ($(INSTALLED_VER),$(DEB_VER)-$(PKG_SUFFIX))
- @make $(DEV_DEB)
+ @$(MAKE) $(DEV_DEB)
@sudo dpkg -i $(DEV_DEB)
else
@echo "=========================================================="
@@ -175,7 +175,7 @@ ifeq ($(INSTALLED_VER)$(INSTALLED_RPM_VER),)
$(MAKE) config
else
ifneq ($(INSTALLED_VER),)
- make check-deb
+ $(MAKE) check-deb
endif
ifneq ($(INSTALLED_RPM_VER),)
$(MAKE) check-rpm
diff --git a/build/external/packages/ipsec-mb.mk b/build/external/packages/ipsec-mb.mk
index d38f2e306ea..ffdbcd23fb2 100644
--- a/build/external/packages/ipsec-mb.mk
+++ b/build/external/packages/ipsec-mb.mk
@@ -32,7 +32,7 @@ define ipsec-mb_config_cmds
endef
define ipsec-mb_build_cmds
- @make -C $(ipsec-mb_src_dir)/lib -j \
+ @$(MAKE) -C $(ipsec-mb_src_dir)/lib -j \
SHARED=n \
SAFE_PARAM=n \
SAFE_LOOKUP=n \
diff --git a/build/external/packages/xdp-tools.mk b/build/external/packages/xdp-tools.mk
index b65ae1361f5..b9285971f42 100644
--- a/build/external/packages/xdp-tools.mk
+++ b/build/external/packages/xdp-tools.mk
@@ -24,15 +24,15 @@ define xdp-tools_config_cmds
endef
define xdp-tools_build_cmds
- @cd ${xdp-tools_src_dir} && make V=1 BUILD_STATIC_ONLY=y > $(xdp-tools_build_log)
+ @cd ${xdp-tools_src_dir} && $(MAKE) V=1 BUILD_STATIC_ONLY=y > $(xdp-tools_build_log)
endef
define xdp-tools_install_cmds
@rm -f $(xdp-tools_install_log)
@cd ${xdp-tools_src_dir} && \
- make -C lib/libbpf/src install V=1 BUILD_STATIC_ONLY=y PREFIX='' DESTDIR='$(xdp-tools_install_dir)' >> $(xdp-tools_install_log)
+ $(MAKE) -C lib/libbpf/src install V=1 BUILD_STATIC_ONLY=y PREFIX='' DESTDIR='$(xdp-tools_install_dir)' >> $(xdp-tools_install_log)
@cd ${xdp-tools_src_dir} && \
- make libxdp_install V=1 BUILD_STATIC_ONLY=y PREFIX='' DESTDIR='$(xdp-tools_install_dir)' >> $(xdp-tools_install_log)
+ $(MAKE) libxdp_install V=1 BUILD_STATIC_ONLY=y PREFIX='' DESTDIR='$(xdp-tools_install_dir)' >> $(xdp-tools_install_log)
endef
$(eval $(call package,xdp-tools))
diff --git a/docs/Makefile b/docs/Makefile
index 01e8d659bff..9f209357113 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -70,7 +70,7 @@ venv:
spell: venv
@( \
. ${VENV_DIR}/bin/activate; \
- make -C ${SCRIPTS_DIR} generate && \
+ $(MAKE) -C ${SCRIPTS_DIR} generate && \
$(SPHINXBUILD) -b spelling $(SPHINXOPTS) $(BUILDDIR_SRC) $(BUILDDIR_OUT); \
)
@@ -81,7 +81,7 @@ rebuild-spell: clean spell
docs: venv
@( \
. ${VENV_DIR}/bin/activate; \
- make -C ${SCRIPTS_DIR} generate && \
+ $(MAKE) -C ${SCRIPTS_DIR} generate && \
$(SPHINXBUILD) $(SPHINXOPTS) -b html $(BUILDDIR_SRC) $(BUILDDIR_OUT); \
)
@@ -90,7 +90,7 @@ rebuild: clean docs
.PHONY: clean
clean:
- @make -C ${SCRIPTS_DIR} clean
+ @$(MAKE) -C ${SCRIPTS_DIR} clean
.PHONY: build
build: docs
diff --git a/extras/hs-test/Makefile b/extras/hs-test/Makefile
index dc34e5332ea..d459d9d916c 100644
--- a/extras/hs-test/Makefile
+++ b/extras/hs-test/Makefile
@@ -87,15 +87,15 @@ list-tests:
.PHONY: build-vpp-release
build-vpp-release:
- @make -C ../.. build-release
+ @$(MAKE) -C ../.. build-release
.PHONY: build-vpp-debug
build-vpp-debug:
- @make -C ../.. build
+ @$(MAKE) -C ../.. build
.PHONY: build-vpp-gcov
build-vpp-gcov:
- @make -C ../.. build-vpp-gcov
+ @$(MAKE) -C ../.. build-vpp-gcov
.build.ok: build
@touch .build.ok
@@ -129,7 +129,7 @@ test-cov: .deps.ok .build.cov.ok
-bash ./test --persist=$(PERSIST) --verbose=$(VERBOSE) \
--unconfigure=$(UNCONFIGURE) --debug=$(DEBUG) --test=$(TEST-HS) --cpus=$(CPUS) \
--vppsrc=$(VPPSRC)
- @make -C ../.. test-cov-post HS_TEST=1
+ @$(MAKE) -C ../.. test-cov-post HS_TEST=1
@bash ./script/compress.sh
.PHONY: build-go
@@ -155,7 +155,7 @@ build-debug: .deps.ok build-vpp-debug build-go
@touch .build.ok
.deps.ok:
- @sudo make install-deps
+ @sudo $(MAKE) install-deps
.PHONY: install-deps
install-deps:
diff --git a/extras/strongswan/vpp_sswan/Makefile b/extras/strongswan/vpp_sswan/Makefile
index 254b90b3b09..85fb506f346 100644
--- a/extras/strongswan/vpp_sswan/Makefile
+++ b/extras/strongswan/vpp_sswan/Makefile
@@ -76,8 +76,8 @@ install-swan:
echo "SSWAN not downloaded, please run "make" or "make pull-swan" first." ; \
exit 1 ; \
fi
- cd ${SWANDIR} && make -j$(nproc)
- cd ${SWANDIR} && sudo make install
+ cd ${SWANDIR} && $(MAKE) -j$(nproc)
+ cd ${SWANDIR} && sudo $(MAKE) install
# check if VPP is installed
ifneq ($(shell test "$(shell ldconfig -p | grep vppinfra.so | awk 'NR==1{print $$1;}')" && echo "yes"), yes)
'>577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868
Network Working Group                                           P. Quinn
Internet-Draft                                       Cisco Systems, Inc.
Intended status: Experimental                                 P. Agarwal
Expires: January 4, 2015                                        Broadcom
                                                             R. Fernando
                                                              L. Kreeger
                                                                D. Lewis
                                                                F. Maino
                                                                M. Smith
                                                                N. Yadav
                                                     Cisco Systems, Inc.
                                                                 L. Yong
                                                              Huawei USA
                                                                   X. Xu
                                                     Huawei Technologies
                                                                U. Elzur
                                                                   Intel
                                                                 P. Garg
                                                               Microsoft
                                                            July 3, 2014


                  Generic Protocol Extension for VXLAN
                      draft-quinn-vxlan-gpe-03.txt

Abstract

   This draft describes extending Virtual eXtensible Local Area Network
   (VXLAN), via changes to the VXLAN header, with three new
   capabilities: support for multi-protocol encapsulation, operations,
   administration and management (OAM) signaling and explicit
   versioning.

Status of this Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF).  Note that other groups may also distribute
   working documents as Internet-Drafts.  The list of current Internet-
   Drafts is at http://datatracker.ietf.org/drafts/current/.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."




Quinn, et al.            Expires January 4, 2015                [Page 1]

Internet-Draft    Generic Protocol Extension for VXLAN         July 2014


   This Internet-Draft will expire on January 4, 2015.

Copyright Notice

   Copyright (c) 2014 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (http://trustee.ietf.org/license-info) in effect on the date of
   publication of this document.  Please review these documents
   carefully, as they describe your rights and restrictions with respect
   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.



































Quinn, et al.            Expires January 4, 2015                [Page 2]

Internet-Draft    Generic Protocol Extension for VXLAN         July 2014


Table of Contents

   1.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  4
   2.  VXLAN Without Protocol Extension . . . . . . . . . . . . . . .  5
   3.  Generic Protocol Extension VXLAN (VXLAN-gpe) . . . . . . . . .  6
     3.1.  Multi Protocol Support . . . . . . . . . . . . . . . . . .  6
     3.2.  OAM Support  . . . . . . . . . . . . . . . . . . . . . . .  7
     3.3.  Version Bits . . . . . . . . . . . . . . . . . . . . . . .  7
   4.  Backward Compatibility . . . . . . . . . . . . . . . . . . . .  8
     4.1.  VXLAN VTEP to VXLAN-gpe VTEP . . . . . . . . . . . . . . .  8
     4.2.  VXLAN-gpe VTEP to VXLAN VTEP . . . . . . . . . . . . . . .  8
     4.3.  VXLAN-gpe UDP Ports  . . . . . . . . . . . . . . . . . . .  8
     4.4.  VXLAN-gpe and Encapsulated IP Header Fields  . . . . . . .  8
   5.  VXLAN-gpe Examples . . . . . . . . . . . . . . . . . . . . . .  9
   6.  Security Considerations  . . . . . . . . . . . . . . . . . . . 11
   7.  Acknowledgments  . . . . . . . . . . . . . . . . . . . . . . . 12
   8.  IANA Considerations  . . . . . . . . . . . . . . . . . . . . . 13
     8.1.  UDP Port . . . . . . . . . . . . . . . . . . . . . . . . . 13
     8.2.  VXLAN-gpe Next Protocol  . . . . . . . . . . . . . . . . . 13
     8.3.  VXLAN-gpe Reserved Bits  . . . . . . . . . . . . . . . . . 13
   9.  References . . . . . . . . . . . . . . . . . . . . . . . . . . 14
     9.1.  Normative References . . . . . . . . . . . . . . . . . . . 14
     9.2.  Informative References . . . . . . . . . . . . . . . . . . 14
   Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 15



























Quinn, et al.            Expires January 4, 2015                [Page 3]

Internet-Draft    Generic Protocol Extension for VXLAN         July 2014


1.  Introduction

   Virtual eXtensible Local Area Network [VXLAN] defines an
   encapsulation format that encapsulates Ethernet frames in an outer
   UDP/IP transport.  As data centers evolve, the need to carry other
   protocols encapsulated in an IP packet is required, as well as the
   need to provide increased visibility and diagnostic capabilities
   within the overlay.  The VXLAN header does not specify the protocol
   being encapsulated and therefore is currently limited to
   encapsulating only Ethernet frame payload, nor does it provide the
   ability to define OAM protocols.  Rather than defining yet another
   encapsulation, VXLAN is extended to provide protocol typing and OAM
   capabilities.

   This document describes extending VXLAN via the following changes:

   Next Protocol Bit (P bit):  A reserved flag bit is allocated, and set
      in the VXLAN-gpe header to indicate that a next protocol field is
      present.

   OAM Flag Bit (O bit):  A reserved flag bit is allocated, and set in
      the VXLAN-gpe header, to indicate that the packet is an OAM
      packet.

   Version:  Two reserved bits are allocated, and set in the VXLAN-gpe
      header, to indicate VXLAN-gpe protocol version.

   Next Protocol:  A 8 bit next protocol field is present in the VXLAN-
      gpe header.






















Quinn, et al.            Expires January 4, 2015                [Page 4]

Internet-Draft    Generic Protocol Extension for VXLAN         July 2014


2.  VXLAN Without Protocol Extension

   As described in the introduction, the VXLAN header has no protocol
   identifier that indicates the type of payload being carried by VXLAN.
   Because of this, VXLAN is limited to an Ethernet payload.
   Furthermore, the VXLAN header has no mechanism to signal OAM packets.

   The VXLAN header defines bits 0-7 as flags (some defined, some
   reserved), the VXLAN network identifier (VNI) field and several
   reserved bits.  The flags provide flexibility to define how the
   reserved bits can be used to change the definition of the VXLAN
   header.



    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |R|R|R|R|I|R|R|R|            Reserved                           |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |                VXLAN Network Identifier (VNI) |   Reserved    |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+


                          Figure 1: VXLAN Header


























Quinn, et al.            Expires January 4, 2015                [Page 5]

Internet-Draft    Generic Protocol Extension for VXLAN         July 2014


3.  Generic Protocol Extension VXLAN (VXLAN-gpe)

3.1.  Multi Protocol Support

   This draft defines the following two changes to the VXLAN header in
   order to support multi-protocol encapsulation:

   P Bit:  Flag bit 5 is defined as the Next Protocol bit.  The P bit
      MUST be set to 1 to indicate the presence of the 8 bit next
      protocol field.

      P = 0 indicates that the payload MUST conform to VXLAN as defined
      in [VXLAN].

      Flag bit 5 was chosen as the P bit because this flag bit is
      currently reserved in VXLAN.

   Next Protocol Field:  The lower 8 bits of the first word are used to
      carry a next protocol.  This next protocol field contains the
      protocol of the encapsulated payload packet.  A new protocol
      registry will be requested from IANA.

      This draft defines the following Next Protocol values:

      0x1 : IPv4
      0x2 : IPv6
      0x3 : Ethernet
      0x4 : Network Service Header [NSH]




    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |R|R|R|R|I|P|R|R|   Reserved                    |Next Protocol  |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |                VXLAN Network Identifier (VNI) |   Reserved    |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+



                     Figure 2: VXLAN-gpe Next Protocol








Quinn, et al.            Expires January 4, 2015                [Page 6]

Internet-Draft    Generic Protocol Extension for VXLAN         July 2014


3.2.  OAM Support

   Flag bit 7 is defined as the O bit.  When the O bit is set to 1, the
   packet is an OAM packet and OAM processing MUST occur.  The OAM
   protocol details are out of scope for this document.  As with the
   P-bit, bit 7 is currently a reserved flag in VXLAN.



    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |R|R|R|R|I|P|R|O|   Reserved                    |Next Protocol  |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |                VXLAN Network Identifier (VNI) |   Reserved    |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+



                        Figure 3: VXLAN-gpe OAM Bit

3.3.  Version Bits

   VXLAN-gpe bits 8 and 9 are defined as version bits.  These bits are
   reserved in VXLAN.  The version field is used to ensure backward
   compatibility going forward with future VXLAN-gpe updates.

   The initial version for VXLAN-gpe is 0.



    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |R|R|R|R|I|P|R|O|Ver|   Reserved                |Next Protocol  |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |                VXLAN Network Identifier (VNI) |   Reserved    |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+





                     Figure 4: VXLAN-gpe Version Bits







Quinn, et al.            Expires January 4, 2015                [Page 7]

Internet-Draft    Generic Protocol Extension for VXLAN         July 2014


4.  Backward Compatibility

4.1.  VXLAN VTEP to VXLAN-gpe VTEP

   As per VXLAN, reserved bits 5 and 7, VXLAN-gpe P and O-bits
   respectively must be set to zero.  The remaining reserved bits must
   be zero, including the VXLAN-gpe version field, bits 8 and 9.  The
   encapsulated payload MUST be Ethernet.

4.2.  VXLAN-gpe VTEP to VXLAN VTEP

   A VXLAN-gpe VTEP MUST NOT encapsulate non-Ethernet frames to a VXLAN
   VTEP.  When encapsulating Ethernet frames to a VXLAN VTEP, the VXLAN-
   gpe VTEP will set the P bit to 0, the Next Protocol to 0 and use UDP
   destination port 4789.  A VXLAN-gpe VTEP MUST also set O = 0 and Ver
   = 0 when encapsulating Ethernet frames to VXLAN VTEP.  The receiving
   VXLAN VTEP will threat this packet as a VXLAN packet.

   A method for determining the capabilities of a VXLAN VTEP (gpe or
   non-gpe) is out of the scope of this draft.

4.3.  VXLAN-gpe UDP Ports

   VXLAN-gpe uses a new UDP destination port (to be assigned by IANA)
   when sending traffic to VXLAN-gpe VTEPs.

4.4.  VXLAN-gpe and Encapsulated IP Header Fields

   When encapsulating and decapsulating IPv4 and IPv6 packets, certain
   fields, such as IPv4 Time to Live (TTL) from the inner IP header need
   to be considered.  VXLAN-gpe IP encapsulation and decapsulation
   utilizes the techniques described in [RFC6830], section 5.3.



















Quinn, et al.            Expires January 4, 2015                [Page 8]

Internet-Draft    Generic Protocol Extension for VXLAN         July 2014


5.  VXLAN-gpe Examples

   This section provides three examples of protocols encapsulated using
   the Generic Protocol Extension for VXLAN described in this document.



    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |R|R|R|R|I|1|R|0|0|0|   Reserved                |    NP = IPv4  |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |                VXLAN Network Identifier (VNI) |   Reserved    |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |               Original IPv4 Packet                            |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+



                       Figure 5: IPv4 and VXLAN-gpe




    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |R|R|R|R|I|1|R|0|0|0|   Reserved                |  NP = IPv6    |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |                VXLAN Network Identifier (VNI) |   Reserved    |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |               Original IPv6 Packet                            |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+



                       Figure 6: IPv6 and VXLAN-gpe














Quinn, et al.            Expires January 4, 2015                [Page 9]

Internet-Draft    Generic Protocol Extension for VXLAN         July 2014


    0                   1                   2                   3
    0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |R|R|R|R|I|1|R|0|0|0|   Reserved                |NP = Ethernet  |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |                VXLAN Network Identifier (VNI) |   Reserved    |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |               Original Ethernet Frame                         |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+



                     Figure 7: Ethernet and VXLAN-gpe






































Quinn, et al.            Expires January 4, 2015               [Page 10]

Internet-Draft    Generic Protocol Extension for VXLAN         July 2014


6.  Security Considerations

   VXLAN's security is focused on issues around L2 encapsulation into
   L3.  With VXLAN-gpe, issues such as spoofing, flooding, and traffic
   redirection are dependent on the particular protocol payload
   encapsulated.













































Quinn, et al.            Expires January 4, 2015               [Page 11]

Internet-Draft    Generic Protocol Extension for VXLAN         July 2014


7.  Acknowledgments

   A special thank you goes to Dino Farinacci for his guidance and
   detailed review.















































Quinn, et al.            Expires January 4, 2015               [Page 12]

Internet-Draft    Generic Protocol Extension for VXLAN         July 2014


8.  IANA Considerations

8.1.  UDP Port

   A new UDP port will be requested from IANA.

8.2.  VXLAN-gpe Next Protocol

   IANA is requested to set up a registry of "Next Protocol".  These are
   8-bit values.  Next Protocol values 0, 1, 2, 3 and 4 are defined in
   this draft.  New values are assigned via Standards Action [RFC5226].

              +---------------+-------------+---------------+
              | Next Protocol | Description | Reference     |
              +---------------+-------------+---------------+
              | 0             | Reserved    | This document |
              |               |             |               |
              | 1             | IPv4        | This document |
              |               |             |               |
              | 2             | IPv6        | This document |
              |               |             |               |
              | 3             | Ethernet    | This document |
              |               |             |               |
              | 4             | NSH         | This document |
              |               |             |               |
              | 5..253        | Unassigned  |               |
              +---------------+-------------+---------------+

                                  Table 1

8.3.  VXLAN-gpe Reserved Bits

   There are ten bits at the beginning of the VXLAN-gpe header.  New
   bits are assigned via Standards Action [RFC5226].

   Bits 0-3 - Reserved
   Bit 4 - Instance ID (I bit)
   Bit 5 - Next Protocol (P bit)
   Bit 6 - Reserved
   Bit 7 - OAM (O bit)
   Bits 8-9 - Version










Quinn, et al.            Expires January 4, 2015               [Page 13]

Internet-Draft    Generic Protocol Extension for VXLAN         July 2014


9.  References

9.1.  Normative References

   [RFC0768]  Postel, J., "User Datagram Protocol", STD 6, RFC 768,
              August 1980.

   [RFC0791]  Postel, J., "Internet Protocol", STD 5, RFC 791,
              September 1981.

   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119, March 1997.

   [RFC5226]  Narten, T. and H. Alvestrand, "Guidelines for Writing an
              IANA Considerations Section in RFCs", BCP 26, RFC 5226,
              May 2008.

9.2.  Informative References

   [NSH]      Quinn, P. and et al. , "Network Service Header", 2014.

   [RFC1700]  Reynolds, J. and J. Postel, "Assigned Numbers", RFC 1700,
              October 1994.

   [RFC6830]  Farinacci, D., Fuller, V., Meyer, D., and D. Lewis, "The
              Locator/ID Separation Protocol (LISP)", RFC 6830,
              January 2013.

   [VXLAN]    Dutt, D., Mahalingam, M., Duda, K., Agarwal, P., Kreeger,
              L., Sridhar, T., Bursell, M., and C. Wright, "VXLAN: A
              Framework for Overlaying Virtualized Layer 2 Networks over
              Layer 3 Networks", 2013.



















Quinn, et al.            Expires January 4, 2015               [Page 14]

Internet-Draft    Generic Protocol Extension for VXLAN         July 2014


Authors' Addresses

   Paul Quinn
   Cisco Systems, Inc.

   Email: paulq@cisco.com


   Puneet Agarwal
   Broadcom

   Email: pagarwal@broadcom.com


   Rex Fernando
   Cisco Systems, Inc.

   Email: rex@cisco.com


   Larry Kreeger
   Cisco Systems, Inc.

   Email: kreeger@cisco.com


   Darrel Lewis
   Cisco Systems, Inc.

   Email: darlewis@cisco.com


   Fabio Maino
   Cisco Systems, Inc.

   Email: kreeger@cisco.com


   Michael Smith
   Cisco Systems, Inc.

   Email: michsmit@cisco.com









Quinn, et al.            Expires January 4, 2015               [Page 15]

Internet-Draft    Generic Protocol Extension for VXLAN         July 2014


   Navindra Yadav
   Cisco Systems, Inc.

   Email: nyadav@cisco.com


   Lucy Yong
   Huawei USA

   Email: lucy.yong@huawei.com


   Xiaohu Xu
   Huawei Technologies

   Email: xuxiaohu@huawei.com


   Uri Elzur
   Intel

   Email: uri.elzur@intel.com


   Pankaj Garg
   Microsoft

   Email: Garg.Pankaj@microsoft.com