cyr_ls(8)
| CYR_LS(8) | Cyrus IMAP | CYR_LS(8) |
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) <#std-cyrusman-imapd.conf-5> 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) <#std-cyrusman-imapd.conf-5>.
- -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) <#std-cyrusman-imapd.conf-5>
Author
The Cyrus Team, Ken Murchison (Fastmail)
Copyright
1993–2026, The Cyrus Team
| August 18, 2026 | 3.8.7 |