Coco License Utilization

Process-based license counting

Coco licenses are floating licenses. They are bound to processes, not to computers. One needs as many licenses as there are Coco processes running at the same time. A Coco process can be:

1. an instance of CoverageScanner or of the compiler wrappers
2. an instance of coveragescannertcl or cocoqmlscanner
3. an instance of the CoverageBrowser and Test Data Editor
4. each instance of the command line tools such as cmmerge, cmcsexeimport and cmreport

If there are no licenses available, these tools will block and wait for a license. So for example, you might need to exit CoverageBrowser in order to run cmreport.

Every compiler call that is instrumented by Coco is counted separately because it requires one instance of the CoverageScanner to run. In builds with several compilations in parallel, a process that cannot get a license will wait until one is freed.

License Requirement Conditions

In the following, we explain under what circumstances Coco's various tools need a floating license, and what use-cases are do not require a floating license.

• Running any of the Coco command line tools and GUI applications requires a Coco floating license for the duration of the process execution.
• Running a Coco instrumented program (C++, C#, QML or TCL) to generate execution reports does not require a floating license.

For Coco Test Engine, the following applies:

• Instrumenting a target program (or unit test program) with CoverageScanner requires a Coco floating license.
• Running cocotestengine in any mode (Test, Learn, Discovery) requires a Coco floating license.
• Test Data Discovery requires cocotestengine to run an executable instrumented with CoverageScanner. A license is required during both the instrumentation and the discovery process.
• Running the target program (or unit test program) directly in Test Mode or Learn Mode does not require that it be instrumented.
• However, when running an instrumented executable in Test Mode or Learn Mode, coverage data can be additionally obtained.