<control : ExecTask>

Description

Executes a given command if the os platform is appropriate.

Parameters

Attribute Description Type Required?
resultproperty Sets the name of a property in which the return code of the command should be stored. Only of interest if failonerror=false. String ?
failifexecutionfails Set whether to stop the build if program cannot be started. Defaults to true. boolean ?
command Sets a command line. Commandline ?
executable Set the name of the executable program. String ?
errorproperty Sets the name of the property whose value should be set to the error of the process. String ?
os List of operating systems on which the command may be executed. String ?
output File the output of the process is redirected to. If error is not redirected, it too will appear in the output. File ?
timeout Set the timeout in milliseconds after which the process will be killed. Integer ?
spawn Set whether or not you want the process to be spawned. Default is false. boolean ?
input Set the input file to use for the task. File ?
inputstring Set the string to use as input. String ?
searchpath Set whether to search nested, then system PATH environment variables for the executable. boolean ?
logerror Controls whether error output of exec is logged. This is only useful when output is being redirected and error output is desired in the Ant log. boolean ?
dir Set the working directory of the process. File ?
error Set the File to which the error stream of the process should be redirected. File ?
outputproperty Sets the property name whose value should be set to the output of the process. String ?
append Set whether output should be appended to or overwrite an existing file. Defaults to false. boolean ?
failonerror Fail if the command exits with a non-zero return code. boolean ?
resolveexecutable Set whether to attempt to resolve the executable to a file. boolean ?
vmlauncher Set whether to launch new process with VM, otherwise use the OS's shell. Default value is true. boolean ?
newenvironment Do not propagate old environment when new environment variables are specified. boolean ?

Parameters accepted as nested elements

<arg>

Used for nested xml command line definitions.
Attribute Description Type Required
line Line to split into several commandline arguments. String ?
file Sets a single commandline argument to the absolute filename of the given file. File ?
pathref Sets a single commandline argument from a reference to a path - ensures the right separator for the local platform is used. Reference ?
value Sets a single commandline argument. String ?
path Sets a single commandline argument and treats it like a PATH - ensures the right separator for the local platform is used. Path ?

<redirector> ...

Element representation of a Redirector.
Attribute Description Type Required
refid Makes this instance in effect a reference to another instance.

You must not set another attribute or nest elements inside this element if you make it a reference.

Reference ?
inputencoding Set the input encoding. String ?
append Whether output should be appended to or overwrite an existing file. Defaults to false. boolean ?
createemptyfiles Whether output and error files should be created even when empty. Defaults to true. boolean ?
output File the output of the process is redirected to. If error is not redirected, it too will appear in the output File ?
outputproperty Property name whose value should be set to the output of the process. String ?
outputencoding Set the output encoding. String ?
errorproperty Property name whose value should be set to the error of the process. String ?
error Set the file to which standard error is to be redirected. File ?
inputstring Set the string to use as input String ?
alwayslog If true, (error and non-error) output will be "teed", redirected as specified while being sent to Ant's logging mechanism as if no redirection had taken place. Defaults to false. boolean ?
input Set the input to use for the task File ?
errorencoding Set the error encoding. String ?
logerror Controls whether error output of exec is logged. This is only useful when output is being redirected and error output is desired in the Ant log boolean ?

<env>

representation of a single env value
Attribute Description Type Required
key set the key String ?
file get the absolute path of a file and assign it to the value File ?
value set the value String ?
path stringify path and assign to the value. The value will contain all path elements separated by the appropriate separator Path ?