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

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