aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMathieu Poirier <mathieu.poirier@linaro.org>2018-01-30 14:37:34 -0700
committerMike Leach <mike.leach@linaro.org>2018-01-31 12:04:46 +0000
commitcee5610ae4155dc0c25c4b1e31bc8dc1d9a87725 (patch)
tree7d78cb700d7ab129cb1c7b47fdb5f419a11c1624
parent12aa605bcc0a24ab9cfef1cf01c8ad976262711b (diff)
HOWTO: Document alternate library build process
The perf tools build script has the capability to compile and link against a different library than the (default) system's openCSD library. This patch documents how to use two environment variable to tell the build system where to get the library from. Signed-off-by: Mathieu Poirier <mathieu.poirier@linaro.org>
-rw-r--r--HOWTO.md19
1 files changed, 19 insertions, 0 deletions
diff --git a/HOWTO.md b/HOWTO.md
index b13408720d43..dfaf9de6452e 100644
--- a/HOWTO.md
+++ b/HOWTO.md
@@ -366,6 +366,25 @@ output as follows:-
Set to any other value will remove the RAW_PACKED lines.
+Working with a debug version of the openCSD library
+---------------------------------------------------
+When compiling the perf tools it is possible to reference another version of
+the openCSD library than the one installed on the system. This is useful when
+working with multiple development trees or having the desire to keep system
+libraries intact. Two environment variable are available to tell the perf tools
+build script where to get the header file and libraries, namely CSINCLUDES and
+CSLIBS:
+
+ linaro@t430:~/linaro/linux-kernel$ export CSINCLUDES=~/linaro/coresight/my-opencsd/decoder/include/
+ linaro@t430:~/linaro/linux-kernel$ export CSLIBS=~/linaro/coresight/my-opencsd/decoder/lib/linux64-rel/
+ linaro@t430:~/linaro/linux-kernel$ make VF=1 -C tools/perf
+
+This will have the effect of compiling and linking against the provided library.
+Since the system's openCSD library is in the loader's search patch the
+LD_LIBRARY_PATH environment variable needs to be set.
+
+ linaro@t430:~/linaro/linux-kernel$ export LD_LIBRARY_PATH=$CSLIBS
+
Trace Decoding with Perf Report
-------------------------------