github.com/10XDev/rclone@v1.52.3-0.20200626220027-16af9ab76b2a/docs/content/commands/rclone_rcat.md (about)

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