Ant: The Definitive Guide

Name

ftp

Synopsis

Implements a basic FTP client. This task depends on netcomponents.jar, available at http://www.savarese.org/oro/downloads.

Attributes

action (all, String, N)

The FTP command to execute. Legal values are send, put, recv, get, del, delete, list, and mkdir. Defaults to send.

binary (all, boolean, N)

If true, use binary-mode transfers instead of text-mode. Defaults to true.

depends (all, boolean, N)

If true, transfer only new or changed files. Defaults to false.

ignorenoncriticalerrors (1.4, boolean, N)

If true, ignore noncritical error codes sent by some FTP servers. Defaults to false.

listing (all, File, *)

Name of a file to store output from the list action.

newer (all, boolean, N)

An alias for depends.

passive (1.3, 1.4, boolean, N)

If true, use passive-mode transfers. Defaults to false.

password (all, String, Y)

The login password for the FTP server.

port (all, int, N)

The port number. Defaults to 21.

remotedir (all, String, N)

A directory on the remote server.

separator (all, String, N)

The file separator on the FTP server. Defaults to "/“.

server (all, String, Y)

The URL of the remote server.

skipfailedtransfers (1.4, boolean, N)

If true, continue transferring files even if some failures occur. Defaults to false.

userid (all, String, Y)

The login ID for the FTP server.

verbose (all, boolean, N)

If true, operate in verbose mode. Defaults to false.

The listing attribute is required when action="list".

Content

0..n nested <fileset> elements (all)

Specifies files and directories to include ...