CVT_XLIST_SPECIALUSE(8)

📦
version 3.12.3 · 4 versions
, in ubuntu stonking

💖 CVT_XLIST_SPECIALUSE 💖

okay bestie, welcome to cvt_xlist_specialuse — it's section 8 of the manual, straight out of Cyrus IMAP documentation, and it is literally here to rescue you from legacy settings. no cap. 🦋

✨ NAME ✨

cvt_xlist_specialuse — Cyrus IMAP documentation

the whole assignment? convert legacy xlist-flag settings to user special-use annotations. that's it, that's the job, and it slays at it. 👑

🌸 SYNOPSIS 🌸

cvt_xlist_specialuse [OPTIONS] mailbox...

periodt. you give it some mailbox... args, it does the thing. 💅

🎀 DESCRIPTION 🎀

so like, cvt_xlist_specialuse is a tool for converting xlist-flag settings from imapd.conf(5) over to user special-use annotations. that's the vibe. it takes your old-school config-file flags and translates them into the annotation format everyone uses now. glow-up complete. ✨

🫶 OPTIONS 🫶

  • -C config-file — use the specified configuration file config-file instead of the default imapd.conf(5). lowkey handy when your config isn't living at the usual address. 🏠
  • -v, --verbose — produce verbose output. she will not shut up (affectionate) and honestly? we love that for her. 🗣️💖

🌈 EXAMPLES 🌈

not me about to give you the receipts 📸
cvt_xlist_specialuse user.*

set special-use annotations for all users — and this is with unixhierarchysep: off, iykyk.

cvt_xlist_specialuse user/*

set special-use annotations for all users — this one is with unixhierarchysep: on.

see how the separator flips between . and /? that's the whole difference, bestie. one character. iconic. 💅

⭐ HISTORY ⭐

storytime 🧚:

the xlist-flag settings existed for a while in Cyrus IMAP 2.4, and they were for setting special-use style flags for particular folder names — and this was on a server-wide basis, for the record.

it got deprecated at some point, and the reason was the introduction of RFC 6154. rip to a real one. 💀

then cvt_xlist_specialuse herself was introduced in Cyrus IMAP 3.0 to aid administrators in upgrading from older deployments where xlist-flag settings had been in use. she was born to help you move on. main character energy fr fr. 👑

🌸 FILES 🌸

...okay this section is literally empty in the original. nothing here. silence. a whole vibe check with no vibes. 🙈

💜 SEE ALSO 💜

go read that one, she's the config bestie. 🫶

🦋 AUTHOR 🦋

The Cyrus Team — the whole squad. no gatekeeping. 💖

1993–2026, The Cyrus Team

and that's a wrap, bestie!! 🎀 this lil' page is version 3.12.3, dated Jul 15, 2026, and it's CVT_XLIST_SPECIALUSE(8) in the Cyrus IMAP manuals. now go convert those flags, you absolute legend. 🦋✨

📦 where this page comes from