Skip to content

Commit 38ab3dd

Browse files
committed
Version v1.72.0
1 parent 1d02e12 commit 38ab3dd

File tree

144 files changed

+44983
-17552
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

144 files changed

+44983
-17552
lines changed

MANUAL.html

Lines changed: 10784 additions & 5185 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

MANUAL.md

Lines changed: 12190 additions & 5820 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

MANUAL.txt

Lines changed: 6014 additions & 1924 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

docs/content/archive.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -237,7 +237,6 @@ It would be possible to add ISO support fairly easily as the library we use ([go
237237
It would be possible to add write support, but this would only be for creating new archives, not for updating existing archives.
238238

239239
<!-- autogenerated options start - DO NOT EDIT - instead edit fs.RegInfo in backend/archive/archive.go and run make backenddocs to verify --> <!-- markdownlint-disable-line line-length -->
240-
241240
### Standard options
242241

243242
Here are the Standard options specific to archive (Read archives).

docs/content/azureblob.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -959,13 +959,13 @@ Properties:
959959
- Type: string
960960
- Required: false
961961
- Examples:
962-
- ""
963-
- The container and its blobs can be accessed only with an authorized request.
964-
- It's a default value.
965-
- "blob"
966-
- Blob data within this container can be read via anonymous request.
967-
- "container"
968-
- Allow full public read access for container and blob data.
962+
- ""
963+
- The container and its blobs can be accessed only with an authorized request.
964+
- It's a default value.
965+
- "blob"
966+
- Blob data within this container can be read via anonymous request.
967+
- "container"
968+
- Allow full public read access for container and blob data.
969969

970970
#### --azureblob-directory-markers
971971

@@ -1022,12 +1022,12 @@ Properties:
10221022
- Type: string
10231023
- Required: false
10241024
- Choices:
1025-
- ""
1026-
- By default, the delete operation fails if a blob has snapshots
1027-
- "include"
1028-
- Specify 'include' to remove the root blob and all its snapshots
1029-
- "only"
1030-
- Specify 'only' to remove only the snapshots but keep the root blob.
1025+
- ""
1026+
- By default, the delete operation fails if a blob has snapshots
1027+
- "include"
1028+
- Specify 'include' to remove the root blob and all its snapshots
1029+
- "only"
1030+
- Specify 'only' to remove only the snapshots but keep the root blob.
10311031

10321032
#### --azureblob-description
10331033

docs/content/b2.md

Lines changed: 114 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -667,6 +667,71 @@ Properties:
667667
- Type: Encoding
668668
- Default: Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot
669669

670+
#### --b2-sse-customer-algorithm
671+
672+
If using SSE-C, the server-side encryption algorithm used when storing this object in B2.
673+
674+
Properties:
675+
676+
- Config: sse_customer_algorithm
677+
- Env Var: RCLONE_B2_SSE_CUSTOMER_ALGORITHM
678+
- Type: string
679+
- Required: false
680+
- Examples:
681+
- ""
682+
- None
683+
- "AES256"
684+
- Advanced Encryption Standard (256 bits key length)
685+
686+
#### --b2-sse-customer-key
687+
688+
To use SSE-C, you may provide the secret encryption key encoded in a UTF-8 compatible string to encrypt/decrypt your data
689+
690+
Alternatively you can provide --sse-customer-key-base64.
691+
692+
Properties:
693+
694+
- Config: sse_customer_key
695+
- Env Var: RCLONE_B2_SSE_CUSTOMER_KEY
696+
- Type: string
697+
- Required: false
698+
- Examples:
699+
- ""
700+
- None
701+
702+
#### --b2-sse-customer-key-base64
703+
704+
To use SSE-C, you may provide the secret encryption key encoded in Base64 format to encrypt/decrypt your data
705+
706+
Alternatively you can provide --sse-customer-key.
707+
708+
Properties:
709+
710+
- Config: sse_customer_key_base64
711+
- Env Var: RCLONE_B2_SSE_CUSTOMER_KEY_BASE64
712+
- Type: string
713+
- Required: false
714+
- Examples:
715+
- ""
716+
- None
717+
718+
#### --b2-sse-customer-key-md5
719+
720+
If using SSE-C you may provide the secret encryption key MD5 checksum (optional).
721+
722+
If you leave it blank, this is calculated automatically from the sse_customer_key provided.
723+
724+
725+
Properties:
726+
727+
- Config: sse_customer_key_md5
728+
- Env Var: RCLONE_B2_SSE_CUSTOMER_KEY_MD5
729+
- Type: string
730+
- Required: false
731+
- Examples:
732+
- ""
733+
- None
734+
670735
#### --b2-description
671736

672737
Description of the remote.
@@ -682,9 +747,11 @@ Properties:
682747

683748
Here are the commands specific to the b2 backend.
684749

685-
Run them with
750+
Run them with:
686751

687-
rclone backend COMMAND remote:
752+
```console
753+
rclone backend COMMAND remote:
754+
```
688755

689756
The help below will explain what arguments each command takes.
690757

@@ -696,35 +763,41 @@ These can be run on a running backend using the rc command
696763

697764
### lifecycle
698765

699-
Read or set the lifecycle for a bucket
766+
Read or set the lifecycle for a bucket.
700767

701-
rclone backend lifecycle remote: [options] [<arguments>+]
768+
```console
769+
rclone backend lifecycle remote: [options] [<arguments>+]
770+
```
702771

703772
This command can be used to read or set the lifecycle for a bucket.
704773

705-
Usage Examples:
706-
707774
To show the current lifecycle rules:
708775

709-
rclone backend lifecycle b2:bucket
776+
```console
777+
rclone backend lifecycle b2:bucket
778+
```
710779

711780
This will dump something like this showing the lifecycle rules.
712781

713-
[
714-
{
715-
"daysFromHidingToDeleting": 1,
716-
"daysFromUploadingToHiding": null,
717-
"daysFromStartingToCancelingUnfinishedLargeFiles": null,
718-
"fileNamePrefix": ""
719-
}
720-
]
782+
```json
783+
[
784+
{
785+
"daysFromHidingToDeleting": 1,
786+
"daysFromUploadingToHiding": null,
787+
"daysFromStartingToCancelingUnfinishedLargeFiles": null,
788+
"fileNamePrefix": ""
789+
}
790+
]
791+
```
721792

722-
If there are no lifecycle rules (the default) then it will just return [].
793+
If there are no lifecycle rules (the default) then it will just return `[]`.
723794

724795
To reset the current lifecycle rules:
725796

726-
rclone backend lifecycle b2:bucket -o daysFromHidingToDeleting=30
727-
rclone backend lifecycle b2:bucket -o daysFromUploadingToHiding=5 -o daysFromHidingToDeleting=1
797+
```console
798+
rclone backend lifecycle b2:bucket -o daysFromHidingToDeleting=30
799+
rclone backend lifecycle b2:bucket -o daysFromUploadingToHiding=5 -o daysFromHidingToDeleting=1
800+
```
728801

729802
This will run and then print the new lifecycle rules as above.
730803

@@ -736,52 +809,61 @@ the daysFromHidingToDeleting to 1 day. You can enable hard_delete in
736809
the config also which will mean deletions won't cause versions but
737810
overwrites will still cause versions to be made.
738811

739-
rclone backend lifecycle b2:bucket -o daysFromHidingToDeleting=1
740-
741-
See: https://www.backblaze.com/docs/cloud-storage-lifecycle-rules
812+
```console
813+
rclone backend lifecycle b2:bucket -o daysFromHidingToDeleting=1
814+
```
742815

816+
See: <https://www.backblaze.com/docs/cloud-storage-lifecycle-rules>
743817

744818
Options:
745819

746-
- "daysFromHidingToDeleting": After a file has been hidden for this many days it is deleted. 0 is off.
747-
- "daysFromStartingToCancelingUnfinishedLargeFiles": Cancels any unfinished large file versions after this many days
748-
- "daysFromUploadingToHiding": This many days after uploading a file is hidden
820+
- "daysFromHidingToDeleting": After a file has been hidden for this many days
821+
it is deleted. 0 is off.
822+
- "daysFromStartingToCancelingUnfinishedLargeFiles": Cancels any unfinished
823+
large file versions after this many days.
824+
- "daysFromUploadingToHiding": This many days after uploading a file is hidden.
749825

750826
### cleanup
751827

752828
Remove unfinished large file uploads.
753829

754-
rclone backend cleanup remote: [options] [<arguments>+]
830+
```console
831+
rclone backend cleanup remote: [options] [<arguments>+]
832+
```
755833

756834
This command removes unfinished large file uploads of age greater than
757835
max-age, which defaults to 24 hours.
758836

759837
Note that you can use --interactive/-i or --dry-run with this command to see what
760838
it would do.
761839

762-
rclone backend cleanup b2:bucket/path/to/object
763-
rclone backend cleanup -o max-age=7w b2:bucket/path/to/object
840+
```console
841+
rclone backend cleanup b2:bucket/path/to/object
842+
rclone backend cleanup -o max-age=7w b2:bucket/path/to/object
843+
```
764844

765845
Durations are parsed as per the rest of rclone, 2h, 7d, 7w etc.
766846

767-
768847
Options:
769848

770-
- "max-age": Max age of upload to delete
849+
- "max-age": Max age of upload to delete.
771850

772851
### cleanup-hidden
773852

774853
Remove old versions of files.
775854

776-
rclone backend cleanup-hidden remote: [options] [<arguments>+]
855+
```console
856+
rclone backend cleanup-hidden remote: [options] [<arguments>+]
857+
```
777858

778859
This command removes any old hidden versions of files.
779860

780861
Note that you can use --interactive/-i or --dry-run with this command to see what
781862
it would do.
782863

783-
rclone backend cleanup-hidden b2:bucket/path/to/dir
784-
864+
```console
865+
rclone backend cleanup-hidden b2:bucket/path/to/dir
866+
```
785867

786868
<!-- autogenerated options stop -->
787869

docs/content/bisync.md

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1047,20 +1047,16 @@ encodings.)
10471047
The following backends have known issues that need more investigation:
10481048

10491049
<!--- start list_failures - DO NOT EDIT THIS SECTION - use make commanddocs --->
1050-
- `TestGoFile` (`gofile`)
1051-
- [`TestBisyncRemoteLocal/all_changed`](https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt)
1052-
- [`TestBisyncRemoteLocal/backupdir`](https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt)
1053-
- [`TestBisyncRemoteLocal/basic`](https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt)
1054-
- [`TestBisyncRemoteLocal/changes`](https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt)
1055-
- [`TestBisyncRemoteLocal/check_access`](https://pub.rclone.org/integration-tests/current/gofile-cmd.bisync-TestGoFile-1.txt)
1056-
- [78 more](https://pub.rclone.org/integration-tests/current/)
1057-
- Updated: 2025-08-21-010015
1050+
- `TestDropbox` (`dropbox`)
1051+
- [`TestBisyncRemoteRemote/normalization`](https://pub.rclone.org/integration-tests/current/dropbox-cmd.bisync-TestDropbox-1.txt)
1052+
- Updated: 2025-11-21-010037
10581053
<!--- end list_failures - DO NOT EDIT THIS SECTION - use make commanddocs --->
10591054

10601055
The following backends either have not been tested recently or have known issues
10611056
that are deemed unfixable for the time being:
10621057

10631058
<!--- start list_ignores - DO NOT EDIT THIS SECTION - use make commanddocs --->
1059+
- `TestArchive` (`archive`)
10641060
- `TestCache` (`cache`)
10651061
- `TestFileLu` (`filelu`)
10661062
- `TestFilesCom` (`filescom`)

docs/content/box.md

Lines changed: 17 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -323,6 +323,19 @@ Properties:
323323
- Type: string
324324
- Required: false
325325

326+
#### --box-config-credentials
327+
328+
Box App config.json contents.
329+
330+
Leave blank normally.
331+
332+
Properties:
333+
334+
- Config: config_credentials
335+
- Env Var: RCLONE_BOX_CONFIG_CREDENTIALS
336+
- Type: string
337+
- Required: false
338+
326339
#### --box-access-token
327340

328341
Box App Primary Access Token
@@ -347,10 +360,10 @@ Properties:
347360
- Type: string
348361
- Default: "user"
349362
- Examples:
350-
- "user"
351-
- Rclone should act on behalf of a user.
352-
- "enterprise"
353-
- Rclone should act on behalf of a service account.
363+
- "user"
364+
- Rclone should act on behalf of a user.
365+
- "enterprise"
366+
- Rclone should act on behalf of a service account.
354367

355368
### Advanced options
356369

0 commit comments

Comments
 (0)