One document matched: draft-ietf-sieve-vacation-seconds-00.xml

<?xml version="1.0" encoding="US-ASCII"?>
<!DOCTYPE rfc SYSTEM "rfc2629.dtd" [
<!ENTITY RFC2119    PUBLIC '' '../../bibxml/reference.RFC.2119.xml'>
<!ENTITY RFC5228    PUBLIC '' '../../bibxml/reference.RFC.5228.xml'>
<!ENTITY RFC5230    PUBLIC '' '../../bibxml/reference.RFC.5230.xml'>
]>

<?rfc toc="yes" ?>
<?rfc tocompact="no" ?>
<?rfc tocindent="no" ?>
<?rfc comments="yes" ?>
<?rfc inline="yes" ?>
<?rfc symrefs="yes" ?>
<?rfc sortrefs="yes"?>
<?rfc iprnotified="no" ?>
<?rfc strict="yes" ?>
<?rfc compact="yes" ?>
<?rfc subcompact="no"?>

<rfc category="std"
     ipr="trust200902"
     docName="draft-ietf-sieve-vacation-seconds-00">
<front>
  <title abbrev="Sieve Vacation: Seconds parameter">
    Sieve Vacation Extension: "Seconds" parameter
  </title>

  <author initials="R." surname="George" fullname="Robins George">
    <organization abbrev="Huawei Technologies">Huawei Technologies </organization>
    <address>
      <postal>
        <street> Huawei Base, Bantian, Longgang District </street>
        <city> Shenzhen </city> 
        <region> Guangdong </region>
        <code> 518129 </code> 
        <country> P. R. China</country> 
      </postal>
      <phone> +86-755-28788314 </phone>
      <email> robinsg@huawei.com </email>
    </address>
  </author>

  <author initials='B.' surname="Leiba" fullname='Barry Leiba'>
    <organization>Huawei Technologies</organization>
    <address>
      <phone>+1 646 827 0648</phone>
      <email>barryleiba@computer.org</email>
      <uri>http://internetmessagingtechnology.org/</uri>
    </address>
  </author>

  <date year="2010" />
  <area>APP</area>
  <workgroup>Sieve working group</workgroup>

  <abstract>
    <t>
      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.
    </t>
  </abstract>
</front>

<middle>
  <section anchor="intro" title="Introduction">
    <t>
      The Sieve <xref target='RFC5228' />
      Vacation extension <xref target='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").
    </t> 
    <t>
      This extension defines a ":seconds" parameter to provide more granularity
      for such situations.
    </t>

    <section anchor="terms" title="Terminology Used in This Document">
      <t>
        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 <xref target='RFC2119' />.
      </t>
    </section>
  </section>

  <section anchor="seconds-param" title="'Seconds' Parameter">
    <t>
      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 <xref target='RFC5230' /> for details).
      Only one of ":days" and ":seconds" is allowed -- use of both parameters in
      the same vacation action MUST result in a Sieve processing error.
    </t>

    <t>
      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.
    </t>
    
    <t>
      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.
    </t>
    
    <t>
      If ":seconds" and ":days" are both omitted, a site-defined interval is used
      (see <xref target='RFC5230' />).
    </t>

    <t>
<figure>
<artwork>
<![CDATA[
Usage: vacation [":days" number | ":seconds" number]
                [":subject" string]
                [":from" string]
                [":addresses" string-list]
                [":mime"]
                [":handle" string]
                <reason: string>

]]>
</artwork>
</figure>
    </t>
  </section>

  <section anchor="examples" title="Examples">
    <t>
      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).
<figure>
<artwork>
<![CDATA[
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.";


]]>
</artwork>
</figure>
    </t>

    <t>
      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.
<figure>
<artwork>
<![CDATA[
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.";


]]>
</artwork>
</figure>
    </t>
  </section>

  <section anchor="security" title="Security Considerations">
    <t>
      Security considerations for the Sieve Vacation extension
      <xref target='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).
    </t>
  </section>

  <section anchor="iana" title="IANA Considerations">
    <section title="Registration of Sieve Extension">
<?rfc subcompact="yes"?>
      <t><list style="hanging">
        <t hangText="To:">iana@iana.org</t>
        <t hangText="Subject:">Registration of new Sieve extension</t>
        <t hangText="Capability name:">vacation-seconds</t>
        <t hangText="Description:">adds the ":seconds" parameter to the Sieve
            Vacation extension.  Implementations that support this MUST also
            support "vacation".
        </t>
        <t hangText="RFC number:">this RFC</t>
        <t hangText="Contact address:">
            The Sieve discussion list <ietf-mta-filters@imc.org></t>
      </list></t>
<?rfc subcompact="no"?>
    </section>
  </section>
</middle>

<back>
  <references title="Normative References">
    &RFC2119;
    &RFC5228; <!-- sieve -->
    &RFC5230; <!-- vacation -->
  </references>
</back>
</rfc>