Browse Source

make policy descriptions more explicit

pull/268/head
Antonio SJ Musumeci 9 years ago
parent
commit
8643d35ebf
  1. 18
      README.md

18
README.md

@ -1,6 +1,6 @@
% mergerfs(1) mergerfs user manual % mergerfs(1) mergerfs user manual
% Antonio SJ Musumeci <trapexit@spawn.link> % Antonio SJ Musumeci <trapexit@spawn.link>
% 2016-04-06
% 2016-04-13
# NAME # NAME
@ -82,14 +82,14 @@ Due to FUSE limitations **ioctl** behaves differently if its acting on a directo
| Policy | Description | | Policy | Description |
|--------------|-------------| |--------------|-------------|
| all | Search category: acts like **ff**. Action category: apply to all found. Create category: for **mkdir**, **mknod**, and **symlink** perform on all read/write drives with at least **minfreespace**. **create** filters the same way but acts like **ff**. |
| eplfs (existing path, least free space) | If the path exists on multiple drives use the one with the least free space. Falls back to **lfs**. |
| epmfs (existing path, most free space) | If the path exists on multiple drives use the one with the most free space. Falls back to **mfs**. |
| all | Search category: acts like **ff**. Action category: apply to all found. Create category: for **mkdir**, **mknod**, and **symlink** it will apply to all found. **create** works like **ff**. It will exclude readonly drives and those with free space less than **minfreespace**. |
| eplfs (existing path, least free space) | If the path exists on multiple drives use the one with the least free space. It will exclude readonly drives and those with free space less than **minfreespace**. Falls back to **lfs**. |
| epmfs (existing path, most free space) | If the path exists on multiple drives use the one with the most free space. It will exclude readonly drives and those with free space less than **minfreespace**. Falls back to **mfs**. |
| erofs | Exclusively return **-1** with **errno** set to **EROFS**. By setting **create** functions to this you can in effect turn the filesystem readonly. | | erofs | Exclusively return **-1** with **errno** set to **EROFS**. By setting **create** functions to this you can in effect turn the filesystem readonly. |
| ff (first found) | Given the order of the drives, as defined at mount time or when configured via xattr interface, act on the first one found. |
| lfs (least free space) | Pick the drive with the least available free space but more than **minfreespace**. Falls back to **mfs**. |
| mfs (most free space) | Use the drive with the most available free space. Falls back to **ff**. |
| newest (newest file) | Pick the file / directory with the largest mtime. |
| ff (first found) | Given the order of the drives, as defined at mount time or when configured via xattr interface, act on the first one found. It will exclude readonly drives and those with free space less than **minfreespace**. |
| lfs (least free space) | Pick the drive with the least available free space. It will exclude readonly drives and those with free space less than **minfreespace**. Falls back to **mfs**. |
| mfs (most free space) | Pick the drive with the most available free space. It will exclude readonly drives and those with free space less than **minfreespace**. Falls back to **ff**. |
| newest (newest file) | Pick the file / directory with the largest mtime. It will exclude readonly drives and those with free space less than **minfreespace**. |
| rand (random) | Calls **all** and then randomizes. | | rand (random) | Calls **all** and then randomizes. |
#### Defaults #### #### Defaults ####
@ -382,7 +382,7 @@ For non-Linux systems mergerfs uses a read-write lock and changes credentials on
* Gratipay: https://gratipay.com/~trapexit * Gratipay: https://gratipay.com/~trapexit
* BitCoin: 12CdMhEPQVmjz3SSynkAEuD5q9JmhTDCZA * BitCoin: 12CdMhEPQVmjz3SSynkAEuD5q9JmhTDCZA
# Links
# LINKS
* http://github.com/trapexit/mergerfs * http://github.com/trapexit/mergerfs
* http://github.com/trapexit/mergerfs-tools * http://github.com/trapexit/mergerfs-tools

Loading…
Cancel
Save