SIEVE R. George Internet-Draft B. Leiba Intended status: Standards Track Huawei Technologies Expires: August 3, 2010 January 30, 2010 Sieve Vacation Extension: Time parameter draft-george-sieve-vacation-time-00 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 ":time" 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 3, 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 3, 2010 [Page 1] Internet-Draft Sieve Vacation: Time parameter January 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. Time Parameter . . . . . . . . . . . . . . . . . . . . . . . 3 3. Example . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 4. Security Considerations . . . . . . . . . . . . . . . . . . . 4 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 4 5.1. Registration of Sieve Extension . . . . . . . . . . . . . . . 4 6. Normative References . . . . . . . . . . . . . . . . . . . . 4 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . 5 George & Leiba Expires August 3, 2010 [Page 2] Internet-Draft Sieve Vacation: Time parameter January 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 ":time" 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. Time Parameter The purpose of the ":time" parameter is to specify the minimum time interval (in seconds) between consecutive auto-replies to a given sender. The ":time" 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 ":time" 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- time". 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 ":time" and ":days" are both omitted, a site-defined interval is used (see [RFC5230]). Usage: vacation [":days" number | ":time" number] [":subject" string] [":from" string] [":addresses" string-list] [":mime"] [":handle" string] George & Leiba Expires August 3, 2010 [Page 3] Internet-Draft Sieve Vacation: Time parameter January 2010 3. Example 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", "vacation-time"]; vacation :addresses ["tjs@example.edu", "ts4z@landru.example.edu"] :time 1800 "I am in a meeting, and do not have access to email."; 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 ":time" (including 0). 5. IANA Considerations 5.1. Registration of Sieve Extension To: iana@iana.org Subject: Registration of new Sieve extension Capability name: vacation-time Description: adds the ":time" parameter to the Sieve Vacation extension. Implementations that support this MUST also support "vacation". RFC number: this RFC Contact address: The Sieve discussion list 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. George & Leiba Expires August 3, 2010 [Page 4] Internet-Draft Sieve Vacation: Time parameter January 2010 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 Barry Leiba Huawei Technologies Phone: +1 646 827 0648 Email: barryleiba@computer.org URI: http://internetmessagingtechnology.org/ George & Leiba Expires August 3, 2010 [Page 5]