Sieve working group R. George
Internet-Draft B. Leiba
Intended status: Standards Track Huawei Technologies
Expires: August 13, 2010 February 9, 2010
Sieve Vacation Extension: "Seconds" parameter
draft-george-sieve-vacation-time-01
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 Internet-Draft is submitted to IETF in full conformance with the
provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that
other groups may also distribute working documents as Internet-
Drafts.
Internet-Drafts are draft documents valid for a maximum of six months
and may be updated, replaced, or obsoleted by other documents at any
time. It is inappropriate to use Internet-Drafts as reference
material or to cite them other than as "work in progress."
The list of current Internet-Drafts can be accessed at
http://www.ietf.org/ietf/1id-abstracts.txt.
The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html.
This Internet-Draft will expire on August 13, 2010.
Copyright Notice
Copyright (c) 2010 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
George & Leiba Expires August 13, 2010 [Page 1]
Internet-Draft Sieve Vacation: Seconds parameter February 2010
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 BSD License.
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3
1.1. Terminology Used in This Document . . . . . . . . . . . . . . 3
2. 'Seconds' Parameter . . . . . . . . . . . . . . . . . . . . . 3
3. Examples . . . . . . . . . . . . . . . . . . . . . . . . . . 4
4. Security Considerations . . . . . . . . . . . . . . . . . . . 5
5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 5
5.1. Registration of Sieve Extension . . . . . . . . . . . . . . . 5
6. Normative References . . . . . . . . . . . . . . . . . . . . 5
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . 5
George & Leiba Expires August 13, 2010 [Page 2]
Internet-Draft Sieve Vacation: Seconds parameter February 2010
1. Introduction
The Sieve [RFC5228] Vacation extension [RFC5230] 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 for shorter-term situations ("in a
meeting", for example, or "out to lunch").
This extension defines a ":seconds" parameter to provide more
granularity for such situations.
1.1. Terminology 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 RFC 2119 [RFC2119].
2. 'Seconds' Parameter
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 [RFC5230] for details). Only one of ":days" and ":seconds"
is allowed -- both MAY NOT be specified (it is a compile-time error
to do so).
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 MAY omit
"vacation" from that list.
The time value is specified in seconds, and MUST be greater than or
equal to 0 and less than 2**31. All valid values MUST be accepted
without error, but sites MAY define a minimum value to actually be
used if a smaller value is specified. If 0 is specified and used, it
means that all auto-replies are sent, and no attempt is made to
suppress consecutive replies.
If ":seconds" and ":days" are both omitted, a site-defined interval
is used (see [RFC5230]).
George & Leiba Expires August 13, 2010 [Page 3]
Internet-Draft Sieve Vacation: Seconds parameter February 2010
Usage: vacation [":days" number | ":seconds" number]
[":subject" string]
[":from" string]
[":addresses" string-list]
[":mime"]
[":handle" string]
<reason: string>
3. Examples
This 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.";
This 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.";
George & Leiba Expires August 13, 2010 [Page 4]
Internet-Draft Sieve Vacation: Seconds parameter February 2010
4. Security Considerations
Security considerations for the Sieve Vacation extension [RFC5230]
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).
5. IANA Considerations
5.1. Registration of Sieve Extension
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: this RFC
Contact address: The Sieve discussion list
<ietf-mta-filters@imc.org>
6. Normative References
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC5228] Guenther, P. and T. Showalter, "Sieve: An Email Filtering
Language", RFC 5228, January 2008.
[RFC5230] Showalter, T. and N. Freed, "Sieve Email Filtering:
Vacation Extension", RFC 5230, January 2008.
Authors' Addresses
Robins George
Huawei Technologies
Huawei Base, Bantian, Longgang District
Shenzhen, Guangdong 518129
P. R. China
Phone: +86-755-28788314
Email: robinsg@huawei.com
George & Leiba Expires August 13, 2010 [Page 5]
Internet-Draft Sieve Vacation: Seconds parameter February 2010
Barry Leiba
Huawei Technologies
Phone: +1 646 827 0648
Email: barryleiba@computer.org
URI: http://internetmessagingtechnology.org/
George & Leiba Expires August 13, 2010 [Page 6]