Macromedia coldfusion 4.5-cfml language reference User Manual

34

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 all, owner read/write permission, group and other read/write 
permissions.

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:

SORT="dirname ASC, filename2 DESC, size, datelastmodified"

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: 

•

Name – Directory entry name. 

•

Size – Size of directory entry.

•

Type – File type: File or Dir for File or Directory. 

•

DateLastModified – Date an entry was last modified.

•

Attributes – File attributes, if applicable. 

•

Mode – (Solaris and HP-UX only) The octal value representing the permissions 
setting for the specified directory. For information about octal values, refer to 
the UNIX man pages for the 

chmod

 shell command. 

You can use the following result columns in standard CFML expressions, preceding the 
result column name with the name of the query:

#mydirectory.Name#
#mydirectory.Size#
#mydirectory.Type#
#mydirectory.DateLastModified#
#mydirectory.Attributes#
#mydirectory.Mode#