rclone/docs/content/commands/rclone_lsl.md

107 lines
4.4 KiB
Markdown
Raw Normal View History

---
title: "rclone lsl"
description: "List the objects in path with modification time, size and path."
slug: rclone_lsl
url: /commands/rclone_lsl/
2023-08-02 19:02:38 +10:00
groups: Filter,Listing
2022-12-21 04:16:14 +11:00
versionIntroduced: v1.02
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/lsl/ and as part of making a release run "make commanddocs"
---
# rclone lsl
2018-03-19 21:06:13 +11:00
List the objects in path with modification time, size and path.
## Synopsis
2018-03-19 21:06:13 +11:00
Lists the objects in the source path to standard output in a human
readable format with modification time, size and path. Recurses by default.
2018-04-28 20:46:27 +10:00
Eg
$ rclone lsl swift:bucket
60295 2016-06-25 18:55:41.062626927 bevajer5jef
90613 2016-06-25 18:55:43.302607074 canole
94467 2016-06-25 18:55:43.046609333 diwogej7
37600 2016-06-25 18:55:40.814629136 fubuwic
Any of the filtering options can be applied to this command.
2018-03-19 21:06:13 +11: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 23:29:54 +11: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 21:06:13 +11:00
2021-02-03 00:42:35 +11:00
Note that `ls` and `lsl` recurse by default - use `--max-depth 1` to stop the recursion.
2018-04-28 20:46:27 +10:00
2021-02-03 00:42:35 +11:00
The other list commands `lsd`,`lsf`,`lsjson` do not recurse by default - use `-R` to make them recurse.
2018-03-19 21:06:13 +11:00
2022-10-22 01:06:08 +11:00
Listing a nonexistent directory will produce an error except for
2021-02-03 00:42:35 +11:00
remotes which can't have empty directories (e.g. s3, swift, or gcs -
2022-03-18 23:29:54 +11:00
the bucket-based remotes).
2018-03-19 21:06:13 +11:00
```
2017-09-30 23:19:47 +10:00
rclone lsl remote:path [flags]
```
## Options
2017-09-30 23:19:47 +10:00
```
-h, --help help for lsl
```
2023-08-02 19:02:38 +10:00
## Filter Options
Flags for filtering directory listings.
```
--delete-excluded Delete files on dest excluded from sync
--exclude stringArray Exclude files matching pattern
--exclude-from stringArray Read file exclude patterns from file (use - to read from stdin)
--exclude-if-present stringArray Exclude directories if filename is present
--files-from stringArray Read list of source-file names from file (use - to read from stdin)
--files-from-raw stringArray Read list of source-file names from file without any processing of lines (use - to read from stdin)
-f, --filter stringArray Add a file filtering rule
--filter-from stringArray Read file filtering patterns from a file (use - to read from stdin)
--ignore-case Ignore case in filters (case insensitive)
--include stringArray Include files matching pattern
--include-from stringArray Read file include patterns from file (use - to read from stdin)
--max-age Duration Only transfer files younger than this in s or suffix ms|s|m|h|d|w|M|y (default off)
--max-depth int If set limits the recursion depth to this (default -1)
--max-size SizeSuffix Only transfer files smaller than this in KiB or suffix B|K|M|G|T|P (default off)
--metadata-exclude stringArray Exclude metadatas matching pattern
--metadata-exclude-from stringArray Read metadata exclude patterns from file (use - to read from stdin)
--metadata-filter stringArray Add a metadata filtering rule
--metadata-filter-from stringArray Read metadata filtering patterns from a file (use - to read from stdin)
--metadata-include stringArray Include metadatas matching pattern
--metadata-include-from stringArray Read metadata include patterns from file (use - to read from stdin)
--min-age Duration Only transfer files older than this in s or suffix ms|s|m|h|d|w|M|y (default off)
--min-size SizeSuffix Only transfer files bigger than this in KiB or suffix B|K|M|G|T|P (default off)
```
## Listing Options
Flags for listing directories.
```
--default-time Time Time to show if modtime is unknown for files and directories (default 2000-01-01T00:00:00Z)
--fast-list Use recursive list if available; uses more memory but fewer transactions
```
See the [global flags page](/flags/) for global options not listed here.
2023-08-02 19:02:38 +10:00
# SEE ALSO
2018-10-15 21:03:08 +11:00
* [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends.
2018-03-19 21:06:13 +11:00