Executable Task¶

The Executable Task lets you invoke any command line executable. It doesn't offer as much specific integration as (for example) the NAnt Task, but does allow you to hook almost anything up as a build process to CCNet. CCNet will examine the exit code when the executable ends and act accordingly.

Version¶

Available from version 1.0

Examples¶

Minimalist example

1<exec executable="c:\projects\myproject\build.bat" />

Full example

 1<exec>
 2  <executable>make</executable>
 3  <baseDirectory>D:\dev\MyProject</baseDirectory>
 4  <buildArgs>all</buildArgs>
 5  <buildTimeoutSeconds>10</buildTimeoutSeconds>
 6  <successExitCodes>0,1,3,5</successExitCodes>
 7  <environment>
 8    <variable>
 9      <name>MyVar1</name>
10      <value>Var1Value</value>
11    </variable>
12    <variable name="MyVar2" value="Var2Value" />
13  </environment>
14</exec>

Configuration Elements¶

1<variable name="name" value="value" />

* Normal
* Idle
* High
* RealTime
* BelowNormal
* AboveNormal

Notes¶

note

An exit code of -1 is always treated as the operation has timed out. This will fail the build.

warning

Windows seems to change the case of environment variables occasionally. If your task target doesn't find one of these properties, try using all upper case or all lower case versions of these properties.

Frequently Asked Questions¶

Does the exec task pass the integration properties via the command line?

No. The integration properties are only available as environment variables. As there is no way of knowing the way in which the external program expects these properties to be formatted as command line arguments, environment variables are a simple, common medium for making these values accessible. To pass these environment variables into an external program, have the exec task call a batch file instead that will pick up the environment variables, format them and pass them as command line arguments to the external program.

Using built in shell commands

In Windows use cmd.exe as the executable, and pass the wanted command as an argument, preceded with /c. This allows to execute del \*.\* and the like. For example :

1<exec>
2  <executable>c:\Windows\System32\cmd.exe</executable>
3  <buildArgs>/C NET STOP "Service name"</buildArgs>
4</exec>

The following parameters are passed to the external program using environment variables, in addition to those you specify in the <environment> element.:

Integration Properties¶

Automatically Generated¶

Documentation generated on Monday, 26 May 2014 at 7:18:04 AM