Whatever message this page gives is out now! Go check it out!

GetVFSMetaData

Last update:
May 18, 2026

Description

Gets in-memory virtual file system metadata.

Returns

A structure that contains information about in-memory virtual file system.

Category

Function syntax

getVFSMetaData (fileSystemType)

See also

Working with in-memory files in the Developing ColdFusion Applications.

History

ColdFusion 9: Added this function

Parameters

Parameter
Description
fileSystemType
The in-memory file system type. ColdFusion 9 supports only RAM.

Usage

The function returns a structure with the following keys:
Parameter
Description
Enabled
If support for in-memory virtual file system is enabled. This is the only key that is returned within the structure if in-memory virtual file system is disabled.
Limt
The memory limit in bytes for in-memory virtual file system.
Used
The memory out of the specified memory limit that is in use (in bytes).
Free
The free memory in bytes.

Example

<cfset myroot = hash(getDirectoryFromPath(getCurrentTemplatePath())) > 
 <cfset name = "ram:///"&myroot&"/"> 
 <cffile action="append" file="#name#" output="created at #now()#"> 
 <cfset contents = fileRead(name)> 
 <cfdump var="#contents#"> 
 <cfdump var="#getVFSMetaData("ram")#">
The example works only if in-memory virtual file system is enabled.

Share this page

Was this page helpful?
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Thank you for your feedback. Your response will help improve this page.

On this page