diff --git a/README.md b/README.md index d742c619..a94f6ad8 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ % mergerfs(1) mergerfs user manual % Antonio SJ Musumeci -% 2023-01-26 +% 2023-01-29 # NAME @@ -1047,9 +1047,24 @@ Be sure to set `cache.files=partial|full|auto-full` or turn off `direct_io`. rto #### Plex doesn't work with mergerfs -It does. If you're trying to put Plex's config / metadata / database on mergerfs you can't set `cache.files=off` because Plex is using sqlite3 with mmap enabled. Shared mmap is not supported by Linux's FUSE implementation when page caching is disabled. To fix this place the data elsewhere (preferable) or enable `cache.files` (with `dropcacheonclose=true`). Sqlite3 does not need mmap but the developer needs to fall back to standard IO if mmap fails. +It does. If you're trying to put Plex's config / metadata / database +on mergerfs you can't set `cache.files=off` because Plex is using +sqlite3 with mmap enabled. Shared mmap is not supported by Linux's +FUSE implementation when page caching is disabled. To fix this place +the data elsewhere (preferable) or enable `cache.files` (with +`dropcacheonclose=true`). Sqlite3 does not need mmap but the developer +needs to fall back to standard IO if mmap fails. -If the issue is that scanning doesn't seem to pick up media then be sure to set `func.getattr=newest` though generally a full scan will pick up all media anyway. + +This applies to other software: Radarr, Sonarr, Lidarr, Jellyfin, etc. + +I would recommend reaching out to the developers of the software +you're having troubles with and asking them to add a fallback to +regular file IO when mmap is unavailable. + +If the issue is that scanning doesn't seem to pick up media then be +sure to set `func.getattr=newest` though generally a full scan will +pick up all media anyway. #### When a program tries to move or rename a file it fails diff --git a/man/mergerfs.1 b/man/mergerfs.1 index 849b1a57..08ea8a6d 100644 --- a/man/mergerfs.1 +++ b/man/mergerfs.1 @@ -1,7 +1,7 @@ .\"t .\" Automatically generated by Pandoc 2.9.2.1 .\" -.TH "mergerfs" "1" "2023-01-26" "mergerfs user manual" "" +.TH "mergerfs" "1" "2023-01-29" "mergerfs user manual" "" .hy .SH NAME .PP @@ -2054,6 +2054,12 @@ To fix this place the data elsewhere (preferable) or enable Sqlite3 does not need mmap but the developer needs to fall back to standard IO if mmap fails. .PP +This applies to other software: Radarr, Sonarr, Lidarr, Jellyfin, etc. +.PP +I would recommend reaching out to the developers of the software +you\[cq]re having troubles with and asking them to add a fallback to +regular file IO when mmap is unavailable. +.PP If the issue is that scanning doesn\[cq]t seem to pick up media then be sure to set \f[C]func.getattr=newest\f[R] though generally a full scan will pick up all media anyway.