CVT_XLIST_SPECIALUSE(8)

✨ CVT_XLIST_SPECIALUSE ✨

okay so bestie, welcome to cvt_xlist_specialuse — that's the section 8 one, i.e. the sysadmin-commands corner of the Cyrus IMAP docs. she's a little conversion tool and honestly? she ate. 💅

💖 NAME 💖

cvt_xlist_specialuse — Cyrus IMAP documentation

Convert legacy xlist-flag settings to user special-use annotations.

that's the whole job. legacy in, ✨special-use annotations✨ out. no cap.

---

🎀 SYNOPSIS 🎀

cvt_xlist_specialuse [OPTIONS] mailbox...

yes she takes a whole list of mailboxes, plural, go off 👑

---

🌸 DESCRIPTION 🌸

so like, cvt_xlist_specialuse is a tool for converting xlist-flag settings from imapd.conf(5) into user special-use annotations. that's it, that's the vibe. the old settings get translated into the new annotation situation, and you don't have to do it by hand like a medieval peasant. 🧚

---

✨ OPTIONS ✨

• -C config-file — use the specified configuration file config-file instead of the default imapd.conf(5). so if your config is living somewhere non-default, you tell her exactly where. 🫶
• -v, --verbose — produce verbose output. she will talk more. you will know more. iconic behaviour honestly.

---

🌈 EXAMPLES 🌈

cvt_xlist_specialuse user.*

Set special-use annotations for all users (unixhierarchysep: off)

cvt_xlist_specialuse user/*

Set special-use annotations for all users (unixhierarchysep: on)

okay bestie notice how the only difference is . vs / — that's your unixhierarchysep setting flexing. get it wrong and the shell/globbing situation will absolutely humble you. 😭

---

🦋 HISTORY 🦋

the xlist-flag settings hung around for a while in Cyrus IMAP 2.4, for setting special-use style flags for particular folder names (on a server-wide basis, so like, everyone got the same deal). this got deprecated at some point when RFC 6154 showed up and changed the whole game. 💀

the cvt_xlist_specialuse tool was introduced in Cyrus IMAP 3.0 to help administrators upgrading from older deployments where xlist-flag settings had been in use. she's literally the moving-day helper. 🎀

---

💜 FILES 💜

nothing here bestie, the section is just standing there empty, looking cute. 🫶

---

⭐ SEE ALSO ⭐

• imapd.conf(5)

---

👑 AUTHOR 👑

The Cyrus Team

---

💖 COPYRIGHT 💖

1993–2026, The Cyrus Team

---

and that's the whole page, periodt. 🦋✨ this was Cyrus IMAP 3.12.4, dated Sep 09, 2026 — mwah, go convert some legacy flags, you've got this 💅🌸