diff options
author | mj-xmr <mjxmr@protonmail.com> | 2020-11-04 19:27:06 +0100 |
---|---|---|
committer | mj-xmr <mjxmr@protonmail.com> | 2020-12-02 20:42:38 +0100 |
commit | e591341237e93c3cf8997b61eae5b1dc16dbb92e (patch) | |
tree | 88b96f144914ec1ebac9c1c4b6ba3172c0a828dd /utils/health/README.md | |
parent | Merge pull request #7025 (diff) | |
download | monero-e591341237e93c3cf8997b61eae5b1dc16dbb92e.tar.xz |
Clang-tidy integrated into CMakeLists.txt
Can be called from the source directory with:
utils/health/clang-tidy-run.sh
Diffstat (limited to '')
-rw-r--r-- | utils/health/README.md | 34 |
1 files changed, 34 insertions, 0 deletions
diff --git a/utils/health/README.md b/utils/health/README.md new file mode 100644 index 000000000..dea46280e --- /dev/null +++ b/utils/health/README.md @@ -0,0 +1,34 @@ +#Intro +This directory contains tools, which can be used for checking the health of the project, like build/run time analyzers, lints, etc. + +#Usage +Unless it's stated differently, these scripts should be called from a given source directory, where you want the checks to be performed, for instance: + +`og@ghetto:~/dev/monero$ utils/health/clang-build-time-analyzer-run.sh` + +##ClangBuildAnalyzer +`utils/health/clang-build-time-analyzer-run.sh` +The CBA helps in finding culprints of slow compilation. +On the first run, the script will complain about the missing ClangBuildAnalyzer binary and will point you to another script, which is able to clone and build the required binary. + +##clang-tidy +`utils/health/clang-tidy-run.sh` +Performs Lint checks on the source code and stores the result in the build directory. More information on the [home page](https://clang.llvm.org/extra/clang-tidy/). + + +##Valgrind checks +`utils/health/valgrind-tests.sh` +This script is able to run valgrind's callgrind, cachegrind and memcheck for a given set of executables. +It expects ONE PARAMETER, which points to a file with paths to executables and their arguments, written line by line. For example: + +``` +ls -l -h +build/tests/unit_tests/unit_tests +``` + +The `*.out` results can be interpreted with the `kcachegrind` tool. +The memcheck output is just a readable text file with a summary at the end. + +#Footer +Responsible: mj-xmr + |