diff --git a/README.md b/README.md index 0bdb7966..cf198fc7 100644 --- a/README.md +++ b/README.md @@ -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