|
@ -313,12 +313,13 @@ usage(void) |
|
|
"mergerfs options:\n" |
|
|
"mergerfs options:\n" |
|
|
" <branches> ':' delimited list of directories. Supports\n" |
|
|
" <branches> ':' delimited list of directories. Supports\n" |
|
|
" shell globbing (must be escaped in shell)\n" |
|
|
" shell globbing (must be escaped in shell)\n" |
|
|
" -o config=<file> Read options from file in key=val format\n" |
|
|
|
|
|
" -o func.<f>=<p> Set function <f> to policy <p>\n" |
|
|
|
|
|
" -o category.<c>=<p> Set functions in category <c> to <p>\n" |
|
|
|
|
|
" -o cache.open=<int> 'open' policy cache timeout in seconds.\n" |
|
|
|
|
|
|
|
|
" -o config=FILE Read options from file in key=val format\n" |
|
|
|
|
|
" -o func.FUNC=POLICY Set function FUNC to policy POLICY\n" |
|
|
|
|
|
" -o category.CAT=POLICY Set functions in category CAT to POLICY\n" |
|
|
|
|
|
" -o fsname=STR Sets the name of the filesystem.\n" |
|
|
|
|
|
" -o cache.open=INT 'open' policy cache timeout in seconds.\n" |
|
|
" default = 0 (disabled)\n" |
|
|
" default = 0 (disabled)\n" |
|
|
" -o cache.statfs=<int> 'statfs' cache timeout in seconds. Used by\n" |
|
|
|
|
|
|
|
|
" -o cache.statfs=INT 'statfs' cache timeout in seconds. Used by\n" |
|
|
" policies. default = 0 (disabled)\n" |
|
|
" policies. default = 0 (disabled)\n" |
|
|
" -o cache.files=libfuse|off|partial|full|auto-full\n" |
|
|
" -o cache.files=libfuse|off|partial|full|auto-full\n" |
|
|
" * libfuse: Use direct_io, kernel_cache, auto_cache\n" |
|
|
" * libfuse: Use direct_io, kernel_cache, auto_cache\n" |
|
@ -328,47 +329,55 @@ usage(void) |
|
|
" * full: Keep cache on file open\n" |
|
|
" * full: Keep cache on file open\n" |
|
|
" * auto-full: Keep cache if mtime & size not changed\n" |
|
|
" * auto-full: Keep cache if mtime & size not changed\n" |
|
|
" default = libfuse\n" |
|
|
" default = libfuse\n" |
|
|
" -o cache.writeback=<bool>\n" |
|
|
|
|
|
|
|
|
" -o cache.writeback=BOOL\n" |
|
|
" Enable kernel writeback caching (if supported)\n" |
|
|
" Enable kernel writeback caching (if supported)\n" |
|
|
" cache.files must be enabled as well.\n" |
|
|
" cache.files must be enabled as well.\n" |
|
|
" default = false\n" |
|
|
" default = false\n" |
|
|
" -o cache.symlinks=<bool>\n" |
|
|
|
|
|
|
|
|
" -o cache.symlinks=BOOL\n" |
|
|
" Enable kernel caching of symlinks (if supported)\n" |
|
|
" Enable kernel caching of symlinks (if supported)\n" |
|
|
" default = false\n" |
|
|
" default = false\n" |
|
|
" -o cache.readdir=<bool>\n" |
|
|
|
|
|
|
|
|
" -o cache.readdir=BOOL\n" |
|
|
" Enable kernel caching readdir (if supported)\n" |
|
|
" Enable kernel caching readdir (if supported)\n" |
|
|
" default = false\n" |
|
|
" default = false\n" |
|
|
" -o cache.attr=<int> File attribute cache timeout in seconds.\n" |
|
|
|
|
|
|
|
|
" -o cache.attr=INT File attribute cache timeout in seconds.\n" |
|
|
" default = 1\n" |
|
|
" default = 1\n" |
|
|
" -o cache.entry=<int> File name lookup cache timeout in seconds.\n" |
|
|
|
|
|
|
|
|
" -o cache.entry=INT File name lookup cache timeout in seconds.\n" |
|
|
" default = 1\n" |
|
|
" default = 1\n" |
|
|
" -o cache.negative_entry=<int>\n" |
|
|
|
|
|
|
|
|
" -o cache.negative_entry=INT\n" |
|
|
" Negative file name lookup cache timeout in\n" |
|
|
" Negative file name lookup cache timeout in\n" |
|
|
" seconds. default = 0\n" |
|
|
" seconds. default = 0\n" |
|
|
" -o use_ino Have mergerfs generate inode values rather than\n" |
|
|
" -o use_ino Have mergerfs generate inode values rather than\n" |
|
|
" autogenerated by libfuse. Suggested.\n" |
|
|
" autogenerated by libfuse. Suggested.\n" |
|
|
" -o minfreespace=<int> Minimum free space needed for certain policies.\n" |
|
|
|
|
|
|
|
|
" -o inodecalc=passthrough|path-hash|devino-hash|hybrid-hash\n" |
|
|
|
|
|
" Selects the inode calculation algorithm.\n" |
|
|
|
|
|
" default = hybrid-hash\n" |
|
|
|
|
|
" -o minfreespace=INT Minimum free space needed for certain policies.\n" |
|
|
" default = 4G\n" |
|
|
" default = 4G\n" |
|
|
" -o moveonenospc=<bool> Try to move file to another drive when ENOSPC\n" |
|
|
|
|
|
|
|
|
" -o moveonenospc=BOOL Try to move file to another drive when ENOSPC\n" |
|
|
" on write. default = false\n" |
|
|
" on write. default = false\n" |
|
|
" -o dropcacheonclose=<bool>\n" |
|
|
|
|
|
|
|
|
" -o dropcacheonclose=BOOL\n" |
|
|
" When a file is closed suggest to OS it drop\n" |
|
|
" When a file is closed suggest to OS it drop\n" |
|
|
" the file's cache. This is useful when using\n" |
|
|
" the file's cache. This is useful when using\n" |
|
|
" 'cache.files'. default = false\n" |
|
|
" 'cache.files'. default = false\n" |
|
|
" -o symlinkify=<bool> Read-only files, after a timeout, will be turned\n" |
|
|
|
|
|
|
|
|
" -o symlinkify=BOOL Read-only files, after a timeout, will be turned\n" |
|
|
" into symlinks. Read docs for limitations and\n" |
|
|
" into symlinks. Read docs for limitations and\n" |
|
|
" possible issues. default = false\n" |
|
|
" possible issues. default = false\n" |
|
|
" -o symlinkify_timeout=<int>\n" |
|
|
|
|
|
|
|
|
" -o symlinkify_timeout=INT\n" |
|
|
" Timeout in seconds before files turn to symlinks.\n" |
|
|
" Timeout in seconds before files turn to symlinks.\n" |
|
|
" default = 3600\n" |
|
|
" default = 3600\n" |
|
|
" -o nullrw=<bool> Disables reads and writes. For benchmarking.\n" |
|
|
|
|
|
|
|
|
" -o nullrw=BOOL Disables reads and writes. For benchmarking.\n" |
|
|
" default = false\n" |
|
|
" default = false\n" |
|
|
" -o ignorepponrename=<bool>\n" |
|
|
|
|
|
|
|
|
" -o ignorepponrename=BOOL\n" |
|
|
" Ignore path preserving when performing renames\n" |
|
|
" Ignore path preserving when performing renames\n" |
|
|
" and links. default = false\n" |
|
|
" and links. default = false\n" |
|
|
" -o link_cow=<bool> Delink/clone file on open to simulate CoW.\n" |
|
|
|
|
|
|
|
|
" -o link_cow=BOOL Delink/clone file on open to simulate CoW.\n" |
|
|
" default = false\n" |
|
|
" default = false\n" |
|
|
" -o security_capability=<bool>\n" |
|
|
|
|
|
|
|
|
" -o nfsopenhack=off|git|all\n" |
|
|
|
|
|
" A workaround for exporting mergerfs over NFS\n" |
|
|
|
|
|
" where there are issues with creating files for\n" |
|
|
|
|
|
" write while setting the mode to read-only.\n" |
|
|
|
|
|
" default = off\n" |
|
|
|
|
|
" -o security_capability=BOOL\n" |
|
|
" When disabled return ENOATTR when the xattr\n" |
|
|
" When disabled return ENOATTR when the xattr\n" |
|
|
" security.capability is queried. default = true\n" |
|
|
" security.capability is queried. default = true\n" |
|
|
" -o xattr=passthrough|noattr|nosys\n" |
|
|
" -o xattr=passthrough|noattr|nosys\n" |
|
@ -387,8 +396,8 @@ usage(void) |
|
|
" as 'read only' or 'no create'. 'nc' will ignore\n" |
|
|
" as 'read only' or 'no create'. 'nc' will ignore\n" |
|
|
" available space for branches tagged as\n" |
|
|
" available space for branches tagged as\n" |
|
|
" 'no create'. default = none\n" |
|
|
" 'no create'. default = none\n" |
|
|
" -o posix_acl=<bool> Enable POSIX ACL support. default = false\n" |
|
|
|
|
|
" -o async_read=<bool> If disabled or unavailable the kernel will\n" |
|
|
|
|
|
|
|
|
" -o posix_acl=BOOL Enable POSIX ACL support. default = false\n" |
|
|
|
|
|
" -o async_read=BOOL If disabled or unavailable the kernel will\n" |
|
|
" ensure there is at most one pending read \n" |
|
|
" ensure there is at most one pending read \n" |
|
|
" request per file and will attempt to order\n" |
|
|
" request per file and will attempt to order\n" |
|
|
" requests by offset. default = true\n" |
|
|
" requests by offset. default = true\n" |
|
|