github.com/rclone/rclone@v1.66.1-0.20240517100346-7b89735ae726/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  groups: Important
     7  versionIntroduced: v1.38
     8  # autogenerated - DO NOT EDIT, instead edit the source code in cmd/rcat/ and as part of making a release run "make commanddocs"
     9  ---
    10  # rclone rcat
    11  
    12  Copies standard input to file on remote.
    13  
    14  ## Synopsis
    15  
    16  
    17  rclone rcat reads from standard input (stdin) and copies it to a
    18  single remote file.
    19  
    20      echo "hello world" | rclone rcat remote:path/to/file
    21      ffmpeg - | rclone rcat remote:path/to/file
    22  
    23  If the remote file already exists, it will be overwritten.
    24  
    25  rcat will try to upload small files in a single request, which is
    26  usually more efficient than the streaming/chunked upload endpoints,
    27  which use multiple requests. Exact behaviour depends on the remote.
    28  What is considered a small file may be set through
    29  `--streaming-upload-cutoff`. Uploading only starts after
    30  the cutoff is reached or if the file ends before that. The data
    31  must fit into RAM. The cutoff needs to be small enough to adhere
    32  the limits of your remote, please see there. Generally speaking,
    33  setting this cutoff too high will decrease your performance.
    34  
    35  Use the `--size` flag to preallocate the file in advance at the remote end
    36  and actually stream it, even if remote backend doesn't support streaming.
    37  
    38  `--size` should be the exact size of the input stream in bytes. If the
    39  size of the stream is different in length to the `--size` passed in
    40  then the transfer will likely fail.
    41  
    42  Note that the upload cannot be retried because the data is not stored.
    43  If the backend supports multipart uploading then individual chunks can
    44  be retried. If you need to transfer a lot of data, you may be better
    45  off caching it locally and then `rclone move` it to the
    46  destination which can use retries.
    47  
    48  ```
    49  rclone rcat remote:path [flags]
    50  ```
    51  
    52  ## Options
    53  
    54  ```
    55    -h, --help       help for rcat
    56        --size int   File size hint to preallocate (default -1)
    57  ```
    58  
    59  
    60  ## Important Options
    61  
    62  Important flags useful for most commands.
    63  
    64  ```
    65    -n, --dry-run         Do a trial run with no permanent changes
    66    -i, --interactive     Enable interactive mode
    67    -v, --verbose count   Print lots more stuff (repeat for more)
    68  ```
    69  
    70  See the [global flags page](/flags/) for global options not listed here.
    71  
    72  # SEE ALSO
    73  
    74  * [rclone](/commands/rclone/)	 - Show help for rclone commands, flags and backends.
    75