github.com/10XDev/rclone@v1.52.3-0.20200626220027-16af9ab76b2a/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  # autogenerated - DO NOT EDIT, instead edit the source code in cmd/ls/ and as part of making a release run "make commanddocs"
     7  ---
     8  # rclone ls
     9  
    10  List the objects in the path with size and path.
    11  
    12  ## Synopsis
    13  
    14  
    15  Lists the objects in the source path to standard output in a human
    16  readable format with size and path. Recurses by default.
    17  
    18  Eg
    19  
    20      $ rclone ls swift:bucket
    21          60295 bevajer5jef
    22          90613 canole
    23          94467 diwogej7
    24          37600 fubuwic
    25  
    26  
    27  Any of the filtering options can be applied to this command.
    28  
    29  There are several related list commands
    30  
    31    * `ls` to list size and path of objects only
    32    * `lsl` to list modification time, size and path of objects only
    33    * `lsd` to list directories only
    34    * `lsf` to list objects and directories in easy to parse format
    35    * `lsjson` to list objects and directories in JSON format
    36  
    37  `ls`,`lsl`,`lsd` are designed to be human readable.
    38  `lsf` is designed to be human and machine readable.
    39  `lsjson` is designed to be machine readable.
    40  
    41  Note that `ls` and `lsl` recurse by default - use "--max-depth 1" to stop the recursion.
    42  
    43  The other list commands `lsd`,`lsf`,`lsjson` do not recurse by default - use "-R" to make them recurse.
    44  
    45  Listing a non existent directory will produce an error except for
    46  remotes which can't have empty directories (eg s3, swift, gcs, etc -
    47  the bucket based remotes).
    48  
    49  
    50  ```
    51  rclone ls remote:path [flags]
    52  ```
    53  
    54  ## Options
    55  
    56  ```
    57    -h, --help   help for ls
    58  ```
    59  
    60  See the [global flags page](/flags/) for global options not listed here.
    61  
    62  ## SEE ALSO
    63  
    64  * [rclone](/commands/rclone/)	 - Show help for rclone commands, flags and backends.
    65