github-mirror/rclone
2
0
Fork 0
mirror of https://github.com/rclone/rclone.git synced 2024-12-19 09:13:43 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
874d66658e
rclone/docs/content
History
Nick Craig-Wood 874d66658e fs: fix setting stringArray config values from environment variables 
After the config re-organisation, the setting of stringArray config
values (eg `--exclude` set with `RCLONE_EXCLUDE`) was broken and gave
a message like this for `RCLONE_EXCLUDE=*.jpg`:

    Failed to load "filter" default values: failed to initialise "filter" options:
    couldn't parse config item "exclude" = "*.jpg" as []string: parsing "*.jpg" as []string failed:
    invalid character '/' looking for beginning of value

This was caused by the parser trying to parse the input string as a
JSON value.

When the config was re-organised it was thought that the internal
representation of stringArray values was not important as it was never
visible externally, however this turned out not to be true.

A defined representation was chosen - a comma separated string and
this was documented and tests were introduced in this patch.

This potentially introduces a very small backwards incompatibility. In
rclone v1.67.0

    RCLONE_EXCLUDE=a,b

Would be interpreted as

    --exclude "a,b"

Whereas this new code will interpret it as

    --exclude "a" --exclude "b"

The benefit of being able to set multiple values with an environment
variable was deemed to outweigh the very small backwards compatibility
risk.

If a value with a `,` is needed, then use CSV escaping, eg

    RCLONE_EXCLUDE="a,b"

(Note this needs to have the quotes in so at the unix shell that would be

    RCLONE_EXCLUDE='"a,b"'

Fixes #8063
2024-09-13 15:52:51 +01:00
..
commands Version v1.68.0 2024-09-08 16:21:56 +01:00
oracleobjectstorage docs: fix hugo warning: found no layout file for "html" for kind "section" 2024-06-15 12:29:37 +01:00
_index.md filescom: add Files.com backend 2024-08-15 17:00:39 +01:00
alias.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
amazonclouddrive.md amazonclouddrive: remove Amazon Drive backend code and docs #7539 2024-01-04 17:05:54 +00:00
authors.md Add ttionya to contributors 2024-09-13 15:52:51 +01:00
azureblob.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
azurefiles.md Version v1.67.0 2024-06-14 16:04:51 +01:00
b2.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
bisync.md bisync: don't convert modtime precision in listings - fixes #8025 2024-08-24 22:32:48 -04:00
box.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
bugs.md docs: update to reflect dir modtime/metadata support 2024-03-07 11:09:07 +00:00
cache.md Version v1.67.0 2024-06-14 16:04:51 +01:00
changelog.md Version v1.68.0 2024-09-08 16:21:56 +01:00
chunker.md Version v1.67.0 2024-06-14 16:04:51 +01:00
combine.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
compress.md Version v1.67.0 2024-06-14 16:04:51 +01:00
contact.md docs: update contact page on website 2023-07-05 16:57:07 +01:00
crypt.md Version v1.67.0 2024-06-14 16:04:51 +01:00
docker.md docs: show only significant parts of version number in version introduced label 2022-12-21 12:41:47 +00:00
docs.md fs: fix setting stringArray config values from environment variables 2024-09-13 15:52:51 +01:00
downloads.md docs: note that newer linux kernel version is required for ARMv5 2024-04-27 22:21:40 +02:00
drive.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
dropbox.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
faq.md docs: link the workaround for big directory syncs in the FAQ #7974 2024-08-01 16:33:09 +01:00
fichier.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
filefabric.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
filescom.md filescom: add Files.com backend 2024-08-15 17:00:39 +01:00
filtering.md docs: filtering: added Byte unit for min/max-size parameters. 2024-09-06 12:28:29 +01:00
flags.md Version v1.68.0 2024-09-08 16:21:56 +01:00
ftp.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
gofile.md Version v1.68.0 2024-09-08 16:21:56 +01:00
googlecloudstorage.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
googlephotos.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
gui.md docs: show only significant parts of version number in version introduced label 2022-12-21 12:41:47 +00:00
hasher.md docs: clarify hasher operation 2024-07-24 11:07:52 +01:00
hdfs.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
hidrive.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
http.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
imagekit.md Version v1.67.0 2024-06-14 16:04:51 +01:00
install.md docs: add comment how to reduce rclone binary size (#8000) 2024-08-10 17:52:32 +01:00
install.sh install.sh: fix harmless error message on install 2023-11-28 19:10:04 +00:00
internetarchive.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
jottacloud.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
KEYS docs: document release signing and verification 2023-09-11 12:28:23 +01:00
koofr.md Version v1.67.0 2024-06-14 16:04:51 +01:00
licence.md docs: fix typo in license webpage 2022-07-06 11:25:31 +01:00
linkbox.md Version v1.67.0 2024-06-14 16:04:51 +01:00
local.md Version v1.68.0 2024-09-08 16:21:56 +01:00
mailru.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
mega.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
memory.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
netstorage.md Version v1.67.0 2024-06-14 16:04:51 +01:00
onedrive.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
opendrive.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
overview.md docs: mark filescom as supporting link sharing 2024-08-15 22:55:45 +01:00
pcloud.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
pikpak.md Version v1.67.0 2024-06-14 16:04:51 +01:00
pixeldrain.md Add pixeldrain backend 2024-08-12 13:35:44 +01:00
premiumizeme.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
privacy.md docs: improve grammar and fix typos (#5361) 2021-11-04 12:50:43 +01:00
protondrive.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
putio.md Version v1.67.0 2024-06-14 16:04:51 +01:00
qingstor.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
quatrix.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
rc.md Version v1.68.0 2024-09-08 16:21:56 +01:00
release_signing.md docs: more secure two-step signature and hash validation 2024-09-05 16:54:26 +01:00
remote_setup.md docs: update ssh tunnel example 2024-08-16 20:27:23 +02:00
s3.md docs: add section for improving performance for s3 2024-09-12 11:29:35 +01:00
seafile.md Version v1.67.0 2024-06-14 16:04:51 +01:00
sftp.md Version v1.68.0 2024-09-08 16:21:56 +01:00
sharefile.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
sia.md Version v1.67.0 2024-06-14 16:04:51 +01:00
smb.md Version v1.67.0 2024-06-14 16:04:51 +01:00
sponsor.md docs: add Route4Me as a sponsor 2024-07-22 14:48:41 +01:00
storj.md docs: make tardigrade page auto redirect to storj page 2024-08-17 16:00:42 +02:00
sugarsync.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
swift.md Version v1.68.0 2024-09-08 16:21:56 +01:00
ulozto.md Version v1.67.0 2024-06-14 16:04:51 +01:00
union.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
uptobox.md Version v1.67.0 2024-06-14 16:04:51 +01:00
webdav.md docs: update backend config samples 2024-08-17 16:00:18 +02:00
yandex.md yandex: implement custom user agent to help with upload speeds 2024-08-29 18:25:08 +01:00
zoho.md docs: update backend config samples 2024-08-17 16:00:18 +02:00