Filter, nofilter, destinationfilter, nodestinationfilter, sourcefilter, nosourcefilter, fileinto, nofileinto Channel Options

From MsgServerDocWiki

Filter file location (filter, nofilter, destinationfilter, nodestinationfilter, sourcefilter, nosourcefilter, fileinto, nofileinto)

For the JES MS MTA, user and group Sieve mailbox filters are normally enabled simply by storing them in the users' (and groups') mailSieveRuleSource attribute - or more precisely, storing them in the attribute named by the ldap_filter MTA option. However, user filters may be located in an alternate sort of location (in files on disk, for instance) via use of the filter channel option. So while not normally used, in principle the filter option may be used on the ims-ms, native, and tcp_lmtp* channels to specify the location of user filter files for that channel. It takes a required URL argument describing the filter file location. nofilter is the default; it means that only filters enabled implicitly via user/group LDAP entries will be used (and no additional, external Sieve lookup will be performed by the MTA).

The sourcefilter and destinationfilter channel options may be used on general MTA channels to specify a channel-level filter to apply to incoming and outgoing messages, respectively. (More precisely, a sourcefilter is applied when the source channel on which it is specified is enqueueing a message; a destinationfilter is applied when any channel is enqueuing a message to the destination channel on which it is specified.) These channel options take a required URL argument describing the channel filter file location. nosourcefilter and nodestinationfilter are the defaults and mean that no channel mailbox filter is enabled for either direction of the channel.

The obsolete channelfilter and nochannelfilter keywords are synonyms for destinationfilter and nodestinationfilter, respectively. These keywords are not supported in XML configurations.

The fileinto channel option, currently supported only for channels delivering into the Messaging Server Message Store (that is, ims-ms and tcp_lmtp* channels), specifies how to alter an address when a Sieve mailbox filter fileinto operator is applied.

For ims-ms channels, the usual usage is

fileinto $U+$S@$D 

meaning that the folder name should be inserted as a subaddress into the original address, replacing any originally present subaddress.

For tcp_lmtp* channels, the usual usage is

fileinto @$4O:$U+$S@$D 

(where note that in $4O the O is the capital or majuscule letter "o", not the numeral zero 0). The effect is that the explicit source route to the mailhost should be preserved if present, and the foldername should be inserted as a subaddress into the original address, replacing any originally present subaddress.