CTL_ZONEINFO(8)

📦
version 3.12.3 · 5 versions
, in ubuntu stonking

💖 CTL_ZONEINFO 💖

okay bestie, this is the manual page for ctl_zoneinfo, part of the Cyrus IMAP docs 🎀 and it's literally here to help you perform operations on the zoneinfo database. yes that zoneinfo. the timezone one. we're doing timezone admin today and we're gonna slay it ✨

✨ SYNOPSIS ✨

ctl_zoneinfo [ -C config-file ] [ -v ] -r version-string

ctl_zoneinfo [ -C config-file ] [ -v ] -w file

🌸 DESCRIPTION 🌸

so ctl_zoneinfo is the little icon we use to do various administrative operations on the zoneinfo database. shrug, it's a job, somebody's gotta do it 💅

and here's the tea: ctl_zoneinfo pulls its configuration options out of the imapd.conf(5) file, unless you tell it otherwise with -C. like, mind your business please 🙈

🦋 OPTIONS 🦋

  • -C config-file — bestie, use THIS config file (config-file) instead of the default imapd.conf(5). go off.
  • -v, --verbose — turn on verbose output. she's chatty now. she's telling you everything. main character energy 💬✨
  • -r version-string, --rebuild=version-string — rebuild the zoneinfo database, based on the directory structure of configdirectory/zoneinfo. 🛠️

the database getting rebuilt will live in the default location of configdirectory/zoneinfo.db — unless you specified otherwise with the zoneinfo_db_path option in imapd.conf(5), which, fair.

the version-string should describe where the timezone data came from (like, for example, "Olson:2020a") and it gets used by the tzdist module of httpd(8). periodt.

⚠️ heads up: the version-string must contain a colon between the description and the version. no colon, no service. the colon is non-negotiable 💀
  • -w file, --windows-zone-xml=file — reads Windows Zone XML file. that's it, that's the whole vibe 🪟📄

💀 EXAMPLES 💀

[NB: Examples needed]

(not me leaving the examples section like this 😭 the manpage literally says examples are needed, okay, it's a whole mood, we're all works in progress fr fr)

👑 HISTORY 👑

this command was introduced in version 2.5. so she's an elder. a legend. respect her 🌈⭐

🎀 FILES 🎀

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

🔥 SEE ALSO 🔥

iykyk, go read those next, they're all bangers 🫶

💜 AUTHOR 💜

The Cyrus Team, Nic Bernstein (Onlight) — kings, icons, legends, no cap 👑

1993–2026, The Cyrus Team

and that's the whole page bestie!! 🎉 this was Cyrus IMAP version 3.12.3, dropped on Jul 15, 2026, and it's CTL_ZONEINFO(8) for life. now go rebuild that zoneinfo database and be iconic about it 💅💖✨🦋🌸

📦 where this page comes from