summaryrefslogtreecommitdiffstats
path: root/build/external/patches/README
diff options
context:
space:
mode:
Diffstat (limited to 'build/external/patches/README')
-rw-r--r--build/external/patches/README30
1 files changed, 30 insertions, 0 deletions
diff --git a/build/external/patches/README b/build/external/patches/README
new file mode 100644
index 00000000000..0bead2ef629
--- /dev/null
+++ b/build/external/patches/README
@@ -0,0 +1,30 @@
+
+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 package to a new directory:
+ # git clone http://dpdk.org/git/dpdk dpdk
+
+2. Create a branch based on the release you wish to patch.
+Note, “git tag” will show you all the release tags. The following example is
+for release tag “v2.2.0” and will create a branch named “two_dot_two”.
+ # cd <root dir>
+ # git checkout -b two_dot_two v2.2.0
+
+3. Apply all the existing patches to this new branch.
+ # git am </path/to/existing/patches/*>
+
+4. Make your changes and commit your change to your 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 patches directory.
+