github-mirror/mergerfs
github-mirror/mergerfs
2
0
Fork 0
mirror of https://github.com/trapexit/mergerfs.git synced 2025-03-15 02:35:12 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Merge pull request #1235 from DavidFair/readme_direct_parallel

Browse Source 
Docs: clarify parallel-direct-writes and cache.files
This commit is contained in:
trapexit 2023-08-26 18:52:57 -05:00 committed by GitHub
commit 82781b6ff8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 7 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
README.md
View File

@ -289,7 +289,8 @@ These options are the same regardless of whether you use them with the
(default: false) (default: false)
* **parallel-direct-writes=BOOL**: Allow the kernel to dispatch * **parallel-direct-writes=BOOL**: Allow the kernel to dispatch
multiple, parallel (non-extending) write requests for files opened multiple, parallel (non-extending) write requests for files opened
with `direct_io=true` (if supported by the kernel) with `cache.files=per-process` (if the process is not in `process-names`)
or `cache.files=off`. (This requires kernel support, and was added in v6.2)
* **direct_io**: deprecated - Bypass page cache. Use `cache.files=off` * **direct_io**: deprecated - Bypass page cache. Use `cache.files=off`
instead. (default: false) instead. (default: false)
* **kernel_cache**: deprecated - Do not invalidate data cache on file * **kernel_cache**: deprecated - Do not invalidate data cache on file
@ -1293,12 +1294,12 @@ https://en.wikipedia.org/wiki/Page_cache
unchanged since previous open. unchanged since previous open.
* cache.files=libfuse: follow traditional libfuse `direct_io`, * cache.files=libfuse: follow traditional libfuse `direct_io`,
`kernel_cache`, and `auto_cache` arguments. `kernel_cache`, and `auto_cache` arguments.
* cache.files=per-process: Enable page caching only for processes * cache.files=per-process: Enable page caching (equivalent to `cache.files=partial`)
which 'comm' name matches one of the values defined in only for processes whose 'comm' name matches one of the values defined in
`cache.files.process-names`. `cache.files.process-names`. If the name does not match the file open
is equivalent to `cache.files=off`.
FUSE, which mergerfs uses, offers a number of page caching FUSE, which mergerfs uses, offers a number of page caching modes. mergerfs tries to simplify their use via the `cache.files`
modes. mergerfs tries to simplify their use via the `cache.files`
option. It can and should replace usage of `direct_io`, option. It can and should replace usage of `direct_io`,
`kernel_cache`, and `auto_cache`. `kernel_cache`, and `auto_cache`.