Sieve is a programming language that can be used for email filtering. It owes its creation to the CMU Cyrus Project, creators of Cyrus IMAP server.

The language is not tied to any particular operating system or mail architecture. It requires the use of RFC-2822–compliant messages, but otherwise generalizes to other systems that meet these criteria. The current version of Sieve's base specification is outlined in RFC 5228, published in January 2008.

Language

Sieve is a data-driven programming language, similar to earlier email filtering languages such as procmail and maildrop, and earlier line-oriented languages such as sed and AWK: it specifies conditions to match and actions to take on matching. This differs from general-purpose programming languages.

While Sieve has many limitations – the base standard has no variables and no loops – it does allow conditional branching, preventing runaway programs. These limitations generally confine the language to simple filtering operations. Although extensions have been devised to extend the language to include variables and, limited loops, the language is still highly restricted, and thus suitable for running user-devised programs as part of the mail system.

There are also a significant number of restrictions on the grammar of the language, in order to reduce the complexity of parsing the language, but the language also supports the use of multiple methods for comparing localized strings, and is fully Unicode-aware.

While Sieve was originally conceived as tool external to SMTP, RFC precognitively extends it in order to allow rejection at the SMTP protocol level.

Use

The Sieve scripts may be generated by a GUI-based rules editor or they may be entered directly using a text editor.

The scripts are transferred to the mail server in a server-dependent way. The ManageSieve protocol (defined in RFC ) allows users to manage their Sieve scripts on a remote server. Mail servers with local users may allow the scripts to be stored in e.g. a .sieve file in the users' home directories.

History

The language was standardized in the (now-obsolete) RFC of January 2001, by Tim Showalter.

Extensions

The IETF Sieve working group has updated the base specification in 2008 (RFC ), and has brought the following extensions to Proposed Standard status:

  • RFC – Copying without side effects; allows a script to be copied across mailboxes without halting the script.
  • RFC – Body; allows a script to test the body of a message, not just its header.
  • RFC – Environment; provides access to information about the Sieve interpreter and its system environment.
  • RFC – Variables; allows the script to save and retrieve values in variables.
  • RFC – Vacation; specifies an action to send a response informing the sender that the recipient may be away.
  • RFC – Relational tests; defines numeric tests, so that a script may test a field for a numeric value, and may test against the number of occurrences of a field.
  • RFC – IMAP4flags; allows a script to test and set a message's IMAP flags.
  • RFC – Subaddress; allows a script to test subaddresses of the form "user+detail@domain.example".
  • RFC – Spamtest and Virustest; allows a script to interface with implementation
  • RFC – Date and Index Extensions.
  • RFC – Editheader; allows a script to add and delete message header fields.
  • RFC – Reject; allows messages to be rejected at either the LMTP/SMTP level or with an MDN or DSN.
  • RFC – Notifications; allows a script to trigger external notifications of email.
  • RFC – Notifications; allows notifications to be sent via the mailto protocol
  • RFC – XMPP notifications; specifies notifications via XMPP.
  • RFC – Checking; Mailbox status and accessing mailbox metadata.
  • RFC – MIME Part Tests, Iteration, Extraction, Replacement, and Enclosure
  • RFC – A Protocol for Remotely Managing Sieve Scripts
  • RFC – Vacation; adds the ability to specify seconds in a vacation time period.
  • RFC – MIME part conversion; allows a script to convert body parts between MIME types.
  • RFC – Script inclusion; allow a user to include one script inside another.
  • RFC - Detecting Duplicate Deliveries; allows a script to detect duplicate messages and define custom behavior in those cases.

Example

This is an example sieve script:

See also

External links