datatracker.ietf.org
Sign in
Version 5.7.4, 2014-11-12
Report a bug

Sieve Email Filtering: Include Extension
RFC 6609

Internet Engineering Task Force (IETF)                          C. Daboo
Request for Comments: 6609                                   Apple, Inc.
Category: Standards Track                                       A. Stone
ISSN: 2070-1721                                              Serendipity
                                                                May 2012

                Sieve Email Filtering: Include Extension

Abstract

   The Sieve Email Filtering "include" extension permits users to
   include one Sieve script inside another.  This can make managing
   large scripts or multiple sets of scripts much easier, and allows a
   site and its users to build up libraries of scripts.  Users are able
   to include their own personal scripts or site-wide scripts.

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 Section 2 of RFC 5741.

   Information about the current status of this document, any errata,
   and how to provide feedback on it may be obtained at
   http://www.rfc-editor.org/info/rfc6609.

Copyright Notice

   Copyright (c) 2012 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
   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.

Daboo & Stone                Standards Track                    [Page 1]
RFC 6609                Sieve Extension: Include                May 2012

Table of Contents

   1. Introduction and Overview .......................................2
   2. Conventions Used in This Document ...............................2
   3. Include Extension ...............................................3
      3.1. General Considerations .....................................3
      3.2. Control Structure "include" ................................4
      3.3. Control Structure "return" .................................7
      3.4. Interaction with the "variables" Extension .................8
           3.4.1. Control Structure "global" ..........................8
           3.4.2. Variables Namespace global .........................10
      3.5. Interaction with Other Extensions .........................11
   4. Security Considerations ........................................12
   5. IANA Considerations ............................................12
   6. References .....................................................13
      6.1. Normative References ......................................13
      6.2. Informative References ....................................13
   Appendix A. Acknowledgments .......................................14

1.  Introduction and Overview

   It's convenient to be able to break Sieve [RFC5228] scripts down into
   smaller components that can be reused in a variety of different
   circumstances.  For example, users may want to have a default script
   and a special 'vacation' script, the latter being activated when the
   user goes on vacation.  In that case, the default actions should
   continue to be run, but a vacation command should be executed first.
   One option is to edit the default script to add or remove the
   vacation command as needed.  Another is to have a vacation script
   that simply has a vacation command and then includes the default
   script.

   This document defines the Sieve Email Filtering "include" extension,
   which permits users to include one Sieve script inside another.

2.  Conventions 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 [RFC2119].

   Conventions for notations are as in Sieve [RFC5228], Section 1.1.

Daboo & Stone                Standards Track                    [Page 2]
RFC 6609                Sieve Extension: Include                May 2012

[include full document text]