Skip to content
Snippets Groups Projects
Commit 9e93a502 authored by Stephan Bosch's avatar Stephan Bosch
Browse files

Fixed the document name of the vnd.dovecot.environment specification.

parent 3a29a267
No related branches found
No related tags found
No related merge requests found
Pigeonhole Project S. Bosch
September 23, 2015
S. Bosch
Sieve Email Filtering: Logging Debug Messages
January 17, 2016
Sieve Email Filtering: Dovecot Environment Extension
spec-bosch-sieve-dovecot-environment
Abstract
This document defines new vendor-defined items for the "environment"
extension of the Sieve mail filtering language.
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 2
2. Conventions Used in This Document . . . . . . . . . . . . . . . 2
3. Dovecot Environment Items . . . . . . . . . . . . . . . . . . . 2
4. Variables Namespace env . . . . . . . . . . . . . . . . . . . . 2
5. Sieve Capability Strings . . . . . . . . . . . . . . . . . . . 3
6. Security Considerations . . . . . . . . . . . . . . . . . . . . 3
7. Normative References . . . . . . . . . . . . . . . . . . . . . 3
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 4
Bosch [Page 1]
Sieve: Debug Logging September 2015
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 1
2. Conventions Used in This Document . . . . . . . . . . . . . . 1
3. Dovecot Environment Items . . . . . . . . . . . . . . . . . . 2
4. Variables Namespace env . . . . . . . . . . . . . . . . . . . 2
5. Sieve Capability Strings . . . . . . . . . . . . . . . . . . 2
6. Security Considerations . . . . . . . . . . . . . . . . . . . 3
7. Normative References . . . . . . . . . . . . . . . . . . . . 3
Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 3
1. Introduction
......@@ -73,18 +42,26 @@ Bosch [Page 1]
the Dovecot Secure IMAP server. It will therefore most likely not be
supported by web interfaces and GUI-based Sieve editors.
2. Conventions Used in This Document
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in [KEYWORDS].
Bosch Expires July 20, 2016 [Page 1]
Sieve: Dovecot Environment January 2016
Conventions for notations are as in [SIEVE] Section 1.1, including
use of the "Usage:" label for the definition of action and tagged
arguments syntax.
3. Dovecot Environment Items
The set of Dovecot-specific environment items is as follows:
......@@ -98,21 +75,12 @@ Bosch [Page 1]
The username of the recipient for this particular message
delivery.
4. Variables Namespace env
This document defines the variables namespace "env", in accordance
with the "variables" extension document [VARIABLES], Section 3. It
makes environment items directly available as variables. Since
environment items are always read-only, variables in the "env"
Bosch [Page 2]
Sieve: Debug Logging September 2015
namespace can never be modified.
Basically, the variable name for an environment item is composed of
......@@ -133,16 +101,22 @@ Bosch [Page 2]
fileinto :create "User\${env.vnd.dovecot.username}";
5. Sieve Capability Strings
A Sieve implementation that supports the Dovecot-specific environment
items outlined in this document will advertise the capability string
"vnd.dovecot.environment". Note that "vnd.dovecot.environment"
Bosch Expires July 20, 2016 [Page 2]
Sieve: Dovecot Environment January 2016
implies "environment", and a script with "vnd.dovecot.environment" in
a "require" list can omit "environment" from that list.
6. Security Considerations
All of the security considerations given in the base Sieve
......@@ -152,7 +126,6 @@ Bosch [Page 2]
than the standard ones, so enabling this extension should be
considered carefully.
7. Normative References
[ENVIRONMENT]
......@@ -161,14 +134,6 @@ Bosch [Page 2]
<http://www.rfc-editor.org/info/rfc5183>.
[KEYWORDS]
Bosch [Page 3]
Sieve: Debug Logging September 2015
Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
......@@ -179,7 +144,6 @@ Bosch [Page 3]
Homme, K., "Sieve Email Filtering: Variables Extension",
RFC 5229, January 2008.
Author's Address
Stephan Bosch
......@@ -201,24 +165,4 @@ Author's Address
Bosch [Page 4]
Bosch Expires July 20, 2016 [Page 3]
......@@ -17,8 +17,8 @@
<!-- ***** FRONT MATTER ***** -->
<front>
<title abbrev="Sieve: Debug Logging">
Sieve Email Filtering: Logging Debug Messages
<title abbrev="Sieve: Dovecot Environment">
Sieve Email Filtering: Dovecot Environment Extension
</title>
<author fullname="Stephan Bosch" initials="S." surname="Bosch">
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment

Consent

On this website, we use the web analytics service Matomo to analyze and review the use of our website. Through the collected statistics, we can improve our offerings and make them more appealing for you. Here, you can decide whether to allow us to process your data and set corresponding cookies for these purposes, in addition to technically necessary cookies. Further information on data protection—especially regarding "cookies" and "Matomo"—can be found in our privacy policy. You can withdraw your consent at any time.