User Guide

142 Chapter 2: ColdFusion Tags
Usage
If you use connection caching to an active FTP connection, you do not have to respecify the
username, password, or server connection attributes:
Changing a cached connection, such as changing retryCount or timeout values, might require
reestablishing the connection.
If
action = "listDir", the attributes column returns directory or normal. Other
platform-specific values, such as
hidden and system, are no longer supported.
If action = "listDir", a mode column is returned. The column contains an octal string
representation of UNIX permissions; for example, "
777."
ASCIIExtension
List
Optional txt;htm;html;
cfm;cfml;
shtm;shtml;
css;asp;asa
Delimited list of file extensions that force ASCII
transfer mode, if
transferMode = "auto".
transferMode Optional Auto • ASCII FTP transfer mode
• Binary FTP transfer mode
• Auto FTP transfer mode
failIfExists Optional Yes • Yes: if a local file with same name exists,
getFile fails
• No
directory Required if
action
= "changedir"
,
"createDir",
"listDir", or
"existsDir"
Directory on which to perform an operation.
localFile Required if
action
= "getFile"
or
"
putFile"
Name of the file on the local file system.
remoteFile Required if
action
= "getFile"
,
"putFile", or
"existsFile"
Name of the file on the FTP server file system.
item Required if action
= "exists" or
"remove"
Object of these actions: file or directory.
existing Required if
action
= "rename"
Current name of the file or directory on the
remote server.
new Required if
action
= "rename"
New name of file or directory on the remote
server
proxyServer Optional String. Name of the proxy server (s) to use, if
proxy access is specified
passive Optional No • Yes: enable passive mode
• No
Attribute Req/Opt Default Description