rclone/docs/content/commands/rclone_lsd.md

77 lines
2.3 KiB
Markdown
Raw Normal View History

---
title: "rclone lsd"
description: "List all directories/containers/buckets in the path."
slug: rclone_lsd
url: /commands/rclone_lsd/
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/lsd/ and as part of making a release run "make commanddocs"
---
# rclone lsd
List all directories/containers/buckets in the path.
## Synopsis
2018-04-28 10:46:27 +00:00
Lists the directories in the source path to standard output. Does not
2022-07-09 17:08:20 +00:00
recurse by default. Use the `-R` flag to recurse.
2018-04-28 10:46:27 +00:00
This command lists the total size of the directory (if known, -1 if
not), the modification time (if known, the current time if not), the
number of objects in the directory (if known, -1 if not) and the name
of the directory, Eg
$ rclone lsd swift:
494000 2018-04-26 08:43:20 10000 10000files
65 2018-04-26 08:43:20 1 1File
Or
$ rclone lsd drive:test
-1 2016-10-17 17:41:53 -1 1000files
-1 2017-01-03 14:40:54 -1 2500files
-1 2017-07-08 14:39:28 -1 4000files
2022-07-09 17:08:20 +00:00
If you just want the directory names use `rclone lsf --dirs-only`.
2018-04-28 10:46:27 +00:00
2018-03-19 10:06:13 +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
2022-03-18 12:29:54 +00:00
`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-03-19 10:06:13 +00:00
2021-02-02 13:42:35 +00:00
Note that `ls` and `lsl` recurse by default - use `--max-depth 1` to stop the recursion.
2018-04-28 10:46:27 +00:00
2021-02-02 13:42:35 +00:00
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
2022-10-21 14:06:08 +00:00
Listing a nonexistent directory will produce an error except for
2021-02-02 13:42:35 +00:00
remotes which can't have empty directories (e.g. s3, swift, or gcs -
2022-03-18 12:29:54 +00:00
the bucket-based remotes).
2018-03-19 10:06:13 +00:00
```
2017-09-30 13:19:47 +00:00
rclone lsd remote:path [flags]
```
## Options
2017-09-30 13:19:47 +00:00
```
2018-04-28 10:46:27 +00:00
-h, --help help for lsd
2021-11-01 15:42:05 +00:00
-R, --recursive Recurse into the listing
```
See the [global flags page](/flags/) for global options not listed here.
## 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