CYR_LS(8)

📦
version 3.12.3 · 4 versions
, in ubuntu stonking

💅 CYR_LS(8) — bestie edition ✨

okay so this is cyr_ls, a Cyrus IMAP girly (section 8, system admin tools, very serious business 🎀). she lists what's inside a Cyrus mailbox directory. that's it, that's the whole job, and she eats every time 💖

🌸 NAME 🌸

cyr_ls — Cyrus IMAP documentation

like, literally just: list Cyrus mailbox directory contents 🦋

✨ SYNOPSIS ✨

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

look at her. so many little flags. so much power 💅

💖 DESCRIPTION 💖

she lists info about the directory that corresponds to whatever mailbox name you handed her. and if you hand her nothing? she just does the current directory, no big deal, lowkey iconic.

and here's the thing bestie — cyr_ls reads her config options out of the imapd.conf(5) file, unless you tell her otherwise with -C. she never guesses. she uses <configdirectory>/mailboxes.db to locate the mailboxes on disk. that's her whole map, fr fr 🗺️✨

👑 OPTIONS 👑

  • -C config-file — use this specific config file config-file instead of the default imapd.conf(5). like, "no thanks, i brought my own settings" 🫶
  • -l, --long — gives you the long listing format. the full fit. the whole outfit, not just the top 🎀
  • -m, --metadata — outputs the path to the metadata files, but only if they're different from the message files. so like, if your meta and your messages are in the same place, she won't even bother mentioning it 🙈
  • -R, --recursive — lists submailboxes recursively. all the way down. she will not stop. she has main character energy and she's going deep 💀
  • -1, --one-per-line — one file per line. neat. tidy. readable. slay ⭐

🌈 EXAMPLES 🌈

cyr_ls user/jsmith

Display the directory contents for mailbox user/jsmith.

see? one line and she's already doing the most. obsessed 😭💜

🍓 FILES 🍓

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

these are the spots she hangs out at 🧚

🔥 SEE ALSO 🔥

(go read the config page, iykyk)

🌸 AUTHOR 🌸

The Cyrus Team, Ken Murchison (Fastmail)

the icons themselves. periodt 👑

1993–2026, The Cyrus Team

no cap, this is the real deal — Cyrus IMAP 3.12.3, dated Jul 15, 2026. that's the version, that's the date, that's the whole vibe check, and CYR_LS(8) ate and left no crumbs 💅✨🦋
📦 where this page comes from