2017-09-30 21:19:47 +08:00
|
|
|
---
|
|
|
|
title: "rclone rcat"
|
2020-05-16 22:11:55 +08:00
|
|
|
description: "Copies standard input to file on remote."
|
2022-12-21 01:16:14 +08:00
|
|
|
versionIntroduced: v1.38
|
2020-02-10 20:31:45 +08:00
|
|
|
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/rcat/ and as part of making a release run "make commanddocs"
|
2017-09-30 21:19:47 +08:00
|
|
|
---
|
2020-05-22 18:17:37 +08:00
|
|
|
# rclone rcat
|
2017-09-30 21:19:47 +08:00
|
|
|
|
|
|
|
Copies standard input to file on remote.
|
|
|
|
|
2020-05-22 18:17:37 +08:00
|
|
|
## Synopsis
|
2017-09-30 21:19:47 +08:00
|
|
|
|
2024-09-08 23:21:56 +08:00
|
|
|
Reads from standard input (stdin) and copies it to a single remote file.
|
2017-09-30 21:19:47 +08:00
|
|
|
|
|
|
|
echo "hello world" | rclone rcat remote:path/to/file
|
2018-06-17 01:21:09 +08:00
|
|
|
ffmpeg - | rclone rcat remote:path/to/file
|
2017-09-30 21:19:47 +08:00
|
|
|
|
|
|
|
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.
|
|
|
|
|
2022-07-10 01:08:20 +08:00
|
|
|
Use the `--size` flag to preallocate the file in advance at the remote end
|
2021-06-08 23:57:04 +08:00
|
|
|
and actually stream it, even if remote backend doesn't support streaming.
|
|
|
|
|
2022-07-10 01:08:20 +08:00
|
|
|
`--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
|
2021-06-08 23:57:04 +08:00
|
|
|
then the transfer will likely fail.
|
|
|
|
|
2023-06-30 21:11:17 +08:00
|
|
|
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.
|
2017-09-30 21:19:47 +08:00
|
|
|
|
|
|
|
```
|
|
|
|
rclone rcat remote:path [flags]
|
|
|
|
```
|
|
|
|
|
2020-05-22 18:17:37 +08:00
|
|
|
## Options
|
2017-09-30 21:19:47 +08:00
|
|
|
|
|
|
|
```
|
2021-06-08 23:57:04 +08:00
|
|
|
-h, --help help for rcat
|
|
|
|
--size int File size hint to preallocate (default -1)
|
2017-09-30 21:19:47 +08:00
|
|
|
```
|
|
|
|
|
2024-09-08 23:21:56 +08:00
|
|
|
Options shared with other commands are described next.
|
|
|
|
See the [global flags page](/flags/) for global options not listed here.
|
2023-08-02 17:02:38 +08:00
|
|
|
|
2024-09-08 23:21:56 +08:00
|
|
|
### Important Options
|
2023-08-02 17:02:38 +08:00
|
|
|
|
2024-09-08 23:21:56 +08:00
|
|
|
Important flags useful for most commands
|
2023-08-02 17:02:38 +08:00
|
|
|
|
|
|
|
```
|
|
|
|
-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)
|
|
|
|
```
|
|
|
|
|
2024-09-08 23:21:56 +08:00
|
|
|
## See Also
|
2017-09-30 21:19:47 +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
|
|
|
|