📦 deps(thirdparty): update snapshots
This commit is contained in:
@@ -0,0 +1,79 @@
|
||||
---
|
||||
title: "rclone rcat"
|
||||
description: "Copies standard input to file on remote."
|
||||
versionIntroduced: v1.38
|
||||
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/rcat/ and as part of making a release run "make commanddocs"
|
||||
---
|
||||
|
||||
> **Official documentation:** [https://rclone.org/commands/rclone_rcat/](https://rclone.org/commands/rclone_rcat/)
|
||||
# rclone rcat
|
||||
|
||||
Copies standard input to file on remote.
|
||||
|
||||
## Synopsis
|
||||
|
||||
Reads from standard input (stdin) and copies it to a single remote file.
|
||||
|
||||
```console
|
||||
echo "hello world" | rclone rcat remote:path/to/file
|
||||
ffmpeg - | rclone rcat remote:path/to/file
|
||||
```
|
||||
|
||||
If the remote file already exists, it will be overwritten.
|
||||
|
||||
rcat will try to upload small files in a single request, which is
|
||||
usually more efficient than the streaming/chunked upload endpoints,
|
||||
which use multiple requests. Exact behaviour depends on the remote.
|
||||
What is considered a small file may be set through
|
||||
`--streaming-upload-cutoff`. Uploading only starts after
|
||||
the cutoff is reached or if the file ends before that. The data
|
||||
must fit into RAM. The cutoff needs to be small enough to adhere
|
||||
the limits of your remote, please see there. Generally speaking,
|
||||
setting this cutoff too high will decrease your performance.
|
||||
|
||||
Use the `--size` flag to preallocate the file in advance at the remote end
|
||||
and actually stream it, even if remote backend doesn't support streaming.
|
||||
|
||||
`--size` should be the exact size of the input stream in bytes. If the
|
||||
size of the stream is different in length to the `--size` passed in
|
||||
then the transfer will likely fail.
|
||||
|
||||
Note that the upload cannot be retried because the data is not stored.
|
||||
If the backend supports multipart uploading then individual chunks can
|
||||
be retried. If you need to transfer a lot of data, you may be better
|
||||
off caching it locally and then `rclone move` it to the
|
||||
destination which can use retries.
|
||||
|
||||
```
|
||||
rclone rcat remote:path [flags]
|
||||
```
|
||||
|
||||
## Options
|
||||
|
||||
```
|
||||
-h, --help help for rcat
|
||||
--size int File size hint to preallocate (default -1)
|
||||
```
|
||||
|
||||
Options shared with other commands are described next.
|
||||
See the [global flags page](/flags/) for global options not listed here.
|
||||
|
||||
### Important Options
|
||||
|
||||
Important flags useful for most commands
|
||||
|
||||
```text
|
||||
-n, --dry-run Do a trial run with no permanent changes
|
||||
-i, --interactive Enable interactive mode
|
||||
-v, --verbose count Print lots more stuff (repeat for more)
|
||||
```
|
||||
|
||||
## See Also
|
||||
|
||||
<!-- markdownlint-capture -->
|
||||
<!-- markdownlint-disable ul-style line-length -->
|
||||
|
||||
* [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends.
|
||||
|
||||
|
||||
<!-- markdownlint-restore -->
|
||||
Reference in New Issue
Block a user