1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
|
<pre>Internet Engineering Task Force (IETF) R. George
Request for Comments: 6131 B. Leiba
Category: Standards Track Huawei Technologies
ISSN: 2070-1721 July 2011
<span class="h1">Sieve Vacation Extension: "Seconds" Parameter</span>
Abstract
This document describes a further extension to the Sieve Vacation
extension, allowing multiple auto-replies to the same sender in a
single day by adding a ":seconds" parameter.
Status of This Memo
This is an Internet Standards Track document.
This document is a product of the Internet Engineering Task Force
(IETF). It represents the consensus of the IETF community. It has
received public review and has been approved for publication by the
Internet Engineering Steering Group (IESG). Further information on
Internet Standards is available in <a href="./rfc5741#section-2">Section 2 of RFC 5741</a>.
Information about the current status of this document, any errata,
and how to provide feedback on it may be obtained at
<a href="http://www.rfc-editor.org/info/rfc6131">http://www.rfc-editor.org/info/rfc6131</a>.
Copyright Notice
Copyright (c) 2011 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to <a href="https://www.rfc-editor.org/bcp/bcp78">BCP 78</a> and the IETF Trust's Legal
Provisions Relating to IETF Documents
(<a href="http://trustee.ietf.org/license-info">http://trustee.ietf.org/license-info</a>) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License.
<span class="grey">George & Leiba Standards Track [Page 1]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-2" ></span>
<span class="grey"><a href="./rfc6131">RFC 6131</a> Sieve Vacation: Seconds Parameter July 2011</span>
Table of Contents
<a href="#section-1">1</a>. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . <a href="#page-2">2</a>
<a href="#section-1.1">1.1</a>. Terminology Used in This Document . . . . . . . . . . . . . <a href="#page-2">2</a>
<a href="#section-2">2</a>. The ':seconds' Parameter . . . . . . . . . . . . . . . . . . . <a href="#page-2">2</a>
<a href="#section-3">3</a>. Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . <a href="#page-4">4</a>
<a href="#section-4">4</a>. Security Considerations . . . . . . . . . . . . . . . . . . . . <a href="#page-4">4</a>
<a href="#section-5">5</a>. IANA Considerations . . . . . . . . . . . . . . . . . . . . . . <a href="#page-4">4</a>
<a href="#section-5.1">5.1</a>. Registration of Sieve Extension . . . . . . . . . . . . . . <a href="#page-4">4</a>
<a href="#section-6">6</a>. References . . . . . . . . . . . . . . . . . . . . . . . . . . <a href="#page-5">5</a>
<a href="#section-6.1">6.1</a>. Normative References . . . . . . . . . . . . . . . . . . . <a href="#page-5">5</a>
<a href="#section-6.2">6.2</a>. Informative References . . . . . . . . . . . . . . . . . . <a href="#page-5">5</a>
<span class="h2"><a class="selflink" id="section-1" href="#section-1">1</a>. Introduction</span>
The Sieve [<a href="./rfc5228" title=""Sieve: An Email Filtering Language"">RFC5228</a>] Vacation extension [<a href="./rfc5230" title=""Sieve Email Filtering: Vacation Extension"">RFC5230</a>] defines a mechanism
to generate automatic replies to incoming email messages. Through
the ":days" parameter, it limits the number of auto-replies to the
same sender to one per [n] days, for a specified number of days. But
there are cases when one needs more granularity, if one would like to
generate "vacation" replies more frequently.
This extension defines a ":seconds" parameter to provide more
granularity for such situations.
<span class="h3"><a class="selflink" id="section-1.1" href="#section-1.1">1.1</a>. Terminology Used in This Document</span>
The upper-case 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 <a href="./rfc2119">RFC</a>
<a href="./rfc2119">2119</a> [<a href="./rfc2119" title=""Key words for use in RFCs to Indicate Requirement Levels"">RFC2119</a>].
<span class="h2"><a class="selflink" id="section-2" href="#section-2">2</a>. The ':seconds' Parameter</span>
The purpose of the ":seconds" parameter is to specify the minimum
time interval (in seconds) between consecutive auto-replies to a
given sender. The ":seconds" value, if specified, is used instead of
the ":days" value, and works in a similar way (see the Vacation
extension [<a href="./rfc5230" title=""Sieve Email Filtering: Vacation Extension"">RFC5230</a>] for details). Only one of ":days" or ":seconds"
is allowed -- use of both parameters in the same vacation action MUST
result in a Sieve processing error.
The capability string associated with this extension is "vacation-
seconds". Note that "vacation-seconds" implies "vacation", and a
script with "vacation-seconds" in a "require" list can omit
"vacation" from that list.
<span class="grey">George & Leiba Standards Track [Page 2]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-3" ></span>
<span class="grey"><a href="./rfc6131">RFC 6131</a> Sieve Vacation: Seconds Parameter July 2011</span>
The time value is specified in seconds, and MUST be greater than or
equal to 0 and less than 2**31. All valid values, from 0 to 2**31,
MUST be accepted without error. Sites MAY define a minimum effective
value and/or a maximum effective value. If a site chooses to do
that:
1. Call the value specified "v(spec)".
2. Call the minimum effective value "v(min)".
3. Call the maximum effective value "v(max)".
4. Call the actual effective value used by the processor "v(eff)".
5. The following apply for determining v(eff):
* If 0 <= v(spec) < v(min), then v(eff) = v(min).
* If v(min) <= v(spec) <= v(max), then v(eff) = v(spec).
* If v(max) < v(spec) <= 2**31, then v(eff) = v(max).
If a site imposes a maximum effective value, that value MUST be at
least 86400 (one day).
If ":seconds 0" is specified and used, it means that all auto-replies
are sent, and no attempt is made to suppress consecutive replies.
This differs from the base vacation specification, which does not
allow a time period of zero (":days 0" is forbidden); the change is
necessary to allow operation of an auto-responder (see [<a href="./rfc6133" title=""Sieve Email Filtering: Use of Presence Information with Auto-Responder Functionality"">RFC6133</a>], and
note especially example 4 in <a href="#section-3">section 3</a> of that document).
If ":seconds" and ":days" are both omitted, a site-defined interval
is used (see [<a href="./rfc5230" title=""Sieve Email Filtering: Vacation Extension"">RFC5230</a>]).
Usage: vacation [":days" number | ":seconds" number]
[":subject" string]
[":from" string]
[":addresses" string-list]
[":mime"]
[":handle" string]
<reason: string>
<span class="grey">George & Leiba Standards Track [Page 3]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-4" ></span>
<span class="grey"><a href="./rfc6131">RFC 6131</a> Sieve Vacation: Seconds Parameter July 2011</span>
<span class="h2"><a class="selflink" id="section-3" href="#section-3">3</a>. Examples</span>
The following example will automatically reply to senders with a
message that the recipient is in a meeting. Multiple replies to the
same sender will only be sent every half hour (1800 seconds).
require ["vacation-seconds"];
vacation :addresses ["tjs@example.edu", "ts4z@landru.example.edu"]
:seconds 1800
"I am in a meeting, and do not have access to email.";
The following example is used to send an acknowledgment to every
message received. A :seconds value of zero is used to reply to every
message, with no removal of duplicates to the same sender. This
requires that the Sieve engine allow an interval of zero; if it does
not, and it imposes a minimum value, not every message will receive
an auto-reply.
require ["vacation-seconds"];
vacation :handle "auto-resp" :seconds 0
"Your request has been received. A service
representative will contact you as soon as
possible, usually within one business day.";
<span class="h2"><a class="selflink" id="section-4" href="#section-4">4</a>. Security Considerations</span>
Security considerations for the Sieve Vacation extension [<a href="./rfc5230" title=""Sieve Email Filtering: Vacation Extension"">RFC5230</a>]
apply equally here. In addition, implementations SHOULD consider the
number of auto-replies that might be generated by allowing small
values of ":seconds" (including 0), and MAY impose additional limits
on that number. See the Security Considerations section of <a href="./rfc3834">RFC 3834</a>
[<a href="./rfc3834" title=""Recommendations for Automatic Responses to Electronic Mail"">RFC3834</a>] for a fuller discussion.
<span class="h2"><a class="selflink" id="section-5" href="#section-5">5</a>. IANA Considerations</span>
<span class="h3"><a class="selflink" id="section-5.1" href="#section-5.1">5.1</a>. Registration of Sieve Extension</span>
To: iana@iana.org
Subject: Registration of new Sieve extension
Capability name: vacation-seconds
Description: adds the ":seconds" parameter to the Sieve Vacation
extension. Implementations that support this MUST also support
"vacation".
RFC number: <a href="./rfc6131">RFC 6131</a>
Contact address: The Sieve discussion list <sieve@ietf.org>
<span class="grey">George & Leiba Standards Track [Page 4]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-5" ></span>
<span class="grey"><a href="./rfc6131">RFC 6131</a> Sieve Vacation: Seconds Parameter July 2011</span>
<span class="h2"><a class="selflink" id="section-6" href="#section-6">6</a>. References</span>
<span class="h3"><a class="selflink" id="section-6.1" href="#section-6.1">6.1</a>. Normative References</span>
[<a id="ref-RFC2119">RFC2119</a>] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", <a href="https://www.rfc-editor.org/bcp/bcp14">BCP 14</a>, <a href="./rfc2119">RFC 2119</a>, March 1997.
[<a id="ref-RFC3834">RFC3834</a>] Moore, K., "Recommendations for Automatic Responses to
Electronic Mail", <a href="./rfc3834">RFC 3834</a>, August 2004.
[<a id="ref-RFC5228">RFC5228</a>] Guenther, P. and T. Showalter, "Sieve: An Email Filtering
Language", <a href="./rfc5228">RFC 5228</a>, January 2008.
[<a id="ref-RFC5230">RFC5230</a>] Showalter, T. and N. Freed, "Sieve Email Filtering:
Vacation Extension", <a href="./rfc5230">RFC 5230</a>, January 2008.
<span class="h3"><a class="selflink" id="section-6.2" href="#section-6.2">6.2</a>. Informative References</span>
[<a id="ref-RFC6133">RFC6133</a>] George, R., Leiba, B., and A. Melnikov, "Sieve Email
Filtering: Use of Presence Information with Auto-Responder
Functionality", <a href="./rfc6133">RFC 6133</a>, July 2011.
Authors' Addresses
Robins George
Huawei Technologies
Bangalore, Karnataka 560071
India
Phone: +91-080-41117676
EMail: robinsgv@gmail.com
Barry Leiba
Huawei Technologies
Phone: +1 646 827 0648
EMail: barryleiba@computer.org
URI: <a href="http://internetmessagingtechnology.org/">http://internetmessagingtechnology.org/</a>
George & Leiba Standards Track [Page 5]
</pre>
|
