2016-08-03 20:36:28 +00:00
|
|
|
---
|
2019-10-26 10:04:54 +00:00
|
|
|
date: 2019-10-26T11:04:03+01:00
|
2016-08-03 20:36:28 +00:00
|
|
|
title: "rclone ls"
|
|
|
|
|
slug: rclone_ls
|
|
|
|
|
url: /commands/rclone_ls/
|
|
|
|
|
---
|
|
|
|
|
## rclone ls
|
|
|
|
|
|
2018-03-19 10:06:13 +00:00
|
|
|
List the objects in the path with size and path.
|
2016-08-03 20:36:28 +00:00
|
|
|
|
|
|
|
|
### Synopsis
|
|
|
|
|
|
|
|
|
|
|
2018-03-19 10:06:13 +00:00
|
|
|
Lists the objects in the source path to standard output in a human
|
|
|
|
|
readable format with size and path. Recurses by default.
|
|
|
|
|
|
2018-04-28 10:46:27 +00:00
|
|
|
Eg
|
|
|
|
|
|
|
|
|
|
$ rclone ls swift:bucket
|
|
|
|
|
60295 bevajer5jef
|
|
|
|
|
90613 canole
|
|
|
|
|
94467 diwogej7
|
|
|
|
|
37600 fubuwic
|
|
|
|
|
|
|
|
|
|
|
2019-05-10 22:18:45 +00:00
|
|
|
Any of the filtering options can be applied to this command.
|
2018-03-19 10:06:13 +00:00
|
|
|
|
|
|
|
|
There are several related list commands
|
|
|
|
|
|
|
|
|
|
* `ls` to list size and path of objects only
|
|
|
|
|
* `lsl` to list modification time, size and path of objects only
|
|
|
|
|
* `lsd` to list directories only
|
|
|
|
|
* `lsf` to list objects and directories in easy to parse format
|
|
|
|
|
* `lsjson` to list objects and directories in JSON format
|
|
|
|
|
|
|
|
|
|
`ls`,`lsl`,`lsd` are designed to be human readable.
|
|
|
|
|
`lsf` is designed to be human and machine readable.
|
|
|
|
|
`lsjson` is designed to be machine readable.
|
|
|
|
|
|
2018-04-28 10:46:27 +00:00
|
|
|
Note that `ls` and `lsl` recurse by default - use "--max-depth 1" to stop the recursion.
|
|
|
|
|
|
|
|
|
|
The other list commands `lsd`,`lsf`,`lsjson` do not recurse by default - use "-R" to make them recurse.
|
2018-03-19 10:06:13 +00:00
|
|
|
|
2018-04-28 10:46:27 +00:00
|
|
|
Listing a non existent directory will produce an error except for
|
|
|
|
|
remotes which can't have empty directories (eg s3, swift, gcs, etc -
|
|
|
|
|
the bucket based remotes).
|
2018-03-19 10:06:13 +00:00
|
|
|
|
2016-08-03 20:36:28 +00:00
|
|
|
|
|
|
|
|
```
|
2017-09-30 13:19:47 +00:00
|
|
|
rclone ls remote:path [flags]
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Options
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
-h, --help help for ls
|
2016-08-03 20:36:28 +00:00
|
|
|
```
|
|
|
|
|
|
2019-06-20 15:18:02 +00:00
|
|
|
See the [global flags page](/flags/) for global options not listed here.
|
|
|
|
|
|
2016-08-03 20:36:28 +00:00
|
|
|
### SEE ALSO
|
|
|
|
|
|
2018-10-15 10:03:08 +00:00
|
|
|
* [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends.
|
2018-03-19 10:06:13 +00:00
|
|
|
|
