SIEVESHELL(1)

📦
version 3.12.4 · 16 versions
, in fedora 44

💖 SIEVESHELL(1) 💖

okay bestie, welcome to sieveshell — this is the Cyrus IMAP corner of the manual-verse, and this page is literally your remote-sieve-script-manipulation era. no cap.

✨ NAME ✨

sieveshell — Cyrus IMAP documentation, and fr fr the way that it remotely manipulates your sieve scripts. that's the whole vibe. 🎀

🌸 SYNOPSIS 🌸

sieveshell [--user=user] [--authname=authname] [--realm=realm]
[--password=password] [--exec=script] [--execfile=file] server[:port]

sieveshell --help

like, either you're out here sieving, or you're just asking for --help. both are valid. 💅

🦋 DESCRIPTION 🦋

so the tea is: sieveshell lets users manipulate their scripts on a remote server. it works via MANAGESIEVE, which is, and I quote, a work in progress. so like… she's growing. give her grace. 🙈

these are the commands she recognizes, and yes you need to know all of them:

  • list — list scripts on server.
  • put <filename> — upload script to server.
  • get <name> [<filename>] — get script. if no filename display to stdout
  • delete <name> — delete script.
  • activate <name> — activate script.
  • deactivate — deactivate all scripts.

💅 OPTIONS 💅

  • -u user, --user=user — the user whose mailboxes you wanna work on. if you don't say anything, it just uses the same as -a. she's a copycat, but make it convenient. 🫶
  • -a authname, --authname=authname — the user to use for authentication. if you don't specify it, it defaults to the current login user. default behavior ate, honestly. ✨
  • -r realm, --realm=realm — the realm to attempt authentication in. yeah, we're going into the realm. very fantasy-coded of you. 🧚
  • -p password, --password=password — the password to use when authenticating to server. ⚠️ note that this parameter can be seen in the process list. use with caution! like bestie I am BEGGING you, be careful with this one. 😭
🚨 real talk: -p puts your password somewhere other people can see it. the manpage says "use with caution!" and the manpage is not being dramatic, I'm being dramatic, and we're both right.
  • -e script, --exec=script — instead of working interactively, run commands from script, and exit when done. main character energy, no small talk. 🔥
  • -f file, --execfile=file — instead of working interactively, run commands from file file and exit when done. same energy, different delivery method. 💜

🌈 REFERENCES 🌈

[MANAGESIEVE] Martin, T.; "A Protocol for Remotely Managing Sieve Scripts", RFC 5804; May 2001

👑 AUTHOR 👑

Tim Martin <tmartin@mirapoint.com>, and the rest of the Cyrus team.

👑 AUTHOR 👑

The Cyrus Team

1993–2026, The Cyrus Team

and that's the whole page, bestie. 💖 this one's version 3.12.4, dated Sep 09, 2026, and it came to you straight from the Cyrus IMAP era. go forth and sieve. slay. 🌸🦋✨

📦 where this page comes from