cppcheck/readme.md

235 lines
7.6 KiB
Markdown
Raw Permalink Normal View History

2015-09-21 22:41:38 +02:00
# **Cppcheck**
|GitHub Actions|Linux Build Status|Windows Build Status|OSS-Fuzz|Coverity Scan Build Status|License|
|:-:|:--:|:--:|:--:|:--:|:-:|
2020-06-15 20:04:43 +02:00
|[![Github Action Status](https://github.com/danmar/cppcheck/workflows/CI/badge.svg)](https://github.com/danmar/cppcheck/actions?query=workflow%3ACI)|[![Linux Build Status](https://img.shields.io/travis/danmar/cppcheck/main.svg?label=Linux%20build)](https://travis-ci.org/danmar/cppcheck)|[![Windows Build Status](https://img.shields.io/appveyor/ci/danmar/cppcheck/main.svg?label=Windows%20build)](https://ci.appveyor.com/project/danmar/cppcheck/branch/main)|[![OSS-Fuzz](https://oss-fuzz-build-logs.storage.googleapis.com/badges/cppcheck.svg)](https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:cppcheck)|[![Coverity Scan Build Status](https://img.shields.io/coverity/scan/512.svg)](https://scan.coverity.com/projects/512)|[![License](https://img.shields.io/badge/license-GPL3.0-blue.svg)](https://opensource.org/licenses/GPL-3.0)
2012-06-06 16:15:41 +02:00
2012-12-23 10:56:38 +01:00
## About the name
2012-06-06 16:15:41 +02:00
2012-12-23 10:56:38 +01:00
The original name of this program was "C++check", but it was later changed to "Cppcheck".
2012-06-06 16:15:41 +02:00
Despite the name, Cppcheck is designed for both C and C++.
2012-12-23 10:56:38 +01:00
## Manual
2012-06-06 16:15:41 +02:00
A manual is available [online](https://cppcheck.sourceforge.io/manual.pdf).
2012-06-06 16:15:41 +02:00
2019-11-02 08:25:04 +01:00
## Donate CPU
Cppcheck is a hobby project with limited resources. You can help us by donating CPU (1 core or as many as you like). It is simple:
1. Download (and extract) Cppcheck source code.
2. Run script: python cppcheck/tools/donate-cpu.py.
2019-11-02 08:25:04 +01:00
The script will analyse debian source code and upload the results to a cppcheck server. We need these results both to improve Cppcheck and to detect regressions.
You can stop the script whenever you like with Ctrl C.
2012-12-23 10:56:38 +01:00
## Compiling
2012-06-06 16:15:41 +02:00
2018-04-10 06:52:33 +02:00
Any C++11 compiler should work. For compilers with partial C++11 support it may work. If your compiler has the C++11 features that are available in Visual Studio 2013 / GCC 4.6 then it will work.
2012-06-06 16:15:41 +02:00
To build the GUI, you need Qt.
When building the command line tool, [PCRE](http://www.pcre.org/) is optional. It is used if you build with rules.
2012-06-06 16:15:41 +02:00
There are multiple compilation choices:
* qmake - cross platform build tool
2015-07-29 10:21:04 +02:00
* cmake - cross platform build tool
2018-12-08 07:03:28 +01:00
* Windows: Visual Studio (VS 2013 and above)
2015-07-29 10:21:04 +02:00
* Windows: Qt Creator + mingw
2012-06-06 16:15:41 +02:00
* gnu make
2015-07-29 10:21:04 +02:00
* g++ 4.6 (or later)
* clang++
2012-06-06 16:15:41 +02:00
2019-06-27 06:51:59 +02:00
### cmake
Example, compiling Cppcheck with cmake:
```shell
mkdir build
cd build
2019-06-27 06:51:59 +02:00
cmake ..
cmake --build .
2019-06-27 06:51:59 +02:00
```
If you want to compile the GUI you can use the flag.
2019-06-27 06:51:59 +02:00
-DBUILD_GUI=ON
For rules support (requires pcre) use the flag.
2019-06-27 06:51:59 +02:00
-DHAVE_RULES=ON
For release builds it is recommended that you use:
-DUSE_MATCHCOMPILER=ON
Using cmake you can generate project files for Visual Studio,XCode,etc.
2012-12-23 10:56:38 +01:00
### qmake
2012-06-06 16:15:41 +02:00
You can use the gui/gui.pro file to build the GUI.
2012-06-06 16:28:49 +02:00
```shell
2012-12-23 10:56:38 +01:00
cd gui
qmake
make
```
2012-06-06 16:15:41 +02:00
2012-12-23 10:56:38 +01:00
### Visual Studio
2012-06-06 16:15:41 +02:00
Use the cppcheck.sln file. The file is configured for Visual Studio 2019, but the platform toolset can be changed easily to older or newer versions. The solution contains platform targets for both x86 and x64.
2012-06-06 16:15:41 +02:00
To compile with rules, select "Release-PCRE" or "Debug-PCRE" configuration. pcre.lib (pcre64.lib for x64 builds) and pcre.h are expected to be in /externals then. A current version of PCRE for Visual Studio can be obtained using [vcpkg](https://github.com/microsoft/vcpkg).
2012-06-06 16:15:41 +02:00
### Visual Studio (from command line)
If you do not wish to use the Visual Studio IDE, you can compile cppcheck from the command line the following command.
```shell
msbuild cppcheck.sln
```
### VS Code (on Windows)
Install MSYS2 to get GNU toolchain with g++ and gdb (https://www.msys2.org/).
Create a settings.json file in the .vscode folder with the following content (adjust path as necessary):
```
{
"terminal.integrated.shell.windows": "C:\\msys64\\usr\\bin\\bash.exe",
"terminal.integrated.shellArgs.windows": [
"--login",
],
"terminal.integrated.env.windows": {
"CHERE_INVOKING": "1",
"MSYSTEM": "MINGW64",
}
}
```
Run "make" in the terminal to build cppcheck.
For debugging create a launch.json file in the .vscode folder with the following content, which covers configuration for debugging cppcheck and misra.py:
```
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"name": "cppcheck",
"type": "cppdbg",
"request": "launch",
"program": "${workspaceFolder}/cppcheck.exe",
"args": [
"--dump",
"${workspaceFolder}/addons/test/misra/misra-test.c"
],
"stopAtEntry": false,
"cwd": "${workspaceFolder}",
"environment": [],
"externalConsole": true,
"MIMode": "gdb",
"miDebuggerPath": "C:/msys64/mingw64/bin/gdb.exe",
"setupCommands": [
{
"description": "Enable pretty-printing for gdb",
"text": "-enable-pretty-printing",
"ignoreFailures": true
}
]
},
{
"name": "misra.py",
"type": "python",
"request": "launch",
"program": "${workspaceFolder}/addons/misra.py",
"console": "integratedTerminal",
"args": [
"${workspaceFolder}/addons/test/misra/misra-test.c.dump"
]
}
]
}
```
2012-12-23 10:56:38 +01:00
### Qt Creator + MinGW
2012-06-06 16:15:41 +02:00
The PCRE dll is needed to build the CLI. It can be downloaded here:
http://software-download.name/pcre-library-windows/
2013-12-26 19:15:52 +01:00
### GNU make
2012-06-06 16:15:41 +02:00
Simple, unoptimized build (no dependencies):
2012-06-06 16:27:44 +02:00
```shell
make
2012-12-23 10:56:38 +01:00
```
2012-06-06 16:15:41 +02:00
The recommended release build is:
2012-06-06 16:27:44 +02:00
```shell
make MATCHCOMPILER=yes FILESDIR=/usr/share/cppcheck HAVE_RULES=yes CXXFLAGS="-O2 -DNDEBUG -Wall -Wno-sign-compare -Wno-unused-function"
2012-12-23 10:56:38 +01:00
```
2012-06-06 16:15:41 +02:00
Flags:
2013-12-26 19:02:56 +01:00
1. `MATCHCOMPILER=yes`
Python is used to optimise cppcheck. The Token::Match patterns are converted into C++ code at compile time.
2013-12-26 18:56:02 +01:00
2. `FILESDIR=/usr/share/cppcheck`
Specify folder where cppcheck files are installed (addons, cfg, platform)
2013-12-26 18:56:02 +01:00
3. `HAVE_RULES=yes`
2013-12-26 19:15:52 +01:00
Enable rules (PCRE is required if this is used)
2016-01-18 19:09:43 +01:00
4. `CXXFLAGS="-O2 -DNDEBUG -Wall -Wno-sign-compare -Wno-unused-function"`
Enables most compiler optimizations, disables cppcheck-internal debugging code and enables basic compiler warnings.
2012-12-23 10:56:38 +01:00
### g++ (for experts)
2012-06-06 16:15:41 +02:00
If you just want to build Cppcheck without dependencies then you can use this command:
2012-06-06 16:27:44 +02:00
```shell
g++ -o cppcheck -std=c++11 -Iexternals -Iexternals/simplecpp -Iexternals/tinyxml2 -Iexternals/picojson -Ilib cli/*.cpp lib/*.cpp externals/simplecpp/simplecpp.cpp externals/tinyxml2/*.cpp
2012-12-23 10:56:38 +01:00
```
2012-06-06 16:15:41 +02:00
2012-12-23 10:56:38 +01:00
If you want to use `--rule` and `--rule-file` then dependencies are needed:
2012-06-06 16:27:44 +02:00
```shell
g++ -o cppcheck -std=c++11 -lpcre -DHAVE_RULES -Ilib -Iexternals -Iexternals/simplecpp -Iexternals/tinyxml2 cli/*.cpp lib/*.cpp externals/simplecpp/simplecpp.cpp externals/tinyxml2/*.cpp
2012-12-23 10:56:38 +01:00
```
2012-06-06 16:15:41 +02:00
2012-12-23 10:56:38 +01:00
### MinGW
2012-06-06 16:15:41 +02:00
```shell
mingw32-make LDFLAGS=-lshlwapi
2012-12-23 10:56:38 +01:00
```
2012-06-06 16:15:41 +02:00
### Other Compiler/IDE
2019-06-17 07:04:08 +02:00
1. Create an empty project file / makefile.
2. Add all cpp files in the cppcheck cli and lib folders to the project file / makefile.
3. Add all cpp files in the externals folders to the project file / makefile.
4. Compile.
2012-12-23 10:56:38 +01:00
### Cross compiling Win32 (CLI) version of Cppcheck in Linux
2012-06-06 16:15:41 +02:00
```shell
2012-12-23 10:56:38 +01:00
sudo apt-get install mingw32
make CXX=i586-mingw32msvc-g++ LDFLAGS="-lshlwapi" RDYNAMIC=""
2012-12-23 10:56:38 +01:00
mv cppcheck cppcheck.exe
```
2012-06-06 16:15:41 +02:00
## Packages
You can install Cppcheck with yum/apt/brew/etc.
The official rpms are built with these files:
https://src.fedoraproject.org/rpms/cppcheck/tree/master
2012-12-23 10:56:38 +01:00
## Webpage
2012-06-06 16:15:41 +02:00
https://cppcheck.sourceforge.io/