rclone/docs/content/commands/rclone_cat.md

57 lines
1.5 KiB
Markdown
Raw Normal View History

2016-10-04 12:30:48 +02:00
---
title: "rclone cat"
description: "Concatenates any files and sends them to stdout."
2016-10-04 12:30:48 +02:00
slug: rclone_cat
url: /commands/rclone_cat/
2022-12-20 18:16:14 +01:00
versionIntroduced: v1.33
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/cat/ and as part of making a release run "make commanddocs"
2016-10-04 12:30:48 +02:00
---
# rclone cat
2016-10-04 12:30:48 +02:00
Concatenates any files and sends them to stdout.
## Synopsis
2016-10-04 12:30:48 +02:00
rclone cat sends any files to standard output.
You can use it like this to output a single file
rclone cat remote:path/to/file
Or like this to output any file in dir or its subdirectories.
2016-10-04 12:30:48 +02:00
rclone cat remote:path/to/dir
Or like this to output any .txt files in dir or its subdirectories.
2016-10-04 12:30:48 +02:00
rclone --include "*.txt" cat remote:path/to/dir
2021-02-02 14:42:35 +01:00
Use the `--head` flag to print characters only at the start, `--tail` for
the end and `--offset` and `--count` to print a section in the middle.
2017-03-18 12:16:43 +01:00
Note that if offset is negative it will count from the end, so
2021-02-02 14:42:35 +01:00
`--offset -1 --count 1` is equivalent to `--tail 1`.
2017-03-18 12:16:43 +01:00
2016-10-04 12:30:48 +02:00
```
rclone cat remote:path [flags]
2016-10-04 12:30:48 +02:00
```
## Options
2017-03-18 12:16:43 +01:00
```
2021-11-01 16:42:05 +01:00
--count int Only print N characters (default -1)
--discard Discard the output instead of printing
--head int Only print the first N characters
2017-09-30 15:19:47 +02:00
-h, --help help for cat
2021-11-01 16:42:05 +01:00
--offset int Start printing at offset N (or from end if -ve)
--tail int Only print the last N characters
2017-03-18 12:16:43 +01:00
```
See the [global flags page](/flags/) for global options not listed here.
## SEE ALSO
2016-10-04 12:30:48 +02:00
2018-10-15 12:03:08 +02:00
* [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends.
2018-03-19 11:06:13 +01:00