draft-ietf-sieve-editheader-03.txt   draft-ietf-sieve-editheader-04.txt 
Network Working Group Jutta Degener Network Working Group Jutta Degener
Internet Draft Philip Guenther Internet Draft Philip Guenther
Expires: April 2006 Sendmail, Inc. Expires: September 2006 Sendmail, Inc.
October 2005 March 2006
Sieve Email Filtering: Editheader Extension Sieve Email Filtering: Editheader Extension
draft-ietf-sieve-editheader-03.txt draft-ietf-sieve-editheader-04.txt
Status of this memo Status of this memo
By submitting this Internet-Draft, each author represents that any By submitting this Internet-Draft, each author represents that any
applicable patent or other IPR claims of which he or she is aware applicable patent or other IPR claims of which he or she is aware
have been or will be disclosed, and any of which he or she becomes have been or will be disclosed, and any of which he or she becomes
aware will be disclosed, in accordance with Section 6 of BCP 79. aware will be disclosed, in accordance with Section 6 of BCP 79.
Internet-Drafts are working documents of the Internet Engineering Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF), its areas, and its working groups. Note that Task Force (IETF), its areas, and its working groups. Note that
skipping to change at page 1, line 37 skipping to change at page 1, line 37
"work in progress." "work in progress."
The list of current Internet-Drafts can be accessed at The list of current Internet-Drafts can be accessed at
http://www.ietf.org/1id-abstracts.html http://www.ietf.org/1id-abstracts.html
The list of Internet-Draft Shadow Directories can be accessed at The list of Internet-Draft Shadow Directories can be accessed at
http://www.ietf.org/shadow.html http://www.ietf.org/shadow.html
Copyright Notice Copyright Notice
Copyright (C) The Internet Society (2005). Copyright (C) The Internet Society (2006).
Abstract Abstract
This document defines two new actions for the "Sieve" email This document defines two new actions for the "Sieve" email
filtering language that add and delete email header fields. filtering language that add and delete email header fields.
1. Introduction 1. Introduction
Email header fields are a flexible and easy to understand means Email header fields are a flexible and easy to understand means
of communication between email processors. of communication between email processors.
This extension enables sieve scripts to interact with other This extension enables sieve scripts to interact with other
components that consume or produce header fields by allowing components that consume or produce header fields by allowing
the script to delete and add header fields. the script to delete and add header fields.
2. Conventions used. 2. Conventions used.
Conventions for notations are as in [SIEVE] section 1.1, including Conventions for notations are as in [SIEVE] section 1.1, including
use of [KEYWORDS] and the "Syntax:" label for the definition of use of [KEYWORDS] and the "Usage:" label for the definition of
action and tagged arguments syntax. action and tagged arguments syntax.
The term "header field" is used here as in [IMAIL] to mean a The term "header field" is used here as in [IMAIL] to mean a
logical line of an email message header. logical line of an email message header.
The capability string associated with the extension defined in The capability string associated with the extension defined in
this document is "editheader". this document is "editheader".
3. Action addheader 3. Action addheader
Syntax: "addheader" [":last"] <field-name: string> <value: string> Usage: "addheader" [":last"] <field-name: string> <value: string>
The addheader action adds a header field to the existing message The addheader action adds a header field to the existing message
header. The field-name MUST be a valid 7-bit US-ASCII header header. The field-name MUST be a valid 7-bit US-ASCII header
field name as described by the [IMAIL] "field-name" nonterminal field name as described by the [IMAIL] "field-name" nonterminal
syntax element. The addheader action does not affect Sieve's syntax element. The addheader action does not affect Sieve's
implicit keep. implicit keep.
If the specified field value does not match the RFC 2822 If the specified field value does not match the RFC 2822
"unstructured" nonterminal syntax element or exceeds a length "unstructured" nonterminal syntax element or exceeds a length
limit set by the implementation, the implementation MUST either limit set by the implementation, the implementation MUST either
skipping to change at page 1, line 101 skipping to change at page 3, line 7
/* Don't redirect if we already redirected */ /* Don't redirect if we already redirected */
if not header :contains "X-Sieve-Filtered" if not header :contains "X-Sieve-Filtered"
["<kim@job.example.com>", "<kim@home.example.com>"] ["<kim@job.example.com>", "<kim@home.example.com>"]
{ {
addheader "X-Sieve-Filtered" "<kim@job.example.com>"; addheader "X-Sieve-Filtered" "<kim@job.example.com>";
redirect "kim@home.example.com"; redirect "kim@home.example.com";
} }
4. Action deleteheader 4. Action deleteheader
Syntax: "deleteheader" [":index" <fieldno: number> [":last"]] Usage: "deleteheader" [":index" <fieldno: number> [":last"]]
[COMPARATOR] [MATCH-TYPE] [COMPARATOR] [MATCH-TYPE]
<field-name: string> <field-name: string>
[<value-patterns: string-list>] [<value-patterns: string-list>]
By default, the deleteheader action deletes all occurrences of By default, the deleteheader action deletes all occurrences of
the named header field. The deleteheader action does not affect the named header field. The deleteheader action does not affect
Sieve's implicit keep. Sieve's implicit keep.
The field-name is mandatory and always matched as a case-insensitive The field-name is mandatory and always matched as a case-insensitive
US-ASCII string. The field-name MUST be a valid 7-bit header US-ASCII string. The field-name MUST be a valid 7-bit header
skipping to change at page 1, line 270 skipping to change at page 6, line 42
This draft is intended as an extension to the Sieve mail filtering This draft is intended as an extension to the Sieve mail filtering
language. Sieve extensions are discussed on the MTA Filters mailing language. Sieve extensions are discussed on the MTA Filters mailing
list at <ietf-mta-filters@imc.org>. Subscription requests can list at <ietf-mta-filters@imc.org>. Subscription requests can
be sent to <ietf-mta-filters-request@imc.org> (send an email be sent to <ietf-mta-filters-request@imc.org> (send an email
message with the word "subscribe" in the body). message with the word "subscribe" in the body).
More information on the mailing list along with a WWW archive of More information on the mailing list along with a WWW archive of
back messages is available at <http://www.imc.org/ietf-mta-filters/>. back messages is available at <http://www.imc.org/ietf-mta-filters/>.
10.1 Changes from draft-ietf-sieve-editheader-02.txt 10.1 Changes from draft-ietf-sieve-editheader-03.txt
Change "Syntax:" to "Usage:"
Updated references
10.2 Changes from draft-ietf-sieve-editheader-02.txt
Clarify that value-patterns restrict which occurences are deleted. Clarify that value-patterns restrict which occurences are deleted.
Add informative reference to [BODY]. Add informative reference to [BODY].
10.2 Changes from draft-ietf-sieve-editheader-01.txt 10.3 Changes from draft-ietf-sieve-editheader-01.txt
Whitespace and line length tweaks noted by ID-nits. Whitespace and line length tweaks noted by ID-nits.
Clarified what is being counted by :index. Clarified what is being counted by :index.
Update the [SIEVE] reference to the I-D of the revision. Update the [SIEVE] reference to the I-D of the revision.
10.3 Changes from draft-ietf-sieve-editheader-00.txt 10.4 Changes from draft-ietf-sieve-editheader-00.txt
Updated IPR boilerplate to RFC 3978/3979. Updated IPR boilerplate to RFC 3978/3979.
Many corrections in response to WGLC comments. Of particular note: Many corrections in response to WGLC comments. Of particular note:
- correct a number of spelling and grammar errors - correct a number of spelling and grammar errors
- document that neither addheader nor deleteheader affects the - document that neither addheader nor deleteheader affects the
implicit keep implicit keep
- add normative references to RFC 2047 and RFC 2231 - add normative references to RFC 2047 and RFC 2231
- it is not an error for deleteheader to affect nothing - it is not an error for deleteheader to affect nothing
- change "foo.tld" to "foo.example.com" - change "foo.tld" to "foo.example.com"
- add an informative reference to [VACATION], citing it as an - add an informative reference to [VACATION], citing it as an
example of an action that examines header fields example of an action that examines header fields
- add weasel words about changes to fields that have secondary - add weasel words about changes to fields that have secondary
effects effects
- add security consideration for combination of header changes - add security consideration for combination of header changes
and "reject" and "reject"
10.4 Changes from draft-degener-sieve-editheader-03.txt 10.5 Changes from draft-degener-sieve-editheader-03.txt
Renamed to draft-ietf-sieve-editheader-00.txt; Renamed to draft-ietf-sieve-editheader-00.txt;
tweaked the title and abstract. tweaked the title and abstract.
Added Philip Guenther as co-author. Added Philip Guenther as co-author.
Updated IPR boilerplate. Updated IPR boilerplate.
10.5 Changes from draft-degener-sieve-editheader-02.txt 10.6 Changes from draft-degener-sieve-editheader-02.txt
Changed the duplicate restrictions from "messages with different Changed the duplicate restrictions from "messages with different
headers MUST be considered different" to their direct opposite, headers MUST be considered different" to their direct opposite,
"messages with different headers MUST be considered the same," "messages with different headers MUST be considered the same,"
as requested by workgroup members on the mailing list. as requested by workgroup members on the mailing list.
Expanded mention of header signature schemes to Security Expanded mention of header signature schemes to Security
Considerations. Considerations.
Added IANA Considerations section. Added IANA Considerations section.
skipping to change at page 1, line 342 skipping to change at page 8, line 36
[RFC2047] Moore, K., "MIME (Multipurpose Internet Mail [RFC2047] Moore, K., "MIME (Multipurpose Internet Mail
Extensions) Part Three: Message Header Extensions for Extensions) Part Three: Message Header Extensions for
Non-ASCII Text", RFC 2047, November 1996. Non-ASCII Text", RFC 2047, November 1996.
[RFC2231] Freed, N. and K. Moore, "MIME Parameter Value and [RFC2231] Freed, N. and K. Moore, "MIME Parameter Value and
Encoded Word Extensions: Character Sets, Languages, and Encoded Word Extensions: Character Sets, Languages, and
Continuations", RFC 2231, November 1997. Continuations", RFC 2231, November 1997.
[SIEVE] Guenther, P. and T. Showalter, "Sieve: A Mail Filtering [SIEVE] Guenther, P. and T. Showalter, "Sieve: A Mail Filtering
Language", draft-ietf-sieve-3028bis-04, July 2005. Language", draft-ietf-sieve-3028bis-06, March 2006.
Appendix B. Informative References Appendix B. Informative References
[BODY] Degener, J. and P. Guenther, "Sieve Email Filtering: [BODY] Degener, J. and P. Guenther, "Sieve Email Filtering:
Body Extension", draft-ietf-sieve-body-02, July 2005 Body Extension", draft-ietf-sieve-body-03, March 2006
[VACATION] Showalter, T. and N. Freed, "Sieve Email Filtering: [VACATION] Showalter, T. and N. Freed, "Sieve Email Filtering:
Vacation Extension", draft-ietf-sieve-vacation-02, Vacation Extension", draft-ietf-sieve-vacation-05,
April 2005 December 2005
Copyright Statement Copyright Statement
Copyright (C) The Internet Society (2005). This document is Copyright (C) The Internet Society (2006). This document is
subject to the rights, licenses and restrictions contained in subject to the rights, licenses and restrictions contained in
BCP 78, and except as set forth therein, the authors retain all BCP 78, and except as set forth therein, the authors retain all
their rights. their rights.
This document and the information contained herein are provided on an This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE
REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE
INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
 End of changes. 15 change blocks. 
17 lines changed or deleted 23 lines changed or added

This html diff was produced by rfcdiff 1.29, available from http://www.levkowetz.com/ietf/tools/rfcdiff/