3
Relevant specifications
4
=======================
6
RFC5230 - doc/rfc/vacation.rfc5230.txt
7
RFC6131 - doc/rfc/vacation-seconds.rfc6131.txt
12
The Sieve vacation extension [RFC5230] defines a mechanism to generate automatic
13
replies to incoming email messages. It takes various precautions to make sure
14
replies are only sent when appropriate. Script authors specify how often replies
15
are sent to a particular contact. In the original vacation extension, this
16
interval is specified in days with a minimum of one day. When more granularity
17
is necessary and particularly when replies must be sent more frequently than one
18
day, the vacation-seconds extension [RFC6131] can be used. This allows
19
specifying the minimum reply interval in seconds with a minimum of zero (reply
20
is then always sent), depending on administrator configuration.
25
The vacation extension is available by default. In contrast, the
26
vacation-seconds extension - which implies the vacation extension when used - is
27
not available by default and needs to be enabled explicitly by adding it to the
28
sieve_extensions setting. The configuration also needs to be adjusted
29
accordingly to allow a non-reply period of less than a day.
31
The vacation and vacation-seconds extensions have their own specific settings.
32
The settings that specify a period are specified in s(econds), unless followed
33
by a d(ay), h(our) or m(inute) specifier character.
35
The following settings can be configured for the vacation extension (default
36
values are indicated):
38
sieve_vacation_min_period = 1d
39
This specifies the minimum period that can be specified for the :days and
40
:seconds tags of the vacation command. A minimum of 0 indicates that users are
41
allowed to make the Sieve interpreter send a vacation response message for
42
every incoming message that meets the other reply criteria (refer to RFC5230).
43
A value of zero is however not recommended.
45
sieve_vacation_max_period = 0
46
This specifies the maximum period that can be specified for the :days tag of
47
the vacation command. The configured value must be larger than the
48
sieve_vacation_min_period setting. A value of 0 has a special meaning: it
49
indicates that there is no upper limit.
51
sieve_vacation_default_period = 7d
52
This specifies the default period that is used when no :days or :seconds tag
53
is specified. The configured value must lie between the
54
sieve_vacation_min_period and sieve_vacation_max_period.
56
sieve_vacation_use_original_recipient = no
57
This specifies whether the original envelope recipient should be used in the
58
check for implicit delivery. The vacation command checks headers of the
59
incoming message, such as To: and Cc: for the address of the recipient, to
60
verify that the message is explicitly addressed at the recipient. If the
61
recipient address is not found, the vacation action will not trigger a
62
response to prevent sending a reply when it is not appropriate. Normally only
63
the final recipient address is used in this check. This setting allows
64
including the original recipient specified in the SMTP session if available.
65
This is useful to handle mail accounts with aliases. Use this option with
66
caution: if you are using aliases that point to more than a single account,
67
senders can get multiple vacation responses for a single message.
69
sieve_vacation_dont_check_recipient = no
70
This disables the checks for implicit delivery entirely. This means that the
71
vacation command does not verify that the message is explicitly addressed at
72
the recipient. Use this option with caution. Specifying 'yes' will violate the
73
Sieve standards and can cause vacation replies to be sent for messages not
74
directly addressed at the recipient.
76
Invalid values for the settings above will make the Sieve interpreter log a
77
warning and revert to the default values.
83
# Use vacation-seconds
84
sieve_extensions = +vacation-seconds
87
sieve_vacation_min_period = 1h
90
sieve_vacation_min_period = 10d
92
# Thirty days at maximum
93
sieve_vacation_max_period = 30d