github.com/ncw/rclone@v1.48.1-0.20190724201158-a35aa1360e3e/docs/content/commands/rclone_rcat.md (about)

     1  ---
     2  date: 2019-06-20T16:09:42+01:00
     3  title: "rclone rcat"
     4  slug: rclone_rcat
     5  url: /commands/rclone_rcat/
     6  ---
     7  ## rclone rcat
     8  
     9  Copies standard input to file on remote.
    10  
    11  ### Synopsis
    12  
    13  
    14  rclone rcat reads from standard input (stdin) and copies it to a
    15  single remote file.
    16  
    17      echo "hello world" | rclone rcat remote:path/to/file
    18      ffmpeg - | rclone rcat remote:path/to/file
    19  
    20  If the remote file already exists, it will be overwritten.
    21  
    22  rcat will try to upload small files in a single request, which is
    23  usually more efficient than the streaming/chunked upload endpoints,
    24  which use multiple requests. Exact behaviour depends on the remote.
    25  What is considered a small file may be set through
    26  `--streaming-upload-cutoff`. Uploading only starts after
    27  the cutoff is reached or if the file ends before that. The data
    28  must fit into RAM. The cutoff needs to be small enough to adhere
    29  the limits of your remote, please see there. Generally speaking,
    30  setting this cutoff too high will decrease your performance.
    31  
    32  Note that the upload can also not be retried because the data is
    33  not kept around until the upload succeeds. If you need to transfer
    34  a lot of data, you're better off caching locally and then
    35  `rclone move` it to the destination.
    36  
    37  ```
    38  rclone rcat remote:path [flags]
    39  ```
    40  
    41  ### Options
    42  
    43  ```
    44    -h, --help   help for rcat
    45  ```
    46  
    47  See the [global flags page](/flags/) for global options not listed here.
    48  
    49  ### SEE ALSO
    50  
    51  * [rclone](/commands/rclone/)	 - Show help for rclone commands, flags and backends.
    52