User Guide

122 Chapter 2: ColdFusion Tags
cffile action = "rename"
Description
Renames or moves a file on the server.
Syntax
<cffile
action = "rename"
source = "full_path_name"
destination = "path_name"
mode = "mode"
attributes = "file_attributes_list">
See also
cfdirectory
History
See the History section of the main cffile tag page.
Attributes
Usage
The rename action renames or move a file. The destination attribute must be a pathname, not
just a new name for the file. If the destination is a directory, the file is moved and not renamed.
Example
The following example renames the file keymemo.doc to oldmemo.doc:
Attribute Req/Opt Default Description
action Required Type of file manipulation that the tag performs.
source Required Pathname of file to rename.
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 Destination file or directory. 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. 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
attributes = "readOnly", all other attributes are
overwritten.
• hidden
• normal
• readOnly