README: add note regarding space calculations

This commit is contained in:
Antonio SJ Musumeci 2020-03-10 11:21:40 -04:00
parent 14d26ba434
commit 8ba1abafec
2 changed files with 13 additions and 2 deletions

View File

@ -1,6 +1,6 @@
% mergerfs(1) mergerfs user manual
% Antonio SJ Musumeci <trapexit@spawn.link>
% 2020-02-09
% 2020-03-10
# NAME
@ -240,6 +240,8 @@ If all branches are filtered an error will be returned. Typically **EROFS** or *
| newest | Pick the file / directory with the largest mtime. |
| rand (random) | Calls **all** and then randomizes. Returns 1. |
**NOTE:** If you are using an underlying filesystem that reserves blocks such as ext2, ext3, or ext4 be aware that mergerfs respects the reservation by using `f_bavail` (number of free blocks for unprivileged users) rather than `f_bfree` (number of free blocks) in policy calculations. **df** does NOT use `f_bavail`, it uses `f_bfree`, so direct comparisons between **df** output and mergerfs' policies is not appropriate.
#### Defaults ####

View File

@ -1,7 +1,7 @@
.\"t
.\" Automatically generated by Pandoc 1.19.2.4
.\"
.TH "mergerfs" "1" "2020\-02\-09" "mergerfs user manual" ""
.TH "mergerfs" "1" "2020\-03\-10" "mergerfs user manual" ""
.hy
.SH NAME
.PP
@ -642,6 +642,15 @@ Calls \f[B]all\f[] and then randomizes.
Returns 1.
T}
.TE
.PP
\f[B]NOTE:\f[] If you are using an underlying filesystem that reserves
blocks such as ext2, ext3, or ext4 be aware that mergerfs respects the
reservation by using \f[C]f_bavail\f[] (number of free blocks for
unprivileged users) rather than \f[C]f_bfree\f[] (number of free blocks)
in policy calculations.
\f[B]df\f[] does NOT use \f[C]f_bavail\f[], it uses \f[C]f_bfree\f[], so
direct comparisons between \f[B]df\f[] output and mergerfs\[aq] policies
is not appropriate.
.SS Defaults
.PP
.TS