---
title: ls
layout: command
version: 0.59.1
---

List the files in a directory.

## Signature

```> ls (pattern) --all --long --short-names --full-paths --du```

## Parameters

 -  `pattern`: the glob pattern to use
 -  `--all`: Show hidden files
 -  `--long`: List all available columns for each entry
 -  `--short-names`: Only print the file names and not the path
 -  `--full-paths`: display paths as absolute paths
 -  `--du`: Display the apparent directory size in place of the directory metadata size

## Examples

List all files in the current directory
```shell
> ls
```

List all files in a subdirectory
```shell
> ls subdir
```

List all rust files
```shell
> ls *.rs
```

List all files and directories whose name do not contain 'bar'
```shell
> ls -s | where name !~ bar
```

List all dirs with full path name in your home directory
```shell
> ls -f ~ | where type == dir
```

List all dirs in your home directory which have not been modified in 7 days
```shell
> ls -s ~ | where type == dir && modified < ((date now) - 7day)
```