extern/rclone
1
0
Fork 0
mirror of https://github.com/rclone/rclone.git synced 2024-11-22 08:23:47 +01:00
Code Issues Packages Projects Releases Wiki Activity

Version v1.62.0

Browse Source
This commit is contained in:
Nick Craig-Wood 2023-03-14 12:16:30 +00:00
parent ffd4ab222c
commit 77c7077458
18 changed files with 4258 additions and 695 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

825
MANUAL.html generated
View File

File diff suppressed because it is too large Load Diff

1061
MANUAL.md generated
View File

File diff suppressed because it is too large Load Diff

1138
MANUAL.txt generated
View File

File diff suppressed because it is too large Load Diff

104
docs/content/changelog.md
View File

@ -5,6 +5,110 @@ description: "Rclone Changelog"
# Changelog
## v1.62.0 - 2023-03-14
[See commits](https://github.com/rclone/rclone/compare/v1.61.0...v1.62.0)
* New Features
* accounting: Make checkers show what they are doing (Nick Craig-Wood)
* authorize: Add support for custom templates (Hunter Wittenborn)
* build
* Update to go1.20 (Nick Craig-Wood, Anagh Kumar Baranwal)
* Add winget releaser workflow (Ryan Caezar Itang)
* Add dependabot (Ryan Caezar Itang)
* doc updates (albertony, Bryan Kaplan, Gerard Bosch, IMTheNachoMan, Justin Winokur, Manoj Ghosh, Nick Craig-Wood, Ole Frost, Peter Brunner, piyushgarg, Ryan Caezar Itang, Simmon Li, ToBeFree)
* filter: Emit INFO message when can't work out directory filters (Nick Craig-Wood)
* fs
* Added multiple ca certificate support. (alankrit)
* Add `--max-delete-size` a delete size threshold (Leandro Sacchet)
* fspath: Allow the symbols `@` and `+` in remote names (albertony)
* lib/terminal: Enable windows console virtual terminal sequences processing (ANSI/VT100 colors) (albertony)
* move: If `--check-first` and `--order-by` are set then delete with perfect ordering (Nick Craig-Wood)
* serve http: Support `--auth-proxy` (Matthias Baur)
* Bug Fixes
* accounting
* Avoid negative ETA values for very slow speeds (albertony)
* Limit length of ETA string (albertony)
* Show human readable elapsed time when longer than a day (albertony)
* all: Apply codeql fixes (Aaron Gokaslan)
* build
* Fix condition for manual workflow run (albertony)
* Fix building for ARMv5 and ARMv6 (albertony)
* selfupdate: Consider ARM version
* install.sh: fix ARMv6 download
* version: Report ARM version
* deletefile: Return error code 4 if file does not exist (Nick Craig-Wood)
* docker: Fix volume plugin does not remount volume on docker restart (logopk)
* fs: Fix race conditions in `--max-delete` and `--max-delete-size` (Nick Craig-Wood)
* lib/oauthutil: Handle fatal errors better (Alex Chen)
* mount2: Fix `--allow-non-empty` (Nick Craig-Wood)
* operations: Fix concurrency: use `--checkers` unless transferring files (Nick Craig-Wood)
* serve ftp: Fix timestamps older than 1 year in listings (Nick Craig-Wood)
* sync: Fix concurrency: use `--checkers` unless transferring files (Nick Craig-Wood)
* tree
* Fix nil pointer exception on stat failure (Nick Craig-Wood)
* Fix colored output on windows (albertony)
* Fix display of files with illegal Windows file system names (Nick Craig-Wood)
* Mount
* Fix creating and renaming files on case insensitive backends (Nick Craig-Wood)
* Do not treat `\\?\` prefixed paths as network share paths on windows (albertony)
* Fix check for empty mount point on Linux (Nick Craig-Wood)
* Fix `--allow-non-empty` (Nick Craig-Wood)
* Avoid incorrect or premature overlap check on windows (albertony)
* Update to fuse3 after bazil.org/fuse update (Nick Craig-Wood)
* VFS
* Make uploaded files retain modtime with non-modtime backends (Nick Craig-Wood)
* Fix incorrect modtime on fs which don't support setting modtime (Nick Craig-Wood)
* Fix rename of directory containing files to be uploaded (Nick Craig-Wood)
* Local
* Fix `%!w(<nil>)` in "failed to read directory" error (Marks Polakovs)
* Fix exclusion of dangling symlinks with -L/--copy-links (Nick Craig-Wood)
* Crypt
* Obey `--ignore-checksum` (Nick Craig-Wood)
* Fix for unencrypted directory names on case insensitive remotes (Ole Frost)
* Azure Blob
* Remove workarounds for SDK bugs after v0.6.1 update (Nick Craig-Wood)
* B2
* Fix uploading files bigger than 1TiB (Nick Craig-Wood)
* Drive
* Note that `--drive-acknowledge-abuse` needs SA Manager permission (Nick Craig-Wood)
* Make `--drive-stop-on-upload-limit` to respond to storageQuotaExceeded (Ninh Pham)
* FTP
* Retry 426 errors (Nick Craig-Wood)
* Retry errors when initiating downloads (Nick Craig-Wood)
* Revert to upstream `github.com/jlaffaye/ftp` now fix is merged (Nick Craig-Wood)
* Google Cloud Storage
* Add `--gcs-env-auth` to pick up IAM credentials from env/instance (Peter Brunner)
* Mega
* Add `--mega-use-https` flag (NodudeWasTaken)
* Onedrive
* Default onedrive personal to QuickXorHash as Microsoft is removing SHA1 (Nick Craig-Wood)
* Add `--onedrive-hash-type` to change the hash in use (Nick Craig-Wood)
* Improve speed of QuickXorHash (LXY)
* Oracle Object Storage
* Speed up operations by using S3 pacer and setting minsleep to 10ms (Manoj Ghosh)
* Expose the `storage_tier` option in config (Manoj Ghosh)
* Bring your own encryption keys (Manoj Ghosh)
* S3
* Check multipart upload ETag when `--s3-no-head` is in use (Nick Craig-Wood)
* Add `--s3-sts-endpoint` to specify STS endpoint (Nick Craig-Wood)
* Fix incorrect tier support for StorJ and IDrive when pointing at a file (Ole Frost)
* Fix AWS STS failing if `--s3-endpoint` is set (Nick Craig-Wood)
* Make purge remove directory markers too (Nick Craig-Wood)
* Seafile
* Renew library password (Fred)
* SFTP
* Fix uploads being 65% slower than they should be with crypt (Nick Craig-Wood)
* Smb
* Allow SPN (service principal name) to be configured (Nick Craig-Wood)
* Check smb connection is closed (happyxhw)
* Storj
* Implement `rclone link` (Kaloyan Raev)
* Implement `rclone purge` (Kaloyan Raev)
* Update satellite urls and labels (Kaloyan Raev)
* WebDAV
* Fix interop with davrods server (Nick Craig-Wood)
## v1.61.1 - 2022-12-23
[See commits](https://github.com/rclone/rclone/compare/v1.61.0...v1.61.1)

6
docs/content/commands/rclone_authorize.md
View File

@ -20,9 +20,7 @@ rclone config.
Use --auth-no-open-browser to prevent rclone to open auth
link in default browser automatically.
Use --template to generate HTML output via a custom Go
template. If a blank string is provided as an argument to
this flag, the default template is used.
Use --template to generate HTML output via a custom Go template. If a blank string is provided as an argument to this flag, the default template is used.
```
rclone authorize [flags]
@ -33,7 +31,7 @@ rclone authorize [flags]
```
--auth-no-open-browser Do not automatically open auth link in default browser
-h, --help help for authorize
--template string Use a custom Go template for generating HTML responses
--template string The path to a custom Go template for generating HTML responses
```
See the [global flags page](/flags/) for global options not listed here.

73
docs/content/commands/rclone_mount.md
View File

@ -170,38 +170,59 @@ group "Everyone" will be used to represent others. The user/group can be customi
with FUSE options "UserName" and "GroupName",
e.g. `-o UserName=user123 -o GroupName="Authenticated Users"`.
The permissions on each entry will be set according to [options](#options)
`--dir-perms` and `--file-perms`, which takes a value in traditional
`--dir-perms` and `--file-perms`, which takes a value in traditional Unix
[numeric notation](https://en.wikipedia.org/wiki/File-system_permissions#Numeric_notation).
The default permissions corresponds to `--file-perms 0666 --dir-perms 0777`,
i.e. read and write permissions to everyone. This means you will not be able
to start any programs from the mount. To be able to do that you must add
execute permissions, e.g. `--file-perms 0777 --dir-perms 0777` to add it
to everyone. If the program needs to write files, chances are you will have
to enable [VFS File Caching](#vfs-file-caching) as well (see also [limitations](#limitations)).
to everyone. If the program needs to write files, chances are you will
have to enable [VFS File Caching](#vfs-file-caching) as well (see also
[limitations](#limitations)). Note that the default write permission have
some restrictions for accounts other than the owner, specifically it lacks
the "write extended attributes", as explained next.
Note that the mapping of permissions is not always trivial, and the result
you see in Windows Explorer may not be exactly like you expected.
For example, when setting a value that includes write access, this will be
mapped to individual permissions "write attributes", "write data" and "append data",
but not "write extended attributes". Windows will then show this as basic
permission "Special" instead of "Write", because "Write" includes the
"write extended attributes" permission.
The mapping of permissions is not always trivial, and the result you see in
Windows Explorer may not be exactly like you expected. For example, when setting
a value that includes write access for the group or others scope, this will be
mapped to individual permissions "write attributes", "write data" and
"append data", but not "write extended attributes". Windows will then show this
as basic permission "Special" instead of "Write", because "Write" also covers
the "write extended attributes" permission. When setting digit 0 for group or
others, to indicate no permissions, they will still get individual permissions
"read attributes", "read extended attributes" and "read permissions". This is
done for compatibility reasons, e.g. to allow users without additional
permissions to be able to read basic metadata about files like in Unix.
If you set POSIX permissions for only allowing access to the owner, using
`--file-perms 0600 --dir-perms 0700`, the user group and the built-in "Everyone"
group will still be given some special permissions, such as "read attributes"
and "read permissions", in Windows. This is done for compatibility reasons,
e.g. to allow users without additional permissions to be able to read basic
metadata about files like in UNIX. One case that may arise is that other programs
(incorrectly) interprets this as the file being accessible by everyone. For example
an SSH client may warn about "unprotected private key file".
WinFsp 2021 (version 1.9) introduces a new FUSE option "FileSecurity",
WinFsp 2021 (version 1.9) introduced a new FUSE option "FileSecurity",
that allows the complete specification of file security descriptors using
[SDDL](https://docs.microsoft.com/en-us/windows/win32/secauthz/security-descriptor-string-format).
With this you can work around issues such as the mentioned "unprotected private key file"
by specifying `-o FileSecurity="D:P(A;;FA;;;OW)"`, for file all access (FA) to the owner (OW).
With this you get detailed control of the resulting permissions, compared
to use of the POSIX permissions described above, and no additional permissions
will be added automatically for compatibility with Unix. Some example use
cases will following.
If you set POSIX permissions for only allowing access to the owner,
using `--file-perms 0600 --dir-perms 0700`, the user group and the built-in
"Everyone" group will still be given some special permissions, as described
above. Some programs may then (incorrectly) interpret this as the file being
accessible by everyone, for example an SSH client may warn about "unprotected
private key file". You can work around this by specifying
`-o FileSecurity="D:P(A;;FA;;;OW)"`, which sets file all access (FA) to the
owner (OW), and nothing else.
When setting write permissions then, except for the owner, this does not
include the "write extended attributes" permission, as mentioned above.
This may prevent applications from writing to files, giving permission denied
error instead. To set working write permissions for the built-in "Everyone"
group, similar to what it gets by default but with the addition of the
"write extended attributes", you can specify
`-o FileSecurity="D:P(A;;FRFW;;;WD)"`, which sets file read (FR) and file
write (FW) to everyone (WD). If file execute (FX) is also needed, then change
to `-o FileSecurity="D:P(A;;FRFWFX;;;WD)"`, or set file all access (FA) to
get full access permissions, including delete, with
`-o FileSecurity="D:P(A;;FA;;;WD)"`.
### Windows caveats
@ -230,10 +251,16 @@ processes as the SYSTEM account. Another alternative is to run the mount
command from a Windows Scheduled Task, or a Windows Service, configured
to run as the SYSTEM account. A third alternative is to use the
[WinFsp.Launcher infrastructure](https://github.com/winfsp/winfsp/wiki/WinFsp-Service-Architecture)).
Read more in the [install documentation](https://rclone.org/install/).
Note that when running rclone as another user, it will not use
the configuration file from your profile unless you tell it to
with the [`--config`](https://rclone.org/docs/#config-config-file) option.
Read more in the [install documentation](https://rclone.org/install/).
Note also that it is now the SYSTEM account that will have the owner
permissions, and other accounts will have permissions according to the
group or others scopes. As mentioned above, these will then not get the
"write extended attributes" permission, and this may prevent writing to
files. You can work around this with the FileSecurity option, see
example above.
Note that mapping to a directory path, instead of a drive letter,
does not suffer from the same limitations.

24
docs/content/commands/rclone_serve_webdav.md
View File

@ -28,6 +28,30 @@ supported hash on the backend or you can use a named hash such as
"MD5" or "SHA-1". Use the [hashsum](/commands/rclone_hashsum/) command
to see the full list.
## Access WebDAV on Windows
WebDAV shared folder can be mapped as a drive on Windows, however the default settings prevent it.
Windows will fail to connect to the server using insecure Basic authentication.
It will not even display any login dialog. Windows requires SSL / HTTPS connection to be used with Basic.
If you try to connect via Add Network Location Wizard you will get the following error:
"The folder you entered does not appear to be valid. Please choose another".
However, you still can connect if you set the following registry key on a client machine:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters\BasicAuthLevel to 2.
The BasicAuthLevel can be set to the following values:
0 - Basic authentication disabled
1 - Basic authentication enabled for SSL connections only
2 - Basic authentication enabled for SSL connections and for non-SSL connections
If required, increase the FileSizeLimitInBytes to a higher value.
Navigate to the Services interface, then restart the WebClient service.
## Access Office applications on WebDAV
Navigate to following registry HKEY_CURRENT_USER\Software\Microsoft\Office\[14.0/15.0/16.0]\Common\Internet
Create a new DWORD BasicAuthLevel with value 2.
0 - Basic authentication disabled
1 - Basic authentication enabled for SSL connections only
2 - Basic authentication enabled for SSL and for non-SSL connections
https://learn.microsoft.com/en-us/office/troubleshoot/powerpoint/office-opens-blank-from-sharepoint
## Server options

2
docs/content/crypt.md
View File

@ -455,7 +455,6 @@ Properties:
- "off"
- Don't encrypt the file names.
- Adds a ".bin" extension only.
- May cause problems on [case insensitive](/overview/#case-insensitive) [storage systems](/overview/#features) like OneDrive, Dropbox, Windows, OSX and SMB.
#### --crypt-directory-name-encryption
@ -474,7 +473,6 @@ Properties:
- Encrypt directory names.
- "false"
- Don't encrypt directory names, leave them intact.
- May cause problems on [case insensitive](/overview/#case-insensitive) [storage systems](/overview/#features) like OneDrive, Dropbox, Windows, OSX and SMB.
#### --crypt-password

10
docs/content/drive.md
View File

@ -988,6 +988,10 @@ as malware or spam and cannot be downloaded" with the error code
indicate you acknowledge the risks of downloading the file and rclone
will download it anyway.
Note that if you are using service account it will need Manager
permission (not Content Manager) to for this flag to work. If the SA
does not have the right permission, Google will just ignore the flag.
Properties:
- Config: acknowledge_abuse
@ -1362,9 +1366,9 @@ This takes an optional directory to trash which make this easier to
use via the API.
rclone backend untrash drive:directory
rclone backend -i untrash drive:directory subdir
rclone backend --interactive untrash drive:directory subdir
Use the -i flag to see what would be restored before restoring it.
Use the --interactive/-i or --dry-run flag to see what would be restored before restoring it.
Result:
@ -1398,7 +1402,7 @@ component will be used as the file name.
If the destination is a drive backend then server-side copying will be
attempted if possible.
Use the -i flag to see what would be copied before copying.
Use the --interactive/-i or --dry-run flag to see what would be copied before copying.
### exportformats

16
docs/content/flags.md
View File

@ -20,7 +20,7 @@ These flags are available for every command.
--buffer-size SizeSuffix In memory buffer size when reading files for each --transfer (default 16Mi)
--bwlimit BwTimetable Bandwidth limit in KiB/s, or use suffix B|K|M|G|T|P or a full timetable
--bwlimit-file BwTimetable Bandwidth limit per file in KiB/s, or use suffix B|K|M|G|T|P or a full timetable
--ca-cert string CA certificate used to verify servers
--ca-cert stringArray CA certificate used to verify servers
--cache-dir string Directory rclone will use for caching (default "$HOME/.cache/rclone")
--check-first Do all the checks before starting transfers
--checkers int Number of checkers to run in parallel (default 8)
@ -82,6 +82,7 @@ These flags are available for every command.
--max-age Duration Only transfer files younger than this in s or suffix ms|s|m|h|d|w|M|y (default off)
--max-backlog int Maximum number of objects in sync or check backlog (default 10000)
--max-delete int When synchronizing, limit the number of deletes (default -1)
--max-delete-size SizeSuffix When synchronizing, limit the total size of deletes (default off)
--max-depth int If set limits the recursion depth to this (default -1)
--max-duration Duration Maximum duration rclone will transfer data for (default 0s)
--max-size SizeSuffix Only transfer files smaller than this in KiB or suffix B|K|M|G|T|P (default off)
@ -170,7 +171,7 @@ These flags are available for every command.
--use-json-log Use json log format
--use-mmap Use mmap allocator (see docs)
--use-server-modtime Use server modified time instead of object metadata
--user-agent string Set the user-agent to a specified string (default "rclone/v1.61.0")
--user-agent string Set the user-agent to a specified string (default "rclone/v1.62.0")
-v, --verbose count Print lots more stuff (repeat for more)
```
@ -387,6 +388,7 @@ and may be set in the config file.
--gcs-decompress If set this will decompress gzip encoded objects
--gcs-encoding MultiEncoder The encoding for the backend (default Slash,CrLf,InvalidUtf8,Dot)
--gcs-endpoint string Endpoint for the service
--gcs-env-auth Get GCP IAM credentials from runtime (environment variables or instance meta data if no env vars)
--gcs-location string Location for the newly created buckets
--gcs-no-check-bucket If set, don't attempt to check the bucket exists or create it
--gcs-object-acl string Access Control List for new objects
@ -475,6 +477,7 @@ and may be set in the config file.
--mega-encoding MultiEncoder The encoding for the backend (default Slash,InvalidUtf8,Dot)
--mega-hard-delete Delete files permanently rather than putting them into the trash
--mega-pass string Password (obscured)
--mega-use-https Use HTTPS for transfers
--mega-user string User name
--netstorage-account string Set the NetStorage account name
--netstorage-host string Domain+path of NetStorage host to connect to
@ -490,6 +493,7 @@ and may be set in the config file.
--onedrive-drive-type string The type of the drive (personal | business | documentLibrary)
--onedrive-encoding MultiEncoder The encoding for the backend (default Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,LeftSpace,LeftTilde,RightSpace,RightPeriod,InvalidUtf8,Dot)
--onedrive-expose-onenote-files Set to make OneNote files show up in directory listings
--onedrive-hash-type string Specify the hash in use for the backend (default "auto")
--onedrive-link-password string Set the password for links created by the link command
--onedrive-link-scope string Set the scope of the links created by the link command (default "anonymous")
--onedrive-link-type string Set the type of the links created by the link command (default "view")
@ -514,6 +518,12 @@ and may be set in the config file.
--oos-no-check-bucket If set, don't attempt to check the bucket exists or create it
--oos-provider string Choose your Auth Provider (default "env_auth")
--oos-region string Object storage Region
--oos-sse-customer-algorithm string If using SSE-C, the optional header that specifies "AES256" as the encryption algorithm
--oos-sse-customer-key string To use SSE-C, the optional header that specifies the base64-encoded 256-bit encryption key to use to
--oos-sse-customer-key-file string To use SSE-C, a file containing the base64-encoded string of the AES-256 encryption key associated
--oos-sse-customer-key-sha256 string If using SSE-C, The optional header that specifies the base64-encoded SHA256 hash of the encryption
--oos-sse-kms-key-id string if using using your own master key in vault, this header specifies the
--oos-storage-tier string The storage class to use when storing new objects in storage. https://docs.oracle.com/en-us/iaas/Content/Object/Concepts/understandingstoragetiers.htm (default "Standard")
--oos-upload-concurrency int Concurrency for multipart uploads (default 10)
--oos-upload-cutoff SizeSuffix Cutoff for switching to chunked upload (default 200Mi)
--opendrive-chunk-size SizeSuffix Files will be uploaded in chunks this size (default 10Mi)
@ -582,6 +592,7 @@ and may be set in the config file.
--s3-sse-customer-key-md5 string If using SSE-C you may provide the secret encryption key MD5 checksum (optional)
--s3-sse-kms-key-id string If using KMS ID you must provide the ARN of Key
--s3-storage-class string The storage class to use when storing new objects in S3
--s3-sts-endpoint string Endpoint for STS
--s3-upload-concurrency int Concurrency for multipart uploads (default 4)
--s3-upload-cutoff SizeSuffix Cutoff for switching to chunked upload (default 200Mi)
--s3-use-accelerate-endpoint If true use the AWS S3 accelerated endpoint
@ -647,6 +658,7 @@ and may be set in the config file.
--smb-idle-timeout Duration Max time before closing idle connections (default 1m0s)
--smb-pass string SMB password (obscured)
--smb-port int SMB port number (default 445)
--smb-spn string Service principal name
--smb-user string SMB username (default "$USER")
--storj-access-grant string Access grant
--storj-api-key string API key

18
docs/content/googlecloudstorage.md
View File

@ -552,6 +552,24 @@ Properties:
- "DURABLE_REDUCED_AVAILABILITY"
- Durable reduced availability storage class
#### --gcs-env-auth
Get GCP IAM credentials from runtime (environment variables or instance meta data if no env vars).
Only applies if service_account_file and service_account_credentials is blank.
Properties:
- Config: env_auth
- Env Var: RCLONE_GCS_ENV_AUTH
- Type: bool
- Default: false
- Examples:
- "false"
- Enter credentials in the next step.
- "true"
- Get GCP IAM credentials from the environment (env vars or IAM).
### Advanced options
Here are the Advanced options specific to google cloud storage (Google Cloud Storage (this is not Google Drive)).

17
docs/content/mega.md
View File

@ -252,6 +252,23 @@ Properties:
- Type: bool
- Default: false
#### --mega-use-https
Use HTTPS for transfers.
MEGA uses plain text HTTP connections by default.
Some ISPs throttle HTTP connections, this causes transfers to become very slow.
Enabling this will force MEGA to use HTTPS for all transfers.
HTTPS is normally not necesary since all data is already encrypted anyway.
Enabling it will increase CPU usage and add network overhead.
Properties:
- Config: use_https
- Env Var: RCLONE_MEGA_USE_HTTPS
- Type: bool
- Default: false
#### --mega-encoding
The encoding for the backend.

42
docs/content/onedrive.md
View File

@ -526,6 +526,48 @@ Properties:
- Type: string
- Required: false
#### --onedrive-hash-type
Specify the hash in use for the backend.
This specifies the hash type in use. If set to "auto" it will use the
default hash which is is QuickXorHash.
Before rclone 1.62 an SHA1 hash was used by default for Onedrive
Personal. For 1.62 and later the default is to use a QuickXorHash for
all onedrive types. If an SHA1 hash is desired then set this option
accordingly.
From July 2023 QuickXorHash will be the only available hash for
both OneDrive for Business and OneDriver Personal.
This can be set to "none" to not use any hashes.
If the hash requested does not exist on the object, it will be
returned as an empty string which is treated as a missing hash by
rclone.
Properties:
- Config: hash_type
- Env Var: RCLONE_ONEDRIVE_HASH_TYPE
- Type: string
- Default: "auto"
- Examples:
- "auto"
- Rclone chooses the best hash
- "quickxor"
- QuickXor
- "sha1"
- SHA1
- "sha256"
- SHA256
- "crc32"
- CRC32
- "none"
- None - don't use any hashes
#### --onedrive-encoding
The encoding for the backend.

2
docs/content/rc.md
View File

@ -1458,6 +1458,8 @@ This takes the following parameters:
- remote - a path within that remote e.g. "dir"
- each part in body represents a file to be uploaded
See the [uploadfile](/commands/rclone_uploadfile/) command for more information on the above.
**Authentication is required for this call.**
### options/blocks: List all the option blocks {#options-blocks}

36
docs/content/s3.md
View File

@ -1474,7 +1474,7 @@ Properties:
#### --s3-endpoint
Endpoint of the Shared Gateway.
Endpoint for Storj Gateway.
Properties:
@ -1484,12 +1484,8 @@ Properties:
- Type: string
- Required: false
- Examples:
- "gateway.eu1.storjshare.io"
- EU1 Shared Gateway
- "gateway.us1.storjshare.io"
- US1 Shared Gateway
- "gateway.ap1.storjshare.io"
- Asia-Pacific Shared Gateway
- "gateway.storjshare.io"
- Global Hosted Gateway
#### --s3-endpoint
@ -2967,6 +2963,20 @@ Properties:
- Type: bool
- Default: false
#### --s3-sts-endpoint
Endpoint for STS.
Leave blank if using AWS to use the default endpoint for the region.
Properties:
- Config: sts_endpoint
- Env Var: RCLONE_S3_STS_ENDPOINT
- Provider: AWS
- Type: string
- Required: false
### Metadata
User metadata is stored as x-amz-meta- keys. S3 metadata keys are case insensitive and are always returned in lower case.
@ -3017,9 +3027,9 @@ Usage Examples:
rclone backend restore s3:bucket/path/to/directory [-o priority=PRIORITY] [-o lifetime=DAYS]
rclone backend restore s3:bucket [-o priority=PRIORITY] [-o lifetime=DAYS]
This flag also obeys the filters. Test first with -i/--interactive or --dry-run flags
This flag also obeys the filters. Test first with --interactive/-i or --dry-run flags
rclone -i backend restore --include "*.txt" s3:bucket/path -o priority=Standard
rclone --interactive backend restore --include "*.txt" s3:bucket/path -o priority=Standard
All the objects shown will be marked for restore, then
@ -3096,8 +3106,8 @@ Remove unfinished multipart uploads.
This command removes unfinished multipart uploads of age greater than
max-age which defaults to 24 hours.
Note that you can use -i/--dry-run with this command to see what it
would do.
Note that you can use --interactive/-i or --dry-run with this command to see what
it would do.
rclone backend cleanup s3:bucket/path/to/object
rclone backend cleanup -o max-age=7w s3:bucket/path/to/object
@ -3118,8 +3128,8 @@ Remove old versions of files.
This command removes any old hidden versions of files
on a versions enabled bucket.
Note that you can use -i/--dry-run with this command to see what it
would do.
Note that you can use --interactive/-i or --dry-run with this command to see what
it would do.
rclone backend cleanup-hidden s3:bucket/path/to/dir

19
docs/content/smb.md
View File

@ -171,6 +171,25 @@ Properties:
- Type: string
- Default: "WORKGROUP"
#### --smb-spn
Service principal name.
Rclone presents this name to the server. Some servers use this as further
authentication, and it often needs to be set for clusters. For example:
cifs/remotehost:1020
Leave blank if not sure.
Properties:
- Config: spn
- Env Var: RCLONE_SMB_SPN
- Type: string
- Required: false
### Advanced options
Here are the Advanced options specific to smb (SMB / CIFS).

1558
rclone.1 generated
View File

File diff suppressed because it is too large Load Diff