ls.md

# Name  
ls - list directory contents or a file attributes

# Synopsis
` ls [OPTION]... <PFSPath>`

# Description

```       
    -R, -r, --recursive
       Copy directories recursively
       
    --page-size (integer) 
    	The number of results to return in each response to a list operation. The default value is 1000 (the maximum allowed). Using a lower value may help if operation time out.
```

# Examples
- The following command lists a single file

```
paddle pfs ls pfs://mydir/text1.txt
```

Output

```
2017-05-5 17:04:30 text1.txt
```

- The following command lists directory contents

```
paddle pfs ls  pfs://mydir
```

Output

```
2017-05-5 17:04:30 text1.txt
2017-05-5 17:04:30 text2.txt
...
```