From 66f0d9e6498c4a5f4271f704a3ff1cee1623bffe Mon Sep 17 00:00:00 2001 From: Antonio SJ Musumeci Date: Fri, 24 Jan 2020 20:12:24 -0500 Subject: [PATCH] add faq entry on files ending up on 1 branch --- README.md | 11 ++++++++++- man/mergerfs.1 | 20 +++++++++++++++++++- 2 files changed, 29 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index e60c3d41..b7f2365e 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ % mergerfs(1) mergerfs user manual % Antonio SJ Musumeci -% 2020-01-19 +% 2020-01-24 # NAME @@ -934,6 +934,15 @@ That said, for the average person, the following should be fine: `-o use_ino,cache.files=off,dropcacheonclose=true,allow_other,category.create=mfs` +#### Why are all my files ending up on 1 drive?! + +Did you start with empty drives? Did you explicitly configure a `category.create` policy? + +The default create policy is `epmfs`. That is a path preserving algorithm. With such a policy for `mkdir` and `create` with a set of empty drives it will naturally select only 1 drive when the first directory is created. Anything, files or directories, created in that first directory will be placed on the same branch because it is preserving paths. + +This catches a lot of new users off guard but changing the default would break the setup for many existing users. If you do not care about path preservation and wish your files to be spread across all your drives change to `mfs` or similar policy as described above. + + #### Do hard links work? Yes. You need to use `use_ino` to support proper reporting of inodes. diff --git a/man/mergerfs.1 b/man/mergerfs.1 index 69fa7a8d..dbd27ad2 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" "2020\-01\-19" "mergerfs user manual" "" +.TH "mergerfs" "1" "2020\-01\-24" "mergerfs user manual" "" .hy .SH NAME .PP @@ -1963,6 +1963,24 @@ the documentation will be improved. That said, for the average person, the following should be fine: .PP \f[C]\-o\ use_ino,cache.files=off,dropcacheonclose=true,allow_other,category.create=mfs\f[] +.SS Why are all my files ending up on 1 drive?! +.PP +Did you start with empty drives? +Did you explicitly configure a \f[C]category.create\f[] policy? +.PP +The default create policy is \f[C]epmfs\f[]. +That is a path preserving algorithm. +With such a policy for \f[C]mkdir\f[] and \f[C]create\f[] with a set of +empty drives it will naturally select only 1 drive when the first +directory is created. +Anything, files or directories, created in that first directory will be +placed on the same branch because it is preserving paths. +.PP +This catches a lot of new users off guard but changing the default would +break the setup for many existing users. +If you do not care about path preservation and wish your files to be +spread across all your drives change to \f[C]mfs\f[] or similar policy +as described above. .SS Do hard links work? .PP Yes.