User Guide

96 Chapter 2: ColdFusion Tags
Usage
Note: For this tag execute, it must be enabled in the ColdFusion Administrator. For more information,
see Configuring and Administering ColdFusion MX.
If you put ColdFusion applications on a server that is used by multiple customers, you must
consider the security of files and directories that could be uploaded or otherwise manipulated
with this tag by unauthorized users. For more information about securing ColdFusion tags, see
Configuring and Administering ColdFusion MX.
If
action = "list", cfdirectory returns these result columns, which you can reference in a
cfoutput tag:
• name: directory entry name. The entries "." and ".." are not returned.
• size: directory entry size
• type: file type: File, for a file; Dir, for a directory
• dateLastModified: the date that an entry was last modified
• attributes: file attributes, if applicable
• mode: Empty column; retained for backward compatibility with ColdFusion 5 applications on
UNIX.
You can use the following result columns in standard CFML expressions, preceding the result
column name with the query name:
#mydirectory.name#
#mydirectory.size#
#mydirectory.type#
#mydirectory.dateLastModified#
#mydirectory.attributes#
#mydirectory.mode#
mode Optional Used with
action = "create". Permissions. Applies
only to UNIX and Linux. Octal values of 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
sort Optional; used
if
action =
"list"
ASC Query column(s) by which to sort directory listing.
Delimited list of columns from query output.
To qualify a column, use:
• ac: ascending (a to z) sort order
• desc: descending (z to a) sort order
For example:
sort = "dirname ASC, file2 DESC, size,
datelastmodified"
newDirectory Required if
action =
"rename"
New name for directory
Attribute Req/Opt Default Description