---
name: "cyrus-cyr_ls"
section: "8"
platform: "linux"
package: "cyrus-common"
version: "3.10.2-1+deb13u2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cyrus-cyr_ls"
---

# cyrus-cyr\_ls(8)

Cyrus IMAP documentation List Cyrus mailbox directory contents

## NAME

cyr\_ls - Cyrus IMAP documentation

List Cyrus mailbox directory contents

## SYNOPSIS

```
cyr_ls [ -C config-file ] [ -l ] [ -m ] [ -R ] [ -1 ] [ mailbox-name ]
```

## DESCRIPTION

*List information about the directory corresponding to the given* *mailbox name (the current directory by default)*

**cyr\_ls** *reads its configuration options out of the [imapd.conf(5)](/imapd.conf/5.md) file unless specified otherwise by* **-C***. It uses \<configdirectory\>/mailboxes.db* *to locate the mailboxes on disk.*

## OPTIONS

- **-C config-file**

  *Use the specified configuration file config-file rather than the default [imapd.conf(5)](/imapd.conf/5.md).*

- **-l, --long**

  *Use a long listing format.*

- **-m, --metadata**

  *Output the path to the metadata files (if different from the* *message files).*

- **-R, --recursive**

  *List submailboxes recursively.*

- **-1, --one-per-line**

  *List one file per line.*

## EXAMPLES

```
cyr_ls user/jsmith
```

*Display the directory contents for mailbox user/jsmith.*

## FILES

*/etc/imapd.conf,* *\<configdirectory\>/mailboxes.db*

## SEE ALSO

*[imapd.conf(5)](/imapd.conf/5.md)*

## AUTHOR

*The Cyrus Team, Ken Murchison (Fastmail)*

## COPYRIGHT

*1993–2025, The Cyrus Team*