1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
.\" Copyright (c) 2010-2018 Pigeonhole authors, see the included COPYING file
.TH "PIGEONHOLE" 7 "2015-02-21" "Pigeonhole for Dovecot v2.4" "Pigeonhole"
.\"------------------------------------------------------------------------
.SH NAME
pigeonhole \- Overview of the Pigeonhole project\(aqs Sieve support for the
Dovecot secure IMAP and POP3 server
.\"------------------------------------------------------------------------
.SH DESCRIPTION
.PP
The Pigeonhole project <http://pigeonhole.dovecot.org> adds support for the
Sieve language (RFC 5228) and the ManageSieve protocol (RFC 5804) to the
Dovecot Secure IMAP and POP3 Server (\fBdovecot\fR(1)). In the literal sense,
a pigeonhole is a a hole or recess inside a dovecot for pigeons to nest in.
It is, however, also the name for one of a series of small, open compartments
in a cabinet used for filing or sorting mail. As a verb, it describes the act
of putting an item into one of those pigeonholes. The name \(dqPigeonhole\(dq
therefore well describes an important part of the functionality that this
project adds to Dovecot: sorting and filing e\-mail messages.
.PP
The Sieve language is used to specify how e\-mail needs to be processed. By
writing Sieve scripts, users can customize how messages are delivered, e.g.
whether they are forwarded or stored in special folders. Unwanted messages can
be discarded or rejected, and, when the user is not available, the Sieve
interpreter can send an automated reply. Above all, the Sieve language is meant
to be simple, extensible and system independent. And, unlike most other mail
filtering script languages, it does not allow users to execute arbitrary
programs. This is particularly useful to prevent virtual users from having full
access to the mail store. The intention of the language is to make it impossible
for users to do anything more complex (and dangerous) than write simple mail
filters.
.PP
Using the ManageSieve protocol, users can upload their Sieve scripts remotely,
without needing direct filesystem access through FTP or SCP. Additionally, a
ManageSieve server always makes sure that uploaded scripts are valid, preventing
compile failures at mail delivery.
.PP
The Pigeonhole project provides the following items:
.IP \(bu 4
The LDA Sieve plugin for Dovecot\(aqs Local Delivery Agent (LDA)
(\fBdovecot\-lda\fR(1)) that facilitates the actual Sieve filtering upon
delivery.
.IP \(bu
The ManageSieve service that implements the ManageSieve protocol through which
users can remotely manage Sieve scripts on the server.
.IP \(bu
A plugin for Dovecot\(aqs
.BR doveadm (1)
command line tool that adds new the new
.BR doveadm-sieve (1)
commands for management of Sieve filtering.
.PP
The functionality and configuration of the LDA Sieve plugin and the ManageSieve
service is described in detail in the README and INSTALL files contained in the
Pigeonhole package and in the Dovecot Wiki
<http://wiki2.dovecot.org/Pigeonhole>.
.PP
The following command line tools are available outside of
.BR doveadm :
.TP
.BR sievec (1)
Compiles Sieve scripts into a binary representation for later execution.
.TP
.BR sieve\-test (1)
The universal Sieve test tool for testing the effect of a Sieve script on a
particular message.
.TP
.BR sieve\-filter (1)
Filters all messages in a particular source mailbox through a Sieve script.
.TP
.BR sieve\-dump (1)
Dumps the content of a Sieve binary file for (development) debugging purposes.
.\"------------------------------------------------------------------------
@INCLUDE:reporting-bugs@
.\"------------------------------------------------------------------------
.SH AUTHOR
Pigeonhole <http://pigeonhole.dovecot.org> and its manual pages were written by
the Pigeonhole authors <http://pigeonhole.dovecot.org/doc/AUTHORS>, mainly
Stephan Bosch <stephan at rename\-it.nl>, and are licensed under the terms of the
LGPLv2.1 license, which is the same license as Dovecot, see
<http://dovecot.org/doc/COPYING> for details.
.\"------------------------------------------------------------------------
.SH "SEE ALSO"
.BR dovecot (1),
.BR dovecot\-lda (1),
.BR doveadm (1),
.BR doveadm-sieve (1),
.BR sieve\-dump (1),
.BR sieve\-test (1),
.BR sieve\-filter (1),
.BR sievec (1)
.\"-------------------------------------
.PP
Additional resources:
.IP "Dovecot website"
http://www.dovecot.org
.IP "Dovecot v2.x Wiki"
http://wiki2.dovecot.org/Pigeonhole
.IP "Pigeonhole website"
http://pigeonhole.dovecot.org
|
