From 322fa5778a2da1cc004aae71a516700a6a739288 Mon Sep 17 00:00:00 2001 From: Antonio SJ Musumeci Date: Tue, 10 Dec 2019 23:21:45 -0500 Subject: [PATCH] update docs: openvz kernel bug and new support links --- README.md | 10 +++++++++- man/mergerfs.1 | 17 +++++++++++++++-- 2 files changed, 24 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 5d000177..279b44b5 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ % mergerfs(1) mergerfs user manual % Antonio SJ Musumeci -% 2019-09-03 +% 2019-12-10 # NAME @@ -728,6 +728,11 @@ This is a kernel bug with mmap and FUSE on 32bit platforms. A fix should become https://marc.info/?l=linux-fsdevel&m=155550785230874&w=2 +#### Crashing on OpenVZ + +There appears to be a bug in the OpenVZ kernel with regard to how it handles ioctl calls. It is making invalid requests which leads to a crash. As of 2019-12-10 there is a bug report filed with OpenVZ but it is not yet fixed. + + #### Plex doesn't work with mergerfs It does. If you're trying to put Plex's config / metadata on mergerfs you have to leave `direct_io` off because Plex is using sqlite which apparently needs mmap. mmap doesn't work with `direct_io`. To fix this place the data elsewhere or disable `direct_io` (with `dropcacheonclose=true`). @@ -1070,12 +1075,15 @@ Filesystems are very complex and difficult to debug. mergerfs, while being just This software is free to use and released under a very liberal license. That said if you like this software and would like to support its development donations are welcome. * PayPal: https://paypal.me/trapexit +* GitHub Sponsors: https://github.com/sponsors/trapexit * Patreon: https://www.patreon.com/trapexit * SubscribeStar: https://www.subscribestar.com/trapexit +* Ko-Fi: https://ko-fi.com/trapexit * Bitcoin (BTC): 12CdMhEPQVmjz3SSynkAEuD5q9JmhTDCZA * Bitcoin Cash (BCH): 1AjPqZZhu7GVEs6JFPjHmtsvmDL4euzMzp * Ethereum (ETH): 0x09A166B11fCC127324C7fc5f1B572255b3046E94 * Litecoin (LTC): LXAsq6yc6zYU3EbcqyWtHBrH1Ypx4GjUjm +* ZCoin (XZC): a8L5Vz35KdCQe7Y7urK2pcCGau7JsqZ5Gw # LINKS diff --git a/man/mergerfs.1 b/man/mergerfs.1 index 9b60dc24..2cfe887d 100644 --- a/man/mergerfs.1 +++ b/man/mergerfs.1 @@ -1,7 +1,7 @@ .\"t .\" Automatically generated by Pandoc 1.19.2.4 .\" -.TH "mergerfs" "1" "2019\-09\-03" "mergerfs user manual" "" +.TH "mergerfs" "1" "2019\-12\-10" "mergerfs user manual" "" .hy .SH NAME .PP @@ -1521,6 +1521,13 @@ This is a kernel bug with mmap and FUSE on 32bit platforms. A fix should become available for all LTS releases. .PP https://marc.info/?l=linux\-fsdevel&m=155550785230874&w=2 +.SS Crashing on OpenVZ +.PP +There appears to be a bug in the OpenVZ kernel with regard to how it +handles ioctl calls. +It is making invalid requests which leads to a crash. +As of 2019\-12\-10 there is a bug report filed with OpenVZ but it is not +yet fixed. .SS Plex doesn\[aq]t work with mergerfs .PP It does. @@ -1877,7 +1884,7 @@ mergerfs however does not offer the overlay / copy\-on\-write (CoW) features which aufs and overlayfs have. .SS Why use mergerfs over unionfs? .PP -UnionFS is more like aufs then mergerfs in that it offers overlay / CoW +UnionFS is more like aufs than mergerfs in that it offers overlay / CoW features. If you\[aq]re just looking to create a union of drives and want flexibility in file/directory placement then mergerfs offers that @@ -2156,10 +2163,14 @@ development donations are welcome. .IP \[bu] 2 PayPal: https://paypal.me/trapexit .IP \[bu] 2 +GitHub Sponsors: https://github.com/sponsors/trapexit +.IP \[bu] 2 Patreon: https://www.patreon.com/trapexit .IP \[bu] 2 SubscribeStar: https://www.subscribestar.com/trapexit .IP \[bu] 2 +Ko\-Fi: https://ko\-fi.com/trapexit +.IP \[bu] 2 Bitcoin (BTC): 12CdMhEPQVmjz3SSynkAEuD5q9JmhTDCZA .IP \[bu] 2 Bitcoin Cash (BCH): 1AjPqZZhu7GVEs6JFPjHmtsvmDL4euzMzp @@ -2167,6 +2178,8 @@ Bitcoin Cash (BCH): 1AjPqZZhu7GVEs6JFPjHmtsvmDL4euzMzp Ethereum (ETH): 0x09A166B11fCC127324C7fc5f1B572255b3046E94 .IP \[bu] 2 Litecoin (LTC): LXAsq6yc6zYU3EbcqyWtHBrH1Ypx4GjUjm +.IP \[bu] 2 +ZCoin (XZC): a8L5Vz35KdCQe7Y7urK2pcCGau7JsqZ5Gw .SH LINKS .IP \[bu] 2 https://spawn.link