idnits 2.17.1 draft-ietf-sieve-vacation-seconds-03.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- No issues found here. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year == The document seems to lack the recommended RFC 2119 boilerplate, even if it appears to use RFC 2119 keywords. (The document does seem to have the reference to RFC 2119 which the ID-Checklist requires). -- The document date (November 23, 2010) is 4896 days in the past. Is this intentional? Checking references for intended status: Proposed Standard ---------------------------------------------------------------------------- (See RFCs 3967 and 4897 for information about using normative references to lower-maturity documents in RFCs) == Outdated reference: A later version (-04) exists of draft-ietf-sieve-autoreply-02 Summary: 0 errors (**), 0 flaws (~~), 3 warnings (==), 1 comment (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 Sieve working group R. George 3 Internet-Draft B. Leiba 4 Intended status: Standards Track Huawei Technologies 5 Expires: May 27, 2011 November 23, 2010 7 Sieve Vacation Extension: "Seconds" parameter 8 draft-ietf-sieve-vacation-seconds-03 10 Abstract 12 This document describes a further extension to the Sieve Vacation 13 extension, allowing multiple auto-replies to the same sender in a 14 single day by adding a ":seconds" parameter. 16 Status of this Memo 18 This Internet-Draft is submitted in full conformance with the 19 provisions of BCP 78 and BCP 79. 21 Internet-Drafts are working documents of the Internet Engineering 22 Task Force (IETF). Note that other groups may also distribute 23 working documents as Internet-Drafts. The list of current Internet- 24 Drafts is at http://datatracker.ietf.org/drafts/current/. 26 Internet-Drafts are draft documents valid for a maximum of six months 27 and may be updated, replaced, or obsoleted by other documents at any 28 time. It is inappropriate to use Internet-Drafts as reference 29 material or to cite them other than as "work in progress." 31 This Internet-Draft will expire on May 27, 2011. 33 Copyright Notice 35 Copyright (c) 2010 IETF Trust and the persons identified as the 36 document authors. All rights reserved. 38 This document is subject to BCP 78 and the IETF Trust's Legal 39 Provisions Relating to IETF Documents 40 (http://trustee.ietf.org/license-info) in effect on the date of 41 publication of this document. Please review these documents 42 carefully, as they describe your rights and restrictions with respect 43 to this document. Code Components extracted from this document must 44 include Simplified BSD License text as described in Section 4.e of 45 the Trust Legal Provisions and are provided without warranty as 46 described in the Simplified BSD License. 48 Table of Contents 50 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 51 1.1. Terminology Used in This Document . . . . . . . . . . . . . . 3 53 2. The ':seconds' Parameter . . . . . . . . . . . . . . . . . . 3 55 3. Examples . . . . . . . . . . . . . . . . . . . . . . . . . . 4 57 4. Security Considerations . . . . . . . . . . . . . . . . . . . 5 59 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 5 60 5.1. Registration of Sieve Extension . . . . . . . . . . . . . . . 5 62 6. References . . . . . . . . . . . . . . . . . . . . . . . . . 5 63 6.1. Normative References . . . . . . . . . . . . . . . . . . . . 5 64 6.2. Informative References . . . . . . . . . . . . . . . . . . . 5 66 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . 6 68 1. Introduction 70 The Sieve [RFC5228] Vacation extension [RFC5230] defines a mechanism 71 to generate automatic replies to incoming email messages. Through 72 the ":days" parameter, it limits the number of auto-replies to the 73 same sender to one per [n] days, for a specified number of days. But 74 there are cases when one needs more granularity, if one would like to 75 generate "vacation" replies more frequently. 77 This extension defines a ":seconds" parameter to provide more 78 granularity for such situations. 80 1.1. Terminology Used in This Document 82 The upper-case key words "MUST", "MUST NOT", "REQUIRED", "SHALL", 83 "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and 84 "OPTIONAL" in this document are to be interpreted as described in RFC 85 2119 [RFC2119]. 87 2. The ':seconds' Parameter 89 The purpose of the ":seconds" parameter is to specify the minimum 90 time interval (in seconds) between consecutive auto-replies to a 91 given sender. The ":seconds" value, if specified, is used instead of 92 the ":days" value, and works in a similar way (see the Vacation 93 extension [RFC5230] for details). Only one of ":days" and ":seconds" 94 is allowed -- use of both parameters in the same vacation action MUST 95 result in a Sieve processing error. 97 The capability string associated with this extension is "vacation- 98 seconds". Note that "vacation-seconds" implies "vacation", and a 99 script with "vacation-seconds" in a "require" list can omit 100 "vacation" from that list. 102 The time value is specified in seconds, and MUST be greater than or 103 equal to 0 and less than 2**31. All valid values MUST be accepted 104 without error, but sites MAY define a minimum value to actually be 105 used if a smaller value is specified, and/or a maximum value to be 106 used if a larger value is specified. If a site imposes a maximum 107 value, that value MUST be at least 86400 (one day). 109 If ":seconds 0" is specified and used, it means that all auto-replies 110 are sent, and no attempt is made to suppress consecutive replies. 111 This differs from the base vacation specification, which does not 112 allow a time period of zero (":days 0" is forbidden); the change is 113 necessary to allow operation of an auto-responder (see 114 [I-D.ietf-sieve-autoreply], and note especially example 4 in section 115 3 of that document). 117 If ":seconds" and ":days" are both omitted, a site-defined interval 118 is used (see [RFC5230]). 120 Usage: vacation [":days" number | ":seconds" number] 121 [":subject" string] 122 [":from" string] 123 [":addresses" string-list] 124 [":mime"] 125 [":handle" string] 126 128 3. Examples 130 This example will automatically reply to senders with a message that 131 the recipient is in a meeting. Multiple replies to the same sender 132 will only be sent every half hour (1800 seconds). 134 require ["vacation-seconds"]; 135 vacation :addresses ["tjs@example.edu", "ts4z@landru.example.edu"] 136 :seconds 1800 137 "I am in a meeting, and do not have access to email."; 139 This example is used to send an acknowledgment to every message 140 received. A :seconds value of zero is used to reply to every 141 message, with no removal of duplicates to the same sender. This 142 requires that the Sieve engine allow an interval of zero; if it does 143 not, and it imposes a minimum value, not every message will receive 144 an auto-reply. 146 require ["vacation-seconds"]; 148 vacation :handle "auto-resp" :seconds 0 149 "Your request has been received. A service 150 representative will contact you as soon as 151 possible, usually within one business day."; 153 4. Security Considerations 155 Security considerations for the Sieve Vacation extension [RFC5230] 156 apply equally here. In addition, implementations SHOULD consider the 157 number of auto-replies that might be generated by allowing small 158 values of ":seconds" (including 0), and MAY impose additional limits 159 on that number. See the Security Considerations section of RFC 3834 160 [RFC3834] for a fuller discussion. 162 5. IANA Considerations 164 5.1. Registration of Sieve Extension 166 To: iana@iana.org 167 Subject: Registration of new Sieve extension 168 Capability name: vacation-seconds 169 Description: adds the ":seconds" parameter to the Sieve Vacation 170 extension. Implementations that support this MUST also support 171 "vacation". 172 RFC number: this RFC 173 Contact address: The Sieve discussion list 175 6. References 177 6.1. Normative References 179 [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate 180 Requirement Levels", BCP 14, RFC 2119, March 1997. 182 [RFC3834] Moore, K., "Recommendations for Automatic Responses to 183 Electronic Mail", RFC 3834, August 2004. 185 [RFC5228] Guenther, P. and T. Showalter, "Sieve: An Email Filtering 186 Language", RFC 5228, January 2008. 188 [RFC5230] Showalter, T. and N. Freed, "Sieve Email Filtering: 189 Vacation Extension", RFC 5230, January 2008. 191 6.2. Informative References 193 [I-D.ietf-sieve-autoreply] 194 George, R., Leiba, B., and A. Melnikov, "Sieve Email 195 Filtering: Use of Presence Information with Auto Responder 196 functionality", draft-ietf-sieve-autoreply-02 (work in 197 progress), October 2010. 199 Authors' Addresses 201 Robins George 202 Huawei Technologies 203 Bangalore, Karnataka 560071 204 India 206 Phone: +91-080-41117676 207 Email: robinsgv@gmail.com 209 Barry Leiba 210 Huawei Technologies 212 Phone: +1 646 827 0648 213 Email: barryleiba@computer.org 214 URI: http://internetmessagingtechnology.org/