Sieve envelope extension

The capability string in order to use an   test, as defined in RFC 5228, is " ": require "envelope"; The " " test has been further extended by additional RFCs to allow access to additional envelope fields, including the " " extension defined in RFC 6009 for access to the information provided by the DSN SMTP extension, and the the " " extension, for access to the SMTP AUTH value; while other RFCs extend " " as well as other Sieve operations, including the " ",  " ", and " "  extensions which among other effects also supplement the range or types of allowed " " tests. And the MTA&#x27;s private conversion tag mechanism  can also be accessed from " " tests using the private " " part.

In order to use such supplementary " " parts, the additional extension, as well as " " itself, must be listed in a " " action (all except for " " which does not need a " " action); e.g.: require &#x5b;"envelope","envelope-dsn"&#x5d;; require &#x5b;"envelope","envelope-auth"&#x5d;; require &#x5b;"envelope","subaddress"&#x5d;; require &#x5b;"envelope","extlists"&#x5d;; require &#x5b;"envelope","relational&#x5d;; The " " test takes a string or list argument.

In addition to supporting the standard  test  arguments specified in RFC 5228 and the other extensions mentioned above, the   test supports a    argument. This test checks the current list of tags associated with the current recipient, one at a time. Note that the  modifier (from the  " " extension),   if specified, allows checking of the number of active conversion tags. This type of envelope test is restricted to system-level Sieves. Also note that this test only "sees" the set of conversion tags that were present prior to Sieve processing: the effects of  " " and  " " actions are not visible.

When using an " " test from a non-channel application or utility such as, note that the External filtering context MTA options may be relevant.

See also:
 * Conversion tags
 * Sieve filter manipulation of conversion tags
 * Sieve subaddress extension
 * Sieve external lists
 * Sieve relational extension
 * External filtering context MTA options
 * Sieve supported extensions
 * Sieve language