Skip to content

"rsync for cloud storage" - Google Drive, S3, Dropbox, Backblaze B2, One Drive, Swift, Hubic, Wasabi, Google Cloud Storage, Azure Blob, Azure Files, Yandex Files

filescom: document that names with / or \ in can't be stored and ignore their tests

Nick Craig-Wooded92e4446e93
diff --git a/docs/content/filescom.md b/docs/content/filescom.md
index ef60f575c..5a23e91bd 100644
--- a/docs/content/filescom.md
+++ b/docs/content/filescom.md
@@ -111,6 +111,34 @@ excess files in the directory.
rclone sync --interactive /home/local/directory remote:dir
```
+### Restricted filename characters
+
+In addition to the [default restricted characters set](/overview/#restricted-characters)
+the following characters are also replaced:
+
+| Character | Value | Replacement |
+| --------- |:-----:|:-----------:|
+| \ | 0x5C | \ |
+
+File names can also not end with the following characters.
+These only get replaced if they are the last character in the name:
+
+| Character | Value | Replacement |
+| --------- |:-----:|:-----------:|
+| SP | 0x20 | ␠ |
+| LF | 0x0A | ␊ |
+| CR | 0x0D | ␍ |
+| HT | 0x09 | ␉ |
+| VT | 0x0B | ␋ |
+
+Invalid UTF-8 bytes will also be [replaced](/overview/#invalid-utf8).
+
+Files.com treats the replacements `/` and `\` as if they were `/`
+and `\`, and the names `.` and `..` as if they were `.` and `..`,
+and rejects them with `Invalid path`. This means that files with `/`
+or `\` in their names, or which are called `.` or `..`, can't be
+stored on Files.com.
+
### Hashes
In December 2024 `files.com` started [supporting more checksums](https://www.files.com/blog/2024/11/01/new-modern-checksum-options-now-available-with-opt).
diff --git a/fstest/test_all/config.yaml b/fstest/test_all/config.yaml
index 3bb9ca9dd..81425dcb6 100644
--- a/fstest/test_all/config.yaml
+++ b/fstest/test_all/config.yaml
@@ -194,6 +194,11 @@ backends:
- backend: "filescom"
remote: "TestFilesCom:"
fastlist: false
+ ignore:
+ # Files.com rejects the replacements for ".", "..", "/" and "\"
+ - TestIntegration/FsMkdir/FsEncoding/dot
+ - TestIntegration/FsMkdir/FsEncoding/dot_dot
+ - TestIntegration/FsMkdir/FsEncoding/punctuation
ignoretests:
- cmd/bisync
- backend: "googlecloudstorage"