mirror of
https://github.com/rclone/rclone.git
synced 2026-10-10 06:55:45 -04:00
subomi
9d25ce63a3
Listing a bucket without -R shows each prefix as one directory entry, so the
objects under it are not in the output. This is easy to read as a truncated
listing rather than as one level of a hierarchy.
Fixes #9797
(cherry picked from commit 8c32435bec)
40 lines
1.5 KiB
Go
40 lines
1.5 KiB
Go
// Package lshelp provides common help for list commands.
|
|
package lshelp
|
|
|
|
import (
|
|
"strings"
|
|
)
|
|
|
|
// Help describes the common help for all the list commands
|
|
// Warning! "|" will be replaced by backticks below
|
|
var Help = strings.ReplaceAll(`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.
|
|
|
|
On the bucket-based remotes (e.g. s3, gcs, b2) a directory is a key prefix
|
|
rather than an object, so a listing without |-R| shows each prefix as one
|
|
directory entry and not the objects stored under it.
|
|
|
|
List commands prefer a recursive method that uses more memory but fewer
|
|
transactions by default. Use |--disable ListR| to suppress the behavior.
|
|
See [|--fast-list|](/docs/#fast-list) for more details.
|
|
|
|
Listing a nonexistent directory will produce an error except for
|
|
remotes which can't have empty directories (e.g. s3, swift, or gcs -
|
|
the bucket-based remotes).`, "|", "`")
|