From ac4e097511a492808cb8118bc075f6bbbf398838 Mon Sep 17 00:00:00 2001 From: Antonio SJ Musumeci Date: Sun, 29 Jan 2023 23:56:50 -0500 Subject: [PATCH] Add more apps to section on sqlite3 mmap problems --- README.md | 21 ++++++++++++++++++--- man/mergerfs.1 | 8 +++++++- 2 files changed, 25 insertions(+), 4 deletions(-) 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.