summaryrefslogtreecommitdiffstats
path: root/build/external/README
diff options
context:
space:
mode:
authorDamjan Marion <damarion@cisco.com>2018-09-18 18:41:38 +0200
committerDamjan Marion <damarion@cisco.com>2018-09-20 14:30:54 +0200
commit4a6cb83d334e391f85332ea38a2e467ac7743e4b (patch)
tree7d667a9d07c33e1a948f73892169f61da595ca4f /build/external/README
parent9c0a3c423ee0b9326f600a00c1bd46fef45d4975 (diff)
rename vpp-dpdk-dev to vpp-ext-deps
We need to have new tenants in the development package. This is first of series of patches which will allow us to have multiple external libs and tools packaged for developer's convenience. Change-Id: I884bd75fba96005bbf8cea92774682b2228e0e22 Signed-off-by: Damjan Marion <damarion@cisco.com>
Diffstat (limited to 'build/external/README')
-rw-r--r--build/external/README34
1 files changed, 34 insertions, 0 deletions
diff --git a/build/external/README b/build/external/README
new file mode 100644
index 00000000000..95154dc235f
--- /dev/null
+++ b/build/external/README
@@ -0,0 +1,34 @@
+
+Changes needed to DPDK are stored here as git patch files. Maintaining these
+files using “git format-patch” and “git am” will make it simpler to manage
+these changes. Patches made to DPDK should only be temporary until they are
+accepted upstream and made available in the next DPDK release.
+
+The following is the method used to generate these patches:
+
+1. Git clone the DPDK to a new directory:
+ # git clone http://dpdk.org/git/dpdk dpdk
+
+2. Create a branch based on the DPDK release you wish to patch.
+Note, “git tag” will show you all the release tags. The following example is
+for DPDK release tag “v2.2.0” and will create a branch named “two_dot_two”.
+ # cd dpdk
+ # git checkout -b two_dot_two v2.2.0
+
+3. Apply all the existing VPP DPDK patches to this new branch.
+ # git am <VPP directory>/dpdk/dpdk-2.2.0_patches/*
+
+4. Make your changes and commit your change to your DPDK repository.
+ # <edit files>
+ # git commit -s
+
+5. Create the patch files with format-patch. This creates all the patch files
+for your branch (two_dot_two), with your latest commits as the last ones.
+ # git format-patch master..two_dot_two
+
+6. Copy, add and commit the new patches into the VPP patches directory.
+ # cp <new patch files> <VPP directory>/dpdk/dpdk-2.2.0_patches
+ # cd <VPP directory>
+ # git add dpdk/dpdk-2.2.0_patches/<new patch files>
+ # git commit -s
+