<CFDIRECTORY ACTION="directory action" DIRECTORY="directory name" NAME="query name" FILTER="list filter" MODE="permission" SORT="sort specification" NEWDIRECTORY="new directory name">
If you write ColdFusion applications designed to run on a server that is used by multiple customers, you need to consider the security of the files and directories that could be uploaded or otherwise manipulated by CFDIRECTORY. Please refer to Administering ColdFusion Server for more information about securing ColdFusion tags.
Optional. Defines the action to be taken with directory(ies) specified in DIRECTORY. Valid entries are:
Required for all ACTIONs. The name of the directory you want the action to be performed against.
Required for ACTION="List". Ignored for all other actions. Name of output query for directory listing.
Optional for ACTION="List". Ignored for all other actions. File extension filter to
be applied to returned names, for example: *.cfm
. Only one mask filter can be
applied at a time.
Optional. Used with ACTION="Create" to define the permissions for a directory
on Solaris or HP-UX. Ignored in Windows. Valid entries correspond to the octal
values (not symbolic) of the UNIX chmod
command. Permissions are assigned for
owner, group, and other, respectively. For example:
Mode=644
Assigns the owner read/write permissions and group/other read permission.
Mode=666
Assigns read/write permissions for owner, group, and other.
Mode=777
Assigns read, write, and execute permissions for all.
Optional for ACTION="List". Ignored for all other actions. List of query columns to sort directory listing by. Any combination of columns from query output can be specified in comma separated list. ASC or DESC can be specified as qualifiers for column names. ASC is the default. For example:
Required for ACTION="Rename". Ignored for all other actions. The new name of the directory specified in the DIRECTORY attribute.
When using the ACTION=LIST, CFDIRECTORY returns five result columns you can reference in your CFOUTPUT:
chmod
shell command.