Browse Source

Merge pull request #685 from trapexit/update-docs

update docs: openvz kernel bug and new support links
pull/689/head
trapexit 5 years ago
committed by GitHub
parent
commit
55245e290a
No known key found for this signature in database GPG Key ID: 4AEE18F83AFDEB23
  1. 10
      README.md
  2. 17
      man/mergerfs.1

10
README.md

@ -1,6 +1,6 @@
% mergerfs(1) mergerfs user manual
% Antonio SJ Musumeci <trapexit@spawn.link>
% 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

17
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

Loading…
Cancel
Save