diff -r c7c26511138f -r 7c4a911dc066 buildframework/helium/sf/java/sbs/doc/sbscoverity.rst --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/buildframework/helium/sf/java/sbs/doc/sbscoverity.rst Fri Aug 13 14:59:05 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 coverity.enabled=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 + + + + + +- 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 + + + + + + + + + +- Internally "coveritybuild" task will run the "cov-build" with parameters passed with "" 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 -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 task if "build.system=sbs-ec". + +