# Getting Started with the PVS\-Studio Static Analyzer for C\+\+ Development under Linux PVS\-Studio supports analyzing projects developed in C, C\+\+, C\#, and Java\. You can use the analyzer under Windows, Linux, and macOS\. This small article will tell you the basics of analyzing C and C\+\+ code in Linux environment\. ![0652_PVS-Studio-for-Linux/image1.png](https://import.viva64.com/docx/blog/0652_PVS-Studio-for-Linux/image1.png) ## Installation There are different ways to install PVS\-Studio under Linux, depending on your distro type\. The most convenient and preferred method is to use the repository, since it allows auto\-updating the analyzer upon releasing new versions\. Another option is to use the installation package, which you can get [here](https://pvs-studio.com/en/pvs-studio/download/)\. The installation commands differ depending on the Linux distro you are using\. For instance, this is how installation from the repository under Debian\-based systems looks like: ```cpp wget -q -O - https://files.pvs-studio.com/etc/pubkey.txt | sudo apt-key add - sudo wget -O /etc/apt/sources.list.d/viva64.list \ https://files.pvs-studio.com/etc/viva64.list sudo apt update sudo apt install pvs-studio ``` To install PVS\-Studio from the downloadable package, you can use the _gdebi_ utility: ```cpp sudo gdebi pvs-studio-VERSION.deb ``` The installation process is described in greater detail in the "[Installing and updating PVS\-Studio on Linux](https://pvs-studio.com/en/docs/manual/0039/)" documentation section\. You can also find information on non\-Debian systems there\. Once PVS\-Studio is installed, you need to enter license data\. Here's the command for that: ```cpp pvs-studio-analyzer credentials NAME KEY [-o LIC-FILE] ``` _NAME_ and _KEY_ are the registered user name, and the license key respectively\. The optional parameter _–o_ allows you to specify the location, where a license file will be generated\. By default, it will be stored in the _\~/\.config/PVS\-Studio/_ directory\. If you need a trial key, you can get it at the "[Download and evaluate PVS\-Studio](https://pvs-studio.com/en/pvs-studio/download/)" page\. ## Checking your project Once you get the analyzer installed, you can start checking projects\. There are two main ways to do this: 1. Compilation monitoring\. 1. Running from build systems directly\. Let's talk about the first way\. To launch the monitoring under Linux, you need the [_strace_](https://man7.org/linux/man-pages/man1/strace.1.html) utility\. PVS\-Studio uses it to collect a list and parameters of processes, which were launched during the build\. Use the command below to initiate the build: ```cpp pvs-studio-analyzer trace -- make ``` Here, _make_ is used, but any other command that you're running to build your project can be in its place\. If needed, you can pass command\-line parameters to it in the usual way\. After the build, _strace_ will create a file, which the analyzer will then use to check the source code\. To start the analysis, use the command below\. ```cpp pvs-studio-analyzer analyze -o /path/to/project.log ``` As a result, an encoded log file will be generated, which you can convert to one of supported formats\. We'll talk about working with reports later\. Besides _strace_, you can base the analysis on the _compile\_commands\.json_ \(JSON Compilation Database\) file\. Many build systems have built\-in means of exporting compilation commands, or you could use the [BEAR](https://github.com/rizsotto/Bear) utility to do this\. Here's the command to launch the analysis in this case: ```cpp pvs-studio-analyzer analyze –f /path/to/compile_commands.json ``` Note that the analyzer recognizes the compiler, used in the build process, by its executable name\. If you get the "No compilation units were found" error whilst attempting to analyze your project, try explicitly specifying the name of your compiler via the _–compiler_ or _–C_ command\-line key: ```cpp pvs-studio-analyzer analyze -C MyCompiler ``` You may need this if you're using cross\-compilation, or if your compiler has a non\-standard executable name\. Besides monitoring mode, you can integrate the analyzer directly into your build system or IDE\. Our official [GitHub](https://github.com/viva64) repository provides example projects where the integration has already been configured: * [pvs\-studio\-cmake\-examples](https://github.com/viva64/pvs-studio-cmake-examples) * [pvs\-studio\-qmake\-examples](https://github.com/viva64/pvs-studio-qmake-examples) * [pvs\-studio\-makefile\-examples](https://github.com/viva64/pvs-studio-makefile-examples) * [pvs\-studio\-waf\-examples](https://github.com/viva64/pvs-studio-waf-examples) * [pvs\-studio\-eclipse\-examples](https://github.com/viva64/pvs-studio-eclipse-examples) To learn more on running the analyzer under Linux, see the [documentation](https://pvs-studio.com/en/docs/manual/0036/)\. ## Working with reports After checking a project, the analyzer creates an encoded report\. To convert it to one of supported formats, you need to use the _plog\-converter_ utility, which comes with the PVS\-Studio installation\. Here's a list of supported formats: * xml\-a convenient format for further processing of the results of the analysis, which is supported supported by the [plugin for SonarQube](https://pvs-studio.com/en/docs/manual/0037/); * csv \- file stores tabular data \(numbers and text\) in plain text; * errorfile is the output format of the gcc and clang; * tasklist \- an error format that can be opened in QtCreator; * html \- html report with a short description of the analysis results; * fullhtml \- report with sorting of the analysis results according to the different parameters and navigation along the source code\. The fullhtml format is the most convenient one for viewing the report, since it allows jumping to the line of code, corresponding to the warning you're interested in\. The following command allows you to convert the report to this format: ```cpp plog-converter -a GA:1,2 -t fullhtml /path/project.log -o /path/report_dir ``` When you launch it, a newly created directory named _/path/report\_dir_ will contain all the report files\. Pay attention to the _\-a_ parameter\. It allows you to specify, which warnings should appear in the resulting report\. It is convenient if you need to filter the analyzer's output\. The above command will create a report, which will contain only general analysis messages of the first and second certainty levels \(_High_ and _Medium_\)\. An example report: ![0652_PVS-Studio-for-Linux/image2.png](https://import.viva64.com/docx/blog/0652_PVS-Studio-for-Linux/image2.png) By clicking within a message's _Location_ cell, you can jump to the corresponding line of code: ![0652_PVS-Studio-for-Linux/image3.png](https://import.viva64.com/docx/blog/0652_PVS-Studio-for-Linux/image3.png) By clicking the diagnostic code in the _Code_ column, you can open documentation on this diagnostic\. ## Suppressing analyzer warnings When using any static analyzer to check source code, you might get false positives, or simply undesirable noise warnings\. PVS\-Studio has means of suppressing such messages\. To target individual warnings, you can use one of the methods described in the "[Suppression of false alarms](https://pvs-studio.com/en/docs/manual/0017/)" documentation article\. Also, when checking old code you might want to suppress all warnings\. As a rule, you may need this if you only want to check new code that you add to an existing codebase\. To do this, use the _suppress_ parameter of the _pvs\-studio\-analyzer_ utility\. You can mass\-suppress warnings in a report by using this command: ```cpp pvs-studio-analyzer suppress /path/to/report.log ``` Information on suppressed warnings is stored in a file named _suppress\_base\.json_, which is located next to the project\. Such messages are excluded from reports on subsequent checks\. This mechanism is described in detail [here](https://pvs-studio.com/en/docs/manual/0032/)\. ## Conclusion This was a brief introduction into using PVS\-Studio under Linux\. I hope it was useful and managed to answer the most frequent questions\. If you need more information on the topic of this article, refer to documentation [here](https://pvs-studio.com/en/docs/manual/0036/)\.