github-mirror/rclone
2
0
Fork 0
mirror of https://github.com/rclone/rclone.git synced 2025-06-01 00:43:18 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

cmd: add --error-on-no-transfer option

Browse Source 
This allows rclone to exit with a non-zero return code if no files are
transferred. This is useful when calling rclone as part of a workflow/script
pipeline as it allows the end user to stop processing if no files have been
transferred.

NB: Enabling this option will return in rclone exiting non-zero if there are no
transfers. Depending on how your're currently using rclone in your scripts,
this may break existing setups!
This commit is contained in:
Jon Fautley
2019-12-18 11:52:20 +00:00
committed by Nick Craig-Wood
parent e2bf91452a
commit 53874bd8ee
4 changed files with 22 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
docs/content/docs.md
View File

@ -553,6 +553,18 @@ the time to send the request header.
The default is `1s`. Set to 0 to disable.
### --error-on-no-transfer ###
By default, rclone will exit with return code 0 if there were no errors.
This option allows rclone to return exit code 9 if no files were transferred
between the source and destination. This allows using rclone in scripts, and
triggering follow-on actions if data was copied, or skipping if not.
NB: Enabling this option turns a usually non-fatal error into a potentially
fatal one - please check and adjust your scripts accordingly!
### --ignore-case-sync ###
Using this option will cause rclone to ignore the case of the files
@ -1622,6 +1634,7 @@ it will log a high priority message if the retry was successful.
* `6` - Less serious errors (like 461 errors from dropbox) (NoRetry errors)
* `7` - Fatal error (one that more retries won't fix, like account suspended) (Fatal errors)
* `8` - Transfer exceeded - limit set by --max-transfer reached
* `9` - Operation successful, but no files transferred
Environment Variables
---------------------