1.. _coverity:
2
3Coverity
4#########
5
6Coverity Scan is a service by which Black Duck provides the results of analysis
7on open source coding projects to open source code developers that have
8registered their products with Coverity Scan.
9
10This integration was only tested with scan.coverity.com and the tool
11distribution available through this service.
12
13Generating Build Data Files
14***************************
15
16To use this integration, coverity tool distribution must be found in your :envvar:`PATH` environment and
17:ref:`west build <west-building>` should be called with a ``-DZEPHYR_SCA_VARIANT=coverity``
18parameter, e.g.
19
20.. code-block:: shell
21
22    west build -b qemu_cortex_m3 samples/hello_world -- -DZEPHYR_SCA_VARIANT=coverity
23
24
25Results of the scan will be generated as :file:`build/sca/coverity`.
26
27You can also set :envvar:`COVERITY_OUTPUT_DIR` as the destination for multiple
28and incremental scan results.
29
30Result Analysis
31****************
32
33Follow the instructions on https://scan.coverity.com for uploading results.
34