--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/buildframework/helium/sf/java/sbs/sbscoverity.rst Tue Apr 27 08:33:08 2010 +0300
@@ -0,0 +1,70 @@
+.. index::
+ module: Configuring Coverity Prevent Tool with SBS
+
+==========================================
+Configuring Coverity Prevent Tool with SBS
+==========================================
+
+.. contents::
+
+This document describes requirements and how to run coverity prevent tool with sbs builds using helium.
+
+Requirements
+-----------------
+
+Please go through "Configuring Raptor (SBS)" before proceeding into this document.
+
+
+Implementation
+-----------------
+- Coverity prevent tool commands are integrated with SBS task.
+- Before starting the build we need to setup the property enabled.coverity=true to enable the coverity prevent tool with build.
+- Coverity task extends the "sbstask", so what ever the arguments we pass for sbstask will remain same for coverity tool also.
+- For example
+
+.. code-block:: xml
+
+ <hlm:coveritybuild sbsinput="@{sbs.input}"
+ sysdeffile="${build.drive}/output/build/canonical_system_definition_${sysdef.configuration}.xml"
+ layerpatternsetref="${sbs.patternset}"
+ workingdir="${build.drive}/"
+ execute="true"
+ failonerror="false"
+ outputlog="${sbs.log.file}"
+ cleanlog = "${sbs.clean.log}"
+ erroroutput="${sbs.log.file}.sbs_error.log"
+ statslog="${sbs.log.file}.info.xml">
+ <hlm:coverityoptions refid="coverity.build.options"/>
+ </hlm:coveritybuild>
+
+- In above example coverity prevent tool is integrated with sbs using task "coveritybuild".
+- This task is slightly difference from sbstask as it accepts the coverity tool parameters required while running coverity tool.
+- In the above example we have mentioned "coverity.build.options" which are required for cov-build command.
+- coverityoptions datatype will follow below syntax.
+
+.. code-block:: xml
+
+ <hlm:coverityoptions id="coverity.build.options">
+ <arg name="--config" value="${coverity.config.dir}/coverity_config.xml"/>
+ <arg name="--dir" value="${coverity.inter.dir}"/>
+ <arg name="--auto-diff" value=""/>
+ <arg name="--preprocess-first" value=""/>
+ <arg name="--record-only" value=""/>
+ </hlm:coverityoptions>
+
+- Internally "coveritybuild" task will run the "cov-build" with parameters passed with "<hlm:coverityoptions>" datatype and sbs commands.
+- Above arguments are passed by default in helium. If it is required to remove/change the default parameters (by helium)into cov-build, we need to override the datatype "coverityoptions".
+
+- Command resulted for above example is shown below with "@{sbs.input} = dfs_build_input_armv5".
+
+ | cov-build.exe --auto-diff --record-only --config Y:/output/coverity/config/coverity_config.xml
+ | --preprocess-first --dir Y:/output/coverity/intermidiate sbs -s Y:/output/build/canonical_system_definition_dfs_build.xml
+ | -c armv5 --filters=FilterMetadataLog -k --logfile Y:/output/logs/compile/ido_helloworld_tb92_blr_ci_9.2.30_armv5_dfs_build.log
+ | --makefile=Y:/output/logs/compile/ido_helloworld_tb92_blr_ci_9.2.30_armv5_dfs_build
+
+Note:
+--------------------
+- Helium also supports other coverity tool commands. Please refer to section to "Coverity Prevent Tool" section.
+- Coverity tool prevent tool can't run with emake. emake options are disabled with <hlm:coveritybuild> task if "build.system=sbs-ec".
+
+