Copy Page

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account. You can also Sign Up for a new account.

<table class="wysiwyg-macro" data-macro-name="unmigrated-inline-wiki-markup" data-macro-parameters="atlassian-macro-output-type=BLOCK" style="background-image: url(/plugins/servlet/confluence/placeholder/macro-heading?definition=e3VubWlncmF0ZWQtaW5saW5lLXdpa2ktbWFya3VwOmF0bGFzc2lhbi1tYWNyby1vdXRwdXQtdHlwZT1CTE9DS30&amp;locale=en_GB&amp;version=2); background-repeat: no-repeat;" data-macro-body-type="PLAIN_TEXT"><tr><td class="wysiwyg-macro-body"><pre>{iframe:src=http://update.sonarsource.org/plugins/cxx.html|width=700|height=250|frameborder=0}
Your browser does not support iframes.
{iframe}</pre></td></tr></table><h1>Description / Features</h1>This plugin adds basic support of C++ language into Sonar.Current feature list:<ul><li>Basic size metrics: <ul><li>Files (number of)</li><li>Lines</li><li>Lines of comments</li><li>Lines of code</li><li>Lines of commented out code</li></ul></li><li>Static code checking via virtually any static analyser tool. And possibility of extension of their coding rules.</li><li>Dynamic checking for memory management problems via <a href="http://valgrind.org/">Valgrind</a></li><li>Cyclomatic (McCabe) complexity metrics including:  <ul><li>Projects complexity</li><li>Average function/method complexity</li><li>Average file complexity</li><li>Complexity distributions</li></ul></li><li>Code coverage metrics including: <ul><li>Unit test overage (line and branch)</li><li>Integration test coverage (line and branch)</li><li>Overall branch coverage (line and branch)</li></ul></li><li>Unit test execution metrics including: <ul><li>Successfully executed tests</li><li>Failed tests</li><li>Skipped tests</li><li>Execution time</li></ul></li><li>Recognition of code duplication</li><li>Basic highlighting mode for C++ in Sonar UI</li></ul><h2>Dependencies</h2>The Cxx-Plugin has an obligatory dependency on Java (of course... the plugin itself and all runners are Java programs).Moreover, there are optional dependencies on:<ul><li>Various external code analyzers:<ul><li><a href="http://cppcheck.sourceforge.net/">Cppcheck</a>. Detects a wide range of problems ranging from performance issues and resource leakage to undefined behaviour. Binary packets are available on/for various platforms. Using the latest release pays off in general; compile from source if in doubt.</li><li><a href="https://www.fortify.com/ssa-elements/threat-intelligence/rats.html">RATS</a>. Detects (potential) security problems in code, sensible for code bases with increased security requirements. Use binary packages or compile from source.</li><li><a href="http://www.inspirel.com/vera/">Vera++</a>. Focuses on code style issues. There's a binary package for Windows, users of other platforms are likely to compile themselves.</li><li><a href="http://valgrind.org/">Valgrind (memcheck)</a>. Detects various memory management problems at runtime. Basically Linux only; just use the packages from your distribution.</li><li><a href="http://cppncss.sourceforge.net/">CppNcss</a>. Provides cyclomatic (McCabe) complexity measures. This is a Java program distributed as a zip archive. Just unpack and make sure the &quot;bin&quot; directory is in PATH.</li><li><a href="http://www.gimpel.com/html/pcl.htm">Pc-Lint</a>. Static analyser from Gimpel</li></ul></li><li><a href="http://gcc.gnu.org/">GCC</a>, <a href="http://gcc.gnu.org/onlinedocs/gcc/Gcov.html">gcov</a>, <a href="https://software.sandia.gov/trac/fast/wiki/gcovr">gcovr</a>, <a href="http://www.bullseye.com/">Bullseye</a> and <a href="http://www.python.org/">Python</a> for coverage determination. Install Python and place the script somewhere on the PATH.  </li></ul><h2>Installation</h2> <ol><li>Via Update Center</li><li>Or copy the jar-archive into &lt;sonar home&gt;<code>/extensions/plugins/</code> directory</li><li>Restart the Sonar web server</li></ol><h2>Quick Configuration Guide</h2> Cxx plugin uses the following properties during analysis. See <a href="http://docs.codehaus.org/display/SONAR/Analyzing+Source+Code">here</a> for the ways how to pass them to the plugin.  <table class="confluenceTable"><tbody><tr><th class="confluenceTh">Property</th><th colspan="1" class="confluenceTh">Scope</th><th colspan="1" class="confluenceTh">Default</th><th class="confluenceTh">Example</th><th class="confluenceTh">Description</th></tr><tr><td class="confluenceTd">sonar.cxx.suffixes.sources</td><td colspan="1" class="confluenceTd">System- and/or project-wide</td><td colspan="1" class="confluenceTd">cxx,cpp,cc,c</td><td class="confluenceTd">.C,.h</td><td class="confluenceTd">Comma separated list of file name extension to be considered as C++ source files during analysis.</td></tr><tr><td colspan="1" class="confluenceTd">sonar.cxx.suffixes.headers</td><td colspan="1" class="confluenceTd">System- and/or project-wide</td><td colspan="1" class="confluenceTd">hxx,hpp,hh,h</td><td colspan="1" class="confluenceTd"> </td><td colspan="1" class="confluenceTd">Comma separated list of file name extension to be considered as C++ source files during analysis.</td></tr><tr><td class="confluenceTd">sonar.cxx.cppcheck.reportPath</td><td colspan="1" class="confluenceTd">Project-wide</td><td colspan="1" class="confluenceTd">cppcheck-reports/cppcheck-result-*.xml</td><td class="confluenceTd">cppcheck-report-*.xml</td><td class="confluenceTd">Ant pattern describing the path to Cppcheck reports, relative to projects root.</td></tr><tr><td colspan="1" class="confluenceTd">sonar.cxx.cppncss.reportPath</td><td colspan="1" class="confluenceTd">Project-wide</td><td colspan="1" class="confluenceTd">cppncss-reports/cppncss-result-*.xml</td><td colspan="1" class="confluenceTd">cppncss-report-*.xml</td><td colspan="1" class="confluenceTd">Ant pattern describing the path to CppNcss reports, relative to projects root.</td></tr><tr><td colspan="1" class="confluenceTd">sonar.cxx.gcovr.reportPath (&lt;0.2)</td><td colspan="1" class="confluenceTd">Project-wide</td><td colspan="1" class="confluenceTd">gcovr-reports/gcovr-result-*.xml</td><td colspan="1" class="confluenceTd">gcovr-report-*.xml</td><td colspan="1" class="confluenceTd">Ant pattern describing the path to gcovr reports, relative to projects root.</td></tr><tr><td colspan="1" class="confluenceTd">sonar.cxx.rats.reportPath</td><td colspan="1" class="confluenceTd">Project-wide</td><td colspan="1" class="confluenceTd">rats-reports/rats-result-*.xml</td><td colspan="1" class="confluenceTd">rats-report-*.xml</td><td colspan="1" class="confluenceTd">Ant pattern describing the path to RATS reports, relative to projects root.</td></tr><tr><td colspan="1" class="confluenceTd">sonar.cxx.valgrind.reportPath</td><td colspan="1" class="confluenceTd">Project-wide</td><td colspan="1" class="confluenceTd">valgrind-reports/valgrind-result-*.xml</td><td colspan="1" class="confluenceTd">valgrind-report-*.xml</td><td colspan="1" class="confluenceTd">Ant pattern describing the path to Valgrind reports, relative to projects root.</td></tr><tr><td colspan="1" class="confluenceTd">sonar.cxx.vera.reportPath</td><td colspan="1" class="confluenceTd">Project-wide</td><td colspan="1" class="confluenceTd">vera++-reports/vera++-result-*.xml</td><td colspan="1" class="confluenceTd">vera-report-*.xml</td><td colspan="1" class="confluenceTd">Ant pattern describing the path to Vera++ reports, relative to projects root.</td></tr><tr><td colspan="1" class="confluenceTd">sonar.cxx.xunit.reportPath</td><td colspan="1" class="confluenceTd">Project-wide</td><td colspan="1" class="confluenceTd">xunit-reports/xunit-result-*.xml</td><td colspan="1" class="confluenceTd">xunit-report-*.xml</td><td colspan="1" class="confluenceTd">Ant pattern describing the path to unit test execution reports, relative to projects root.</td></tr><tr><td colspan="1" class="confluenceTd">sonar.cxx.pclint.reportPath</td><td colspan="1" class="confluenceTd">Project-wide</td><td colspan="1" class="confluenceTd">pclint-reports/pclint-result-*.xml</td><td colspan="1" class="confluenceTd">pclint-result-*.xml</td><td colspan="1" class="confluenceTd">Ant pattern describing the path to pc-lint reports, relative to projects root.</td></tr><tr><td colspan="1" class="confluenceTd">sonar.cxx.externalrules.reportPath</td><td colspan="1" class="confluenceTd">Project-wide</td><td colspan="1" class="confluenceTd">externalrules-result/externalrules-result-*.xml</td><td colspan="1" class="confluenceTd">externalrules-result-*.xml</td><td colspan="1" class="confluenceTd">Ant pattern describing the path to unit test execution reports, relative to projects root.</td></tr><tr><td colspan="1" class="confluenceTd">sonar.cxx.xunit.xsltURL</td><td colspan="1" class="confluenceTd">Project-wide</td><td colspan="1" class="confluenceTd"> </td><td colspan="1" class="confluenceTd">cppunit-1.x-to-junit-1.0.xsl</td><td colspan="1" class="confluenceTd">A name of a built in XSLT-file or an URL to an external one. Available builtins:<ul><li>boosttest-1.x-to-junit-1.0.xsl         For transforming Boost-reports</li><li>cpptestunit-1.x-to-junit-1.0.xsl      For transforming CppTestUnit-reports</li><li>cppunit-1.x-to-junit-1.0.xsl            For transforming CppUnit-reports</li></ul></td></tr><tr><td colspan="1" class="confluenceTd">sonar.cxx.coverage.reportPath (&gt;=0.2)</td><td colspan="1" class="confluenceTd">Project-wide</td><td colspan="1" class="confluenceTd">coverage-reports/coverage-*.xml</td><td colspan="1" class="confluenceTd">coverage-*.xml</td><td colspan="1" class="confluenceTd">Ant pattern describing the path of unit test coverage reports, relative to projects root.</td></tr><tr><td colspan="1" class="confluenceTd">sonar.cxx.coverage.itReportPath (&gt;=0.2)</td><td colspan="1" class="confluenceTd">Project-wide</td><td colspan="1" class="confluenceTd">coverage-reports/it-coverage-*.xml</td><td colspan="1" class="confluenceTd">it-coverage-*.xml</td><td colspan="1" class="confluenceTd">Ant pattern describing the path of integration test coverage reports, relative to projects root. </td></tr><tr><td colspan="1" class="confluenceTd">sonar.cxx.coverage.overallReportPath (&gt;=0.2)</td><td colspan="1" class="confluenceTd">Project-wide</td><td colspan="1" class="confluenceTd">coverage-reports/overall-coverage-*.xml</td><td colspan="1" class="confluenceTd">overall-coverage-*.xml</td><td colspan="1" class="confluenceTd">Ant pattern describing the path of overall test coverage reports, relative to projects root.</td></tr></tbody></table> Note: Report paths are always relative to projects path.<h1>Known limitations</h1><ul><li>Some analyzers (RATS, most notably) may have issues and crash occasionally.</li><li>Valgrind is only available on a subset of UNIX platforms.</li></ul><h2>Roadmap</h2>Following items are in the queue (more or less...):<ul><li>Use SSLR technology</li><li>Integrate compiler warnings</li><li>Implement the dependency analysis (package tangle index metric)</li></ul><h2>Changelog</h2><img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e2ppcmFpc3N1ZXM6YW5vbnltb3VzPXRydWV8dGl0bGU9VmVyc2lvbiAwLjJ8Y29sdW1ucz10eXBlO2tleTtzdW1tYXJ5O3ByaW9yaXR5O3N0YXR1c3x1cmw9aHR0cDovL2ppcmEuY29kZWhhdXMub3JnL3NyL2ppcmEuaXNzdWV2aWV3czpzZWFyY2hyZXF1ZXN0LXhtbC90ZW1wL1NlYXJjaFJlcXVlc3QueG1sP2pxbFF1ZXJ5PXByb2plY3QrJTNEK1NPTkFSUExVR0lOUytBTkQrZml4VmVyc2lvbislM0QrJTIyQ1hYLTAuMiUyMiZ0ZW1wTWF4PTEwMDB9&amp;locale=en_GB&amp;version=2" data-macro-name="jiraissues" data-macro-parameters="anonymous=true|columns=type;key;summary;priority;status|title=Version 0.2|url=http://jira.codehaus.org/sr/jira.issueviews:searchrequest-xml/temp/SearchRequest.xml?jqlQuery\=project+%3D+SONARPLUGINS+AND+fixVersion+%3D+%22CXX-0.2%22&amp;tempMax\=1000"><img class="editor-inline-macro" src="/plugins/servlet/confluence/placeholder/macro?definition=e2ppcmFpc3N1ZXM6YW5vbnltb3VzPXRydWV8dGl0bGU9VmVyc2lvbiAwLjF8Y29sdW1ucz10eXBlO2tleTtzdW1tYXJ5O3ByaW9yaXR5O3N0YXR1c3x1cmw9aHR0cDovL2ppcmEuY29kZWhhdXMub3JnL3NyL2ppcmEuaXNzdWV2aWV3czpzZWFyY2hyZXF1ZXN0LXhtbC90ZW1wL1NlYXJjaFJlcXVlc3QueG1sP2pxbFF1ZXJ5PXByb2plY3QrJTNEK1NPTkFSUExVR0lOUytBTkQrZml4VmVyc2lvbislM0QrJTIyQ1hYLTAuMSUyMiZ0ZW1wTWF4PTEwMDB9&amp;locale=en_GB&amp;version=2" data-macro-name="jiraissues" data-macro-parameters="anonymous=true|columns=type;key;summary;priority;status|title=Version 0.1|url=http://jira.codehaus.org/sr/jira.issueviews:searchrequest-xml/temp/SearchRequest.xml?jqlQuery\=project+%3D+SONARPLUGINS+AND+fixVersion+%3D+%22CXX-0.1%22&amp;tempMax\=1000">