|
|
@ -167,7 +167,11 @@ These options are the same regardless of whether you use them with the |
|
|
|
longer need the data and it can drop its cache. Recommended when |
|
|
|
**cache.files=partial|full|auto-full|per-process** to limit double |
|
|
|
caching. (default: false) |
|
|
|
* **direct-io-allow-mmap=BOOL**: On newer kernels (>= 6.6) it is |
|
|
|
* **passthrough=BOOL**: On Linux 6.9 and above passthrough allows for |
|
|
|
near native IO performance. cache.files=off will disable passthrough |
|
|
|
but if direct-io-allow-mmap=true then mmap will be |
|
|
|
passthroughed. `moveonenospc` will no longer function. |
|
|
|
* **direct-io-allow-mmap=BOOL**: On Linux 6.6 and above it is |
|
|
|
possible to disable file page caching while still allowing for |
|
|
|
shared mmap support. mergerfs will enable this feature if available |
|
|
|
but an option is provided to turn it off for testing and debugging |
|
|
@ -1664,6 +1668,8 @@ over the suggestions below (including the benchmarking section.) |
|
|
|
NOTE: be sure to read about these features before changing them to |
|
|
|
understand what behaviors it may impact |
|
|
|
|
|
|
|
* test theoretical performance using `nullrw` or mounting a ram disk |
|
|
|
* enable `passthrough` |
|
|
|
* disable `security_capability` and/or `xattr` |
|
|
|
* increase cache timeouts `cache.attr`, `cache.entry`, `cache.negative_entry` |
|
|
|
* enable (or disable) page caching (`cache.files`) |
|
|
@ -1675,7 +1681,6 @@ understand what behaviors it may impact |
|
|
|
* change the number of worker threads |
|
|
|
* disable `posix_acl` |
|
|
|
* disable `async_read` |
|
|
|
* test theoretical performance using `nullrw` or mounting a ram disk |
|
|
|
* use `symlinkify` if your data is largely static and read-only |
|
|
|
* use tiered cache devices |
|
|
|
* use LVM and LVM cache to place a SSD in front of your HDDs |
|
|
@ -1879,7 +1884,7 @@ more details. |
|
|
|
#### rtorrent fails with ENODEV (No such device) |
|
|
|
|
|
|
|
Be sure to set |
|
|
|
`cache.files=partial|full|auto-full|per-processe`. rtorrent and some |
|
|
|
`cache.files=partial|full|auto-full|per-process`. rtorrent and some |
|
|
|
other applications use [mmap](http://linux.die.net/man/2/mmap) to read |
|
|
|
and write to files and offer no fallback to traditional methods. FUSE |
|
|
|
does not currently support mmap while using `direct_io`. There may be |
|
|
|