Ant: The Definitive Guide

Name

exec

Synopsis

Executes a system command. Like the apply task, this provides a way to access native functionality outside of the Java and Ant build environment.

The apply task requires a nested <fileset>, specifying a list of files and directories passed as arguments to the system command. The exec task differs in that it does not allow this nested <fileset>.

Attributes

command (1.1, CommandLine, *)

The command to execute, including arguments. Deprecated as of Ant 1.2.

dir (all, File, N)

The working directory for the command.

executable (all, String, *)

The name of the command to execute. Does not include command-line arguments.

failonerror (all, boolean, N)

If true, the build fails when the command returns anything other than 0. Defaults to false.

newenvironment (1.3, 1.4, boolean, N)

If true, do not propagate existing environment variables to the new process. Defaults to false.

os (all, String, N)

A list of operating systems this task applies to. Executes only if the list contains a string matching the return value from System.getProperty("os.name").

output (all, File, N)

A file to redirect the command output to.

outputproperty (1.4, String, N)

The name of a property that stores the command output.

timeout (all, int, N)

The number of milliseconds to wait before stopping the command. Waits infinitely if not specified.

vmlauncher (1.4, boolean, N)

Specifies whether to attempt using the JVM’s built-in command launcher, rather than an antRun script. Defaults to true.

Technically, exactly one ...