github.com/artpar/rclone@v1.67.3/docs/content/commands/rclone_lsd.md (about)

     1  ---
     2  title: "rclone lsd"
     3  description: "List all directories/containers/buckets in the path."
     4  slug: rclone_lsd
     5  url: /commands/rclone_lsd/
     6  groups: Filter,Listing
     7  # autogenerated - DO NOT EDIT, instead edit the source code in cmd/lsd/ and as part of making a release run "make commanddocs"
     8  ---
     9  # rclone lsd
    10  
    11  List all directories/containers/buckets in the path.
    12  
    13  ## Synopsis
    14  
    15  
    16  Lists the directories in the source path to standard output. Does not
    17  recurse by default.  Use the `-R` flag to recurse.
    18  
    19  This command lists the total size of the directory (if known, -1 if
    20  not), the modification time (if known, the current time if not), the
    21  number of objects in the directory (if known, -1 if not) and the name
    22  of the directory, Eg
    23  
    24      $ rclone lsd swift:
    25            494000 2018-04-26 08:43:20     10000 10000files
    26                65 2018-04-26 08:43:20         1 1File
    27  
    28  Or
    29  
    30      $ rclone lsd drive:test
    31                -1 2016-10-17 17:41:53        -1 1000files
    32                -1 2017-01-03 14:40:54        -1 2500files
    33                -1 2017-07-08 14:39:28        -1 4000files
    34  
    35  If you just want the directory names use `rclone lsf --dirs-only`.
    36  
    37  
    38  Any of the filtering options can be applied to this command.
    39  
    40  There are several related list commands
    41  
    42    * `ls` to list size and path of objects only
    43    * `lsl` to list modification time, size and path of objects only
    44    * `lsd` to list directories only
    45    * `lsf` to list objects and directories in easy to parse format
    46    * `lsjson` to list objects and directories in JSON format
    47  
    48  `ls`,`lsl`,`lsd` are designed to be human-readable.
    49  `lsf` is designed to be human and machine-readable.
    50  `lsjson` is designed to be machine-readable.
    51  
    52  Note that `ls` and `lsl` recurse by default - use `--max-depth 1` to stop the recursion.
    53  
    54  The other list commands `lsd`,`lsf`,`lsjson` do not recurse by default - use `-R` to make them recurse.
    55  
    56  Listing a nonexistent directory will produce an error except for
    57  remotes which can't have empty directories (e.g. s3, swift, or gcs -
    58  the bucket-based remotes).
    59  
    60  
    61  ```
    62  rclone lsd remote:path [flags]
    63  ```
    64  
    65  ## Options
    66  
    67  ```
    68    -h, --help        help for lsd
    69    -R, --recursive   Recurse into the listing
    70  ```
    71  
    72  
    73  ## Filter Options
    74  
    75  Flags for filtering directory listings.
    76  
    77  ```
    78        --delete-excluded                     Delete files on dest excluded from sync
    79        --exclude stringArray                 Exclude files matching pattern
    80        --exclude-from stringArray            Read file exclude patterns from file (use - to read from stdin)
    81        --exclude-if-present stringArray      Exclude directories if filename is present
    82        --files-from stringArray              Read list of source-file names from file (use - to read from stdin)
    83        --files-from-raw stringArray          Read list of source-file names from file without any processing of lines (use - to read from stdin)
    84    -f, --filter stringArray                  Add a file filtering rule
    85        --filter-from stringArray             Read file filtering patterns from a file (use - to read from stdin)
    86        --ignore-case                         Ignore case in filters (case insensitive)
    87        --include stringArray                 Include files matching pattern
    88        --include-from stringArray            Read file include patterns from file (use - to read from stdin)
    89        --max-age Duration                    Only transfer files younger than this in s or suffix ms|s|m|h|d|w|M|y (default off)
    90        --max-depth int                       If set limits the recursion depth to this (default -1)
    91        --max-size SizeSuffix                 Only transfer files smaller than this in KiB or suffix B|K|M|G|T|P (default off)
    92        --metadata-exclude stringArray        Exclude metadatas matching pattern
    93        --metadata-exclude-from stringArray   Read metadata exclude patterns from file (use - to read from stdin)
    94        --metadata-filter stringArray         Add a metadata filtering rule
    95        --metadata-filter-from stringArray    Read metadata filtering patterns from a file (use - to read from stdin)
    96        --metadata-include stringArray        Include metadatas matching pattern
    97        --metadata-include-from stringArray   Read metadata include patterns from file (use - to read from stdin)
    98        --min-age Duration                    Only transfer files older than this in s or suffix ms|s|m|h|d|w|M|y (default off)
    99        --min-size SizeSuffix                 Only transfer files bigger than this in KiB or suffix B|K|M|G|T|P (default off)
   100  ```
   101  
   102  ## Listing Options
   103  
   104  Flags for listing directories.
   105  
   106  ```
   107        --default-time Time   Time to show if modtime is unknown for files and directories (default 2000-01-01T00:00:00Z)
   108        --fast-list           Use recursive list if available; uses more memory but fewer transactions
   109  ```
   110  
   111  See the [global flags page](/flags/) for global options not listed here.
   112  
   113  # SEE ALSO
   114  
   115  * [rclone](/commands/rclone/)	 - Show help for rclone commands, flags and backends.
   116