rclone/docs/content/commands/rclone_cryptcheck.md

87 lines
3.3 KiB
Markdown
Raw Normal View History

2017-03-05 18:19:22 +08:00
---
title: "rclone cryptcheck"
2023-03-24 21:31:39 +08:00
description: "Cryptcheck checks the integrity of an encrypted remote."
2017-03-05 18:19:22 +08:00
slug: rclone_cryptcheck
url: /commands/rclone_cryptcheck/
2022-12-21 01:16:14 +08:00
versionIntroduced: v1.36
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/cryptcheck/ and as part of making a release run "make commanddocs"
2017-03-05 18:19:22 +08:00
---
# rclone cryptcheck
2017-03-05 18:19:22 +08:00
2023-03-24 21:31:39 +08:00
Cryptcheck checks the integrity of an encrypted remote.
2017-03-05 18:19:22 +08:00
## Synopsis
2017-03-05 18:19:22 +08:00
2023-06-30 21:11:17 +08:00
rclone cryptcheck checks a remote against a [crypted](/crypt/) remote.
2022-07-10 01:08:20 +08:00
This is the equivalent of running rclone [check](/commands/rclone_check/),
2023-03-24 21:31:39 +08:00
but able to check the checksums of the encrypted remote.
2017-03-05 18:19:22 +08:00
2023-06-30 21:11:17 +08:00
For it to work the underlying remote of the cryptedremote must support
2017-03-05 18:19:22 +08:00
some kind of checksum.
2023-06-30 21:11:17 +08:00
It works by reading the nonce from each file on the cryptedremote: and
2017-03-05 18:19:22 +08:00
using that to encrypt each file on the remote:. It then checks the
2023-06-30 21:11:17 +08:00
checksum of the underlying file on the cryptedremote: against the
2017-03-05 18:19:22 +08:00
checksum of the file it has just encrypted.
Use it like this
rclone cryptcheck /path/to/files encryptedremote:path
You can use it like this also, but that will involve downloading all
the files in remote:path.
rclone cryptcheck remote:path encryptedremote:path
After it has run it will log the status of the encryptedremote:.
2020-09-02 23:59:04 +08:00
If you supply the `--one-way` flag, it will only check that files in
the source match the files in the destination, not the other way
around. This means that extra files in the destination that are not in
the source will not be detected.
2021-02-02 21:42:35 +08:00
The `--differ`, `--missing-on-dst`, `--missing-on-src`, `--match`
2020-09-02 23:59:04 +08:00
and `--error` flags write paths, one per line, to the file name (or
stdout if it is `-`) supplied. What they write is described in the
help below. For example `--differ` will write all paths which are
present on both the source and destination but different.
The `--combined` flag will write a file (or stdout) which contains all
file paths with a symbol and then a space and then the path to tell
you what happened to it. These are reminiscent of diff files.
- `= path` means path was found in source and destination and was identical
- `- path` means path was missing on the source, so only in the destination
- `+ path` means path was missing on the destination, so only in the source
- `* path` means path was present in source and destination but different.
- `! path` means there was an error reading or hashing the source or dest.
2018-06-17 01:21:09 +08:00
2023-06-30 21:11:17 +08:00
The default number of parallel checks is 8. See the [--checkers=N](/docs/#checkers-n)
option for more information.
2017-03-05 18:19:22 +08:00
```
2023-06-30 21:11:17 +08:00
rclone cryptcheck remote:path cryptedremote:path [flags]
2017-09-30 21:19:47 +08:00
```
## Options
2017-09-30 21:19:47 +08:00
```
2020-09-02 23:59:04 +08:00
--combined string Make a combined report of changes to this file
--differ string Report all non-matching files to this file
--error string Report all files with errors (hashing or reading) to this file
-h, --help help for cryptcheck
--match string Report all matching files to this file
--missing-on-dst string Report all files missing from the destination to this file
--missing-on-src string Report all files missing from the source to this file
--one-way Check one way only, source files must exist on remote
2017-03-05 18:19:22 +08:00
```
See the [global flags page](/flags/) for global options not listed here.
## SEE ALSO
2017-03-05 18:19:22 +08:00
2018-10-15 18:03:08 +08:00
* [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends.
2018-03-19 18:06:13 +08:00