MACROMEDIA COLDFUSION MX 61-CFML, Reference

Page: 115 / 806

cffile 115
cffile action = "copy"
Description
Copies a file from one directory to another on the server.
Syntax
<cffile
action = "copy"
source = "full_path_name"
destination = "full_path_name"
mode = "mode"
attributes = "file_attributes_list">
See also
cfdirectory
History
See the History section of the main
cffile
tag page.
Attributes
Example
This example copies the keymemo.doc file to the c:\files\backup\ directory:
<cffile action = "copy"
source = "c:\files\upload\keymemo.doc"
destination = "c:\files\backup\">
Attribute Req/Opt Default Description
action Required Type of file manipulation that the tag performs.
source Required Pathname of the file to copy.
If not an absolute path (starting a with a drive letter and a colon,
or a forward or backward slash), it is relative to the ColdFusion
temporary directory, which is returned by the
GetTempDirectory
function.
destination Required Pathname of a directory or file on web server where the file will
be copied. If not an absolute path, it is relative to the source
directory..
mode Optional Applies only to UNIX and Linux. Permissions. Octal values of
Unix chmod command. Assigned to owner, group, and other,
respectively. For example:
•
644: Assigns read/write permission to owner; read permission
to group and other
• 777: Assigns read/write/execute permission to all
attributes Optional Applies to Windows. A comma-delimited list of attributes to set
on the file.
If omitted, the file's attributes are maintained.
Each value must be specified explicitly. For example, if you
specify
attributes = "readOnly"
, all other attributes are
overwritten.
•
readOnly
•
hidden
•
normal