CYR_LS(8)

📦
version 3.12.4 · 5 versions
, in fedora 44

✨ NAME ✨

okay bestie, welcome to cyr_ls — it's part of the Cyrus IMAP manual pages (that's the CYR_LS(8) situation, section 8, admin commands, iykyk) and it does exactly one iconic thing: it lists the contents of a Cyrus mailbox directory. that's it. that's the girl. 🎀

🌸 SYNOPSIS 🌸

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

💖 DESCRIPTION 💖

so basically, cyr_ls lists info about the directory that corresponds to the mailbox name you give it. no mailbox name? it just does the current directory by default. lowkey cozy.

now here's the tea: cyr_ls reads its config options out of the imapd.conf(5) file — unless you tell it otherwise with -C. and to actually find where your mailboxes live on disk, it uses <configdirectory>/mailboxes.db. it's giving librarian energy fr fr 📚

💅 OPTIONS 💅

  • -C config-file — use this specific config-file instead of the default imapd.conf(5). main character move, choose your own config.
  • -l, --long — long listing format. the verbose serve. ✨
  • -m, --metadata — outputs the path to the metadata files — but only if they're different from the message files. sneaky little detail, love that for us.
  • -R, --recursive — lists submailboxes recursively. it goes deeper. and deeper. obsessed. 🌀
  • -1, --one-per-line — one file per line. clean, tidy, no clutter. slay.

🦋 EXAMPLES 🦋

cyr_ls user/jsmith

displays the directory contents for mailbox user/jsmith. that's it bestie, that's the whole vibe. 🫶

🎀 FILES 🎀

  • /etc/imapd.conf
  • <configdirectory>/mailboxes.db

🌈 SEE ALSO 🌈

👑 AUTHOR 👑

the Cyrus Team, plus Ken Murchison (Fastmail). legends only, no cap. 💜

1993–2026, The Cyrus Team. all rights reserved, periodt.

and that's the whole page!! 💖 this was Cyrus IMAP version 3.12.4, dated Sep 09, 2026 — so if you're reading this in the future, hey, hi, you're valid. go list some mailboxes, bestie. cyr_ls and chill. 🧚✨

📦 where this page comes from