Browse Source

Mention how mmap error when direct io is enabled

pull/1557/head
Antonio SJ Musumeci 3 weeks ago
parent
commit
20e532b569
  1. 22
      mkdocs/docs/known_issues_bugs.md

22
mkdocs/docs/known_issues_bugs.md

@ -99,9 +99,9 @@ on [page caching](config/cache.md).
### Software using mmap ### Software using mmap
* software using sqlite3 w/ mmap * software using sqlite3 w/ mmap
* Plex (for config)
* Jellyfin (for config)
* Emby (for config)
* Plex (for config, not media)
* Jellyfin (for config, not media)
* Emby (for config, not media)
* Radarr * Radarr
* Sonarr * Sonarr
* Lidarr * Lidarr
@ -113,17 +113,21 @@ on [page caching](config/cache.md).
operating system feature allowing files to be interacted with as if it operating system feature allowing files to be interacted with as if it
was normal memory. Support for `mmap` is **required** by a number of was normal memory. Support for `mmap` is **required** by a number of
projects. FUSE (and therefore mergerfs), in order to support `mmap`, projects. FUSE (and therefore mergerfs), in order to support `mmap`,
requires [page caching](config/cache.md) to be
enabled. IE `cache.files` must not be set to `off` (if using Linux before
v6.6 or mergerfs before v2.41.0.)
requires [page caching](config/cache.md) to be enabled. IE
`cache.files` must not be set to `off` (if using Linux before v6.6 or
mergerfs before v2.41.0.) In newer versions of mergerfs and Linux
`off` will work as it can now auto enable page caching (and therefore
`mmap`) as needed.
In newer versions of mergerfs and Linux `off` will work as it can now
auto enable page caching (and therefore `mmap`) as needed.
When `mmap` is needed but not available you may see `ENODEV` or `No
such device` errors though it will depend on the particular software.
That said it is recommended that config and runtime files be stored on That said it is recommended that config and runtime files be stored on
SSDs on a regular filesystem for performance reasons. See [What should SSDs on a regular filesystem for performance reasons. See [What should
mergerfs NOT be used mergerfs NOT be used
for?](faq/recommendations_and_warnings.md#what-should-mergerfs-not-be-used-for).
for?](faq/recommendations_and_warnings.md#what-should-mergerfs-not-be-used-for). Though
with [passthrough.io](config/passthrough.md) enabled that is less
of a concern.
Technically **sqlite3** does not require `mmap`, and in fact the Technically **sqlite3** does not require `mmap`, and in fact the
default is not to use it, but many programs enable the feature and default is not to use it, but many programs enable the feature and

Loading…
Cancel
Save