github-mirror/mergerfs
2
0
Fork 0
mirror of https://github.com/trapexit/mergerfs.git synced 2025-01-23 10:59:46 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Merge pull request #1320 from trapexit/readme

Browse Source 
Suggest cache.files=auto-full rather than partial
This commit is contained in:
trapexit 2024-03-21 21:36:27 -04:00 committed by GitHub
commit 977d04229f
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 15 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
README.md
View File

@ -89,7 +89,7 @@ start with one of the following option sets.
#### You need `mmap` (used by rtorrent and many sqlite3 base software) #### You need `mmap` (used by rtorrent and many sqlite3 base software)
`cache.files=partial,dropcacheonclose=true,category.create=mfs` `cache.files=auto-full,dropcacheonclose=true,category.create=mfs`
#### You don't need `mmap` #### You don't need `mmap`
@ -97,11 +97,11 @@ start with one of the following option sets.
### Command Line ### Command Line
`mergerfs -o cache.files=partial,dropcacheonclose=true,category.create=mfs /mnt/hdd0:/mnt/hdd1 /media` `mergerfs -o cache.files=auto-full,dropcacheonclose=true,category.create=mfs /mnt/hdd0:/mnt/hdd1 /media`
### /etc/fstab ### /etc/fstab
`/mnt/hdd0:/mnt/hdd1 /media mergerfs cache.files=partial,dropcacheonclose=true,category.create=mfs 0 0` `/mnt/hdd0:/mnt/hdd1 /media mergerfs cache.files=auto-full,dropcacheonclose=true,category.create=mfs 0 0`
### systemd mount ### systemd mount
@ -116,7 +116,7 @@ Type=simple
KillMode=none KillMode=none
ExecStart=/usr/bin/mergerfs \ ExecStart=/usr/bin/mergerfs \
-f \ -f \
-o cache.files=partial \ -o cache.files=auto-full \
-o dropcacheonclose=true \ -o dropcacheonclose=true \
-o category.create=mfs \ -o category.create=mfs \
/mnt/hdd0:/mnt/hdd1 \ /mnt/hdd0:/mnt/hdd1 \
@ -1868,16 +1868,17 @@ more details.
#### rtorrent fails with ENODEV (No such device) #### rtorrent fails with ENODEV (No such device)
Be sure to set `cache.files=partial|full|auto-full|per-processe` or Be sure to set
turn off `direct_io`. rtorrent and some other applications use `cache.files=partial|full|auto-full|per-processe`. rtorrent and some
[mmap](http://linux.die.net/man/2/mmap) to read and write to files and other applications use [mmap](http://linux.die.net/man/2/mmap) to read
offer no fallback to traditional methods. FUSE does not currently and write to files and offer no fallback to traditional methods. FUSE
support mmap while using `direct_io`. There may be a performance does not currently support mmap while using `direct_io`. There may be
penalty on writes with `direct_io` off as well as the problem of a performance penalty on writes with `direct_io` off as well as the
double caching but it's the only way to get such applications to problem of double caching but it's the only way to get such
work. If the performance loss is too high for other apps you can mount applications to work. If the performance loss is too high for other
mergerfs twice. Once with `direct_io` enabled and one without it. Be apps you can mount mergerfs twice. Once with `direct_io` enabled and
sure to set `dropcacheonclose=true` if not using `direct_io`. one without it. Be sure to set `dropcacheonclose=true` if not using
`direct_io`.
#### Plex doesn't work with mergerfs #### Plex doesn't work with mergerfs