path: root/doc
diff options
authorBruce Richardson <>2018-10-12 16:34:04 +0100
committerThomas Monjalon <>2018-11-06 03:20:26 +0100
commita5563b85f6fab9cf81d27827e0146f621127047a (patch)
tree699fdf7bef09f2351a93d3b173d41089662d58d1 /doc
parent9af4eb5657107b05b0e06141291b7c6e6162bb36 (diff)
test: allow taking extra arguments from environment
When running unit tests automatically, either via script, from meson, or otherwise, the same set of options may be used for each run, for example to set a standard coremask to be used for all tests. To facilitate this, this patch adds support for the test binary taking additional EAL parameters from the environment and appending them to the argc/argv list passed to eal init. This allows parameter modification without having to edit test scripts etc. There are now two environment variables which can be used for running tests: * DPDK_TEST - (added previously) passes the test name to be run automatically rather than running the app interactively. Used by "meson test" when running tests individually or as part of a suite. * DPDK_TEST_PARAMS - new parameter to specify the commandline arguments to use with the test binary. For example to run a test, or tests, on only 16 lcores, and to skip pci scan we can set this to "-l 0-15 --no-pci". Signed-off-by: Bruce Richardson <> Tested-by: Luca Boccassi <>
Diffstat (limited to 'doc')
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/guides/rel_notes/release_18_11.rst b/doc/guides/rel_notes/release_18_11.rst
index cfa92b8..51d0075 100644
--- a/doc/guides/rel_notes/release_18_11.rst
+++ b/doc/guides/rel_notes/release_18_11.rst
@@ -301,6 +301,14 @@ New Features
computation to the NIST Cryptographic Algorithm Validation Program (CAVP)
test vectors.
+* **Allow unit test binary to take parameters from the environment**
+ The unit test "test", or "dpdk-test", binary is often called from scripts,
+ which can make passing additional parameters, such as a coremask, to it more
+ awkward. Support has been added to the application to allow it to take
+ additional command-line parameter values from the "DPDK_TEST_PARAMS"
+ environment variable to make this application easier to use.
API Changes