The file-cache element configures the file cache. This element may appear zero or one time within the server element. For more information, see server.
The file-cache element can contain the following subelements:
Table 3–21 List of file-cache Subelements
Element |
Occurrences |
Description |
---|---|---|
enabled |
0 or 1 |
Determines whether the server cache is enabled. The default value is true. Whether file content is cached in addition to meta information is controlled by the cache-content subelement. |
max-age |
0 or 1 |
The maximum amount of time (in seconds) to cache file content and meta information. The value can be from 0.001 to 3600. |
max-entries |
0 or 1 |
The maximum number of paths to cache content and/or meta information. The value can be from 1 to 1048576. |
max-open-files |
0 or 1 |
The maximum number of file descriptors the file cache will keep open. The value can be from 1 to 1048576. |
sendfile |
0 or 1 |
Determines whether the server will attempt to use the operating system's sendfile, sendfilev, send_file, or TransmitFile system call. The default value is true on Windows and false on other platforms. |
copy-files |
0 or 1 |
Determines whether the server copies cached files to a temporary directory. The default value is true on Windows and false on other platforms. |
copy-path |
0 or 1 |
The temporary directory that is used when copy-files is true. If a relative path is used, it is relative to the server's config directory. |
replacement |
0 or 1 |
The cache entry replacement algorithm. The value can be false, lru, or lfu. |
cache-content |
0 or 1 |
Determines whether the server caches file content in addition to the meta information. The default value is true. |
max-heap-file-size |
0 or 1 |
The maximum size (in bytes) of files to cache on the heap. The value can be from 0 to 2147483647. |
max-heap-space |
0 or 1 |
The maximum amount (in bytes) of heap to use for caching files. The value can be from 0 to 9223372036854775807. |
max-mmap-file-size |
0 or 1 |
The maximum size (in bytes) of files to mmap. The value can be from 0 to 2147483647. |
max-mmap-space |
0 or 1 |
The maximum amount (in bytes) of mmap address space to use for caching files. The value can be from 0 to 9223372036854775807. |