summaryrefslogtreecommitdiffstats
path: root/src/spdk/test/external_code/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'src/spdk/test/external_code/README.md')
-rw-r--r--src/spdk/test/external_code/README.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/src/spdk/test/external_code/README.md b/src/spdk/test/external_code/README.md
new file mode 100644
index 000000000..3db3218c0
--- /dev/null
+++ b/src/spdk/test/external_code/README.md
@@ -0,0 +1,17 @@
+This directory is meant to demonstrate how to link an external application and bdev
+module to the SPDK libraries. The makefiles contain six examples of linking against spdk
+libraries. They cover linking an application both with and without a custom bdev. For each of
+these categories, they also demonstrate linking against the spdk combined shared library,
+individual shared libraries, and static libraries.
+
+This directory also contains a convenient test script, test_make.sh, which automates making SPDK
+and testing all six of these linker options. It takes a single argument, the path to an SPDK
+repository and should be run as follows:
+
+~~~
+sudo ./test_make.sh /path/to/spdk
+~~~
+
+The application `hello_world` and bdev module `passthru_external` have been copied from their namesakes
+in the top level [SPDK github repository](https://github.com/spdk/spdk) and don't have any special
+functionality.