Pigeonhole Sieve: File Location for Sieve Scripts
=================================================

The 'file' <location type> [Pigeonhole.Sieve.Configuration.txt] is used to
retrieve Sieve scripts from the file system. This is the default type if the
type specifier is omitted from the location specification. The location can
either point to a directory or to a regular file. If the location points to a
directory, a script called 'name' is retrieved by reading a file from that
directory with the file name 'name.sieve'.

When this location type is involved in a 'sieve_before' or 'sieve_after' script
sequence and the location points to a directory, all files in that directory
with a '.sieve' extension are part of the sequence. The sequence order of the
scripts in that directory is determined by the file names, using a normal 8bit
per-character comparison.

Unless overridden using the ';bindir=<path>' location option, compiled binaries
for scripts retrieved from the 'file' location type are by default stored in
the same directory as where the script file was found if possible.

Configuration
-------------

The script location syntax is specified as follows:

---%<-------------------------------------------------------------------------
location = file:<path>[;<option>[=<value>][;...]]
---%<-------------------------------------------------------------------------

The following additional options are recognized:

active=<path> :
  When <ManageSieve> [Pigeonhole.ManageSieve.txt] is used, one script in the
  storage can be active; i.e., evaluated at delivery. For the 'file' location
  type, the active script in the storage directory is pointed to by a symbolic
  link. This option configures where this symbolic link is located. If the
  'file' location path points to a regular file, this setting has no effect
  (andManageSieve cannot be used).

Example
-------

---%<-------------------------------------------------------------------------
plugin {
        ...
  sieve = file:~/sieve;active=~/.dovecot.sieve

  sieve_default = file:/var/lib/dovecot/;name=default
}
---%<-------------------------------------------------------------------------

(This file was created from the wiki on 2016-07-01 04:43)
