aboutsummaryrefslogtreecommitdiffstats
path: root/src/README
diff options
context:
space:
mode:
authorAihua Li <aihua.li@huawei.com>2015-03-11 14:12:41 -0700
committerAihua Li <aihua.li@huawei.com>2015-03-12 10:21:34 -0700
commitb4b06d27b062a65ef98753d7f1d9d340fa773329 (patch)
treed454fdd1a6361ede58c6412a6e6c88eddc22e199 /src/README
parentbde8e3211f4e80cce5c6521a09528a9cc403d6d2 (diff)
added mechanism to pull upstream packages and provided single top-level make
Change-Id: I13bcce3104377cac84a736cfd9a3d9df208e91f0 JIRA: VSPERF-25 Signed-off-by: Aihua Li <aihua.li@huawei.com> Reviewed-by: Maryam Tahhan <maryam.tahhan@intel.com> Reviewed-by: Gene Snider <eugene.snider@huawei.com> Reviewed-by: Stephen Finucane <stephen.finucane@intel.com>
Diffstat (limited to 'src/README')
-rw-r--r--src/README28
1 files changed, 28 insertions, 0 deletions
diff --git a/src/README b/src/README
new file mode 100644
index 00000000..ff1a1b8e
--- /dev/null
+++ b/src/README
@@ -0,0 +1,28 @@
+### Purpose of this folder - Quickview
+
+1. contains place holders for upstream source code package.
+2. manages the package dependency
+3. provides simple one-button build for test developers
+
+### Motivation Explained
+
+There are multiple goals for the project vswitch performance characterization.
+First, it is a generic test framework that can be used to characterize any vswitch solution.
+Second, it is to be as CI tool to validate any change during development.
+
+For the first goal, it would be nice to get all the relevant upstream source package and
+to provide a easy build environment for a given test developer. Obviously we don't want to
+rewrite the makefile system from upstream project. However we need to add a wrapper to the
+individual packages to manage package dependecy. For example, to test ovs-dpdk vswitch solution,
+the build of ovs would depend on the build result of dpdk.
+This dependency is never explicitly specified in the individual package.
+
+For the second goal as a CI tool, it may not be needed to pull the upstream package.
+So this whole folder can be ignored.
+
+### Files and subfolders
+
+* package-list: contains list of packages and their associated tags
+* mk: contains top level makefiles
+* dpdk: place holder for dpdk package
+* ovs: place holder for ovs package.