4ee6de5c3e
In f544234 we removed the global flags from each command as it was
making each page very big and causing 1000s of lines of duplication in
the man page.
This change adds a new flags page with all the global flags on and
links each command page to it.
Fixes #3273
64 lines
1.5 KiB
Markdown
64 lines
1.5 KiB
Markdown
---
|
|
date: 2019-06-20T16:09:42+01:00
|
|
title: "rclone ls"
|
|
slug: rclone_ls
|
|
url: /commands/rclone_ls/
|
|
---
|
|
## rclone ls
|
|
|
|
List the objects in the path with size and path.
|
|
|
|
### Synopsis
|
|
|
|
|
|
Lists the objects in the source path to standard output in a human
|
|
readable format with size and path. Recurses by default.
|
|
|
|
Eg
|
|
|
|
$ rclone ls swift:bucket
|
|
60295 bevajer5jef
|
|
90613 canole
|
|
94467 diwogej7
|
|
37600 fubuwic
|
|
|
|
|
|
Any of the filtering options can be applied to this command.
|
|
|
|
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.
|
|
|
|
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.
|
|
|
|
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).
|
|
|
|
|
|
```
|
|
rclone ls remote:path [flags]
|
|
```
|
|
|
|
### Options
|
|
|
|
```
|
|
-h, --help help for ls
|
|
```
|
|
|
|
See the [global flags page](/flags/) for global options not listed here.
|
|
|
|
### SEE ALSO
|
|
|
|
* [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends.
|
|
|