2017-10-29 11:00:56 +00:00
// Package vfsflags implements command line flags to set up a vfs
package vfsflags
import (
2019-07-28 17:47:38 +00:00
"github.com/rclone/rclone/fs/config/flags"
"github.com/rclone/rclone/fs/rc"
2020-02-28 14:44:15 +00:00
"github.com/rclone/rclone/vfs/vfscommon"
2017-10-29 11:00:56 +00:00
"github.com/spf13/pflag"
)
// Options set by command line flags
var (
2020-02-28 14:44:15 +00:00
Opt = vfscommon . DefaultOpt
2019-01-08 10:52:14 +00:00
DirPerms = & FileMode { Mode : & Opt . DirPerms }
FilePerms = & FileMode { Mode : & Opt . FilePerms }
2017-10-29 11:00:56 +00:00
)
// AddFlags adds the non filing system specific flags to the command
2018-01-12 16:30:54 +00:00
func AddFlags ( flagSet * pflag . FlagSet ) {
2018-10-27 22:58:18 +00:00
rc . AddOption ( "vfs" , & Opt )
2023-07-10 17:34:10 +00:00
flags . BoolVarP ( flagSet , & Opt . NoModTime , "no-modtime" , "" , Opt . NoModTime , "Don't read/write the modification time (can speed things up)" , "VFS" )
flags . BoolVarP ( flagSet , & Opt . NoChecksum , "no-checksum" , "" , Opt . NoChecksum , "Don't compare checksums on up/download" , "VFS" )
flags . BoolVarP ( flagSet , & Opt . NoSeek , "no-seek" , "" , Opt . NoSeek , "Don't allow seeking in files" , "VFS" )
2024-07-02 16:31:51 +00:00
flags . FVarP ( flagSet , & Opt . DirCacheTime , "dir-cache-time" , "" , "Time to cache directory entries for" , "VFS" )
2023-12-06 11:00:04 +00:00
flags . BoolVarP ( flagSet , & Opt . Refresh , "vfs-refresh" , "" , Opt . Refresh , "Refreshes the directory cache recursively in the background on start" , "VFS" )
2024-07-02 16:31:51 +00:00
flags . FVarP ( flagSet , & Opt . PollInterval , "poll-interval" , "" , "Time to wait between polling for changes, must be smaller than dir-cache-time and only on supported remotes (set 0 to disable)" , "VFS" )
2023-07-10 17:34:10 +00:00
flags . BoolVarP ( flagSet , & Opt . ReadOnly , "read-only" , "" , Opt . ReadOnly , "Only allow read-only access" , "VFS" )
flags . FVarP ( flagSet , & Opt . CacheMode , "vfs-cache-mode" , "" , "Cache mode off|minimal|writes|full" , "VFS" )
2024-07-02 16:31:51 +00:00
flags . FVarP ( flagSet , & Opt . CachePollInterval , "vfs-cache-poll-interval" , "" , "Interval to poll the cache for stale objects" , "VFS" )
flags . FVarP ( flagSet , & Opt . CacheMaxAge , "vfs-cache-max-age" , "" , "Max time since last access of objects in the cache" , "VFS" )
2023-07-10 17:34:10 +00:00
flags . FVarP ( flagSet , & Opt . CacheMaxSize , "vfs-cache-max-size" , "" , "Max total size of objects in the cache" , "VFS" )
2023-09-05 11:38:19 +00:00
flags . FVarP ( flagSet , & Opt . CacheMinFreeSpace , "vfs-cache-min-free-space" , "" , "Target minimum free space on the disk containing the cache" , "VFS" )
2023-07-10 17:34:10 +00:00
flags . FVarP ( flagSet , & Opt . ChunkSize , "vfs-read-chunk-size" , "" , "Read the source objects in chunks" , "VFS" )
flags . FVarP ( flagSet , & Opt . ChunkSizeLimit , "vfs-read-chunk-size-limit" , "" , "If greater than --vfs-read-chunk-size, double the chunk size after each chunk read, until the limit is reached ('off' is unlimited)" , "VFS" )
flags . FVarP ( flagSet , DirPerms , "dir-perms" , "" , "Directory permissions" , "VFS" )
flags . FVarP ( flagSet , FilePerms , "file-perms" , "" , "File permissions" , "VFS" )
flags . BoolVarP ( flagSet , & Opt . CaseInsensitive , "vfs-case-insensitive" , "" , Opt . CaseInsensitive , "If a file name not found, find a case insensitive match" , "VFS" )
vfs: fix unicode normalization on macOS - fixes #7072
Before this change, the VFS layer did not properly handle unicode normalization,
which caused problems particularly for users of macOS. While attempts were made
to handle it with various `-o modules=iconv` combinations, this was an imperfect
solution, as no one combination allowed both NFC and NFD content to
simultaneously be both visible and editable via Finder.
After this change, the VFS supports `--no-unicode-normalization` (default `false`)
via the existing `--vfs-case-insensitive` logic, which is extended to apply to both
case insensitivity and unicode normalization form.
This change also adds an additional flag, `--vfs-block-norm-dupes`, to address a
probably rare but potentially possible scenario where a directory contains
multiple duplicate filenames after applying case and unicode normalization
settings. In such a scenario, this flag (disabled by default) hides the
duplicates. This comes with a performance tradeoff, as rclone will have to scan
the entire directory for duplicates when listing a directory. For this reason,
it is recommended to leave this disabled if not needed. However, macOS users may
wish to consider using it, as otherwise, if a remote directory contains both NFC
and NFD versions of the same filename, an odd situation will occur: both
versions of the file will be visible in the mount, and both will appear to be
editable, however, editing either version will actually result in only the NFD
version getting edited under the hood. `--vfs-block-norm-dupes` prevents this
confusion by detecting this scenario, hiding the duplicates, and logging an
error, similar to how this is handled in `rclone sync`.
2024-02-05 07:58:11 +00:00
flags . BoolVarP ( flagSet , & Opt . BlockNormDupes , "vfs-block-norm-dupes" , "" , Opt . BlockNormDupes , "If duplicate filenames exist in the same directory (after normalization), log an error and hide the duplicates (may have a performance cost)" , "VFS" )
2024-07-02 16:31:51 +00:00
flags . FVarP ( flagSet , & Opt . WriteWait , "vfs-write-wait" , "" , "Time to wait for in-sequence write before giving error" , "VFS" )
flags . FVarP ( flagSet , & Opt . ReadWait , "vfs-read-wait" , "" , "Time to wait for in-sequence read before seeking" , "VFS" )
flags . FVarP ( flagSet , & Opt . WriteBack , "vfs-write-back" , "" , "Time to writeback files after last use when using cache" , "VFS" )
2023-07-10 17:34:10 +00:00
flags . FVarP ( flagSet , & Opt . ReadAhead , "vfs-read-ahead" , "" , "Extra read ahead over --buffer-size when using cache-mode full" , "VFS" )
flags . BoolVarP ( flagSet , & Opt . UsedIsSize , "vfs-used-is-size" , "" , Opt . UsedIsSize , "Use the `rclone size` algorithm for Used size" , "VFS" )
flags . BoolVarP ( flagSet , & Opt . FastFingerprint , "vfs-fast-fingerprint" , "" , Opt . FastFingerprint , "Use fast (less accurate) fingerprints for change detection" , "VFS" )
flags . FVarP ( flagSet , & Opt . DiskSpaceTotalSize , "vfs-disk-space-total-size" , "" , "Specify the total space of disk" , "VFS" )
2018-01-12 16:30:54 +00:00
platformFlags ( flagSet )
2017-10-29 11:00:56 +00:00
}