From 5f7a168d0b31cc7faaae55cae7e9615ed2f0a813 Mon Sep 17 00:00:00 2001 From: Antonio SJ Musumeci Date: Tue, 6 Dec 2016 17:04:10 -0500 Subject: [PATCH] note that mergerfs should be run as root --- README.md | 1 + man/mergerfs.1 | 3 +++ 2 files changed, 4 insertions(+) diff --git a/README.md b/README.md index b0551b2a..ed78f3ba 100644 --- a/README.md +++ b/README.md @@ -306,6 +306,7 @@ A B C # TIPS / NOTES +* Run mergerfs as `root` unless you're merging paths which are owned by the same user otherwise strange permission issues may arise. * https://github.com/trapexit/backup-and-recovery-howtos : A set of guides / howtos on creating a data storage system, backing it up, maintaining it, and recovering from failure. * If you don't see some directories / files you expect in a merged point be sure the user has permission to all the underlying directories. If `/drive0/a` has is owned by `root:root` with ACLs set to `0700` and `/drive1/a` is `root:root` and `0755` you'll see only `/drive1/a`. Use `mergerfs.fsck` to audit the drive for out of sync permissions. * Do *not* use `direct_io` if you expect applications (such as rtorrent) to [mmap](http://linux.die.net/man/2/mmap) files. It is not currently supported in FUSE w/ `direct_io` enabled. diff --git a/man/mergerfs.1 b/man/mergerfs.1 index 8b6ff455..3bcb0ec9 100644 --- a/man/mergerfs.1 +++ b/man/mergerfs.1 @@ -685,6 +685,9 @@ https://github.com/trapexit/scorch scorch: A tool to help discover silent corruption of files .SH TIPS / NOTES .IP \[bu] 2 +Run mergerfs as \f[C]root\f[] unless you\[aq]re merging paths which are +owned by the same user otherwise strange permission issues may arise. +.IP \[bu] 2 https://github.com/trapexit/backup\-and\-recovery\-howtos : A set of guides / howtos on creating a data storage system, backing it up, maintaining it, and recovering from failure.