Browse Source

Merge pull request #1320 from trapexit/readme

Suggest cache.files=auto-full rather than partial
pull/1321/head
trapexit 10 months ago
committed by GitHub
parent
commit
977d04229f
No known key found for this signature in database GPG Key ID: B5690EEEBB952194
  1. 29
      README.md

29
README.md

@ -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

|||||||
100:0
Loading…
Cancel
Save