monero-project/monero
monero-project/monero
1
0
Fork 0
mirror of https://github.com/monero-project/monero.git synced 2024-12-23 03:59:33 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Merge pull request #7368

Browse source 
dc66115 Formatted markdown in readme.md (Timo Sarkar)
This commit is contained in:
luigi1111 2021-03-20 01:39:02 -04:00
commit e2a3f5cadd
No known key found for this signature in database
GPG key ID: F4ACA0183641E010
1 changed files with 14 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

21
utils/health/README.md
View file

@ -1,26 +1,32 @@
#Intro # Intro
This directory contains tools, which can be used for checking the health of the project, like build/run time analyzers, lints, etc. This directory contains tools, which can be used for checking the health of the project, like build/run time analyzers, lints, etc.
#Usage # 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: 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` `og@ghetto:~/dev/monero$ utils/health/clang-build-time-analyzer-run.sh`
##ClangBuildAnalyzer ## ClangBuildAnalyzer
`utils/health/clang-build-time-analyzer-run.sh` `utils/health/clang-build-time-analyzer-run.sh`
The CBA helps in finding culprints of slow compilation. 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. 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 ## clang-tidy
`utils/health/clang-tidy-run.sh` `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/). 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/).
##include-what-you-use ## include-what-you-use
`utils/health/clang-include-what-you-use-run.sh` `utils/health/clang-include-what-you-use-run.sh`
Analyses the header file hierarchy and delivers hints on how to reduce their complexity. More information on the [home page](https://include-what-you-use.org/). Analyses the header file hierarchy and delivers hints on how to reduce their complexity. More information on the [home page](https://include-what-you-use.org/).
##Valgrind checks ## Valgrind checks
`utils/health/valgrind-tests.sh` `utils/health/valgrind-tests.sh`
This script is able to run valgrind's callgrind, cachegrind and memcheck for a given set of executables. 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: It expects ONE PARAMETER, which points to a file with paths to executables and their arguments, written line by line. For example:
@ -33,6 +39,7 @@ build/tests/unit_tests/unit_tests
The `*.out` results can be interpreted with the `kcachegrind` tool. 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. The memcheck output is just a readable text file with a summary at the end.
#Footer # Footer
Responsible: mj-xmr Responsible: mj-xmr