aboutsummaryrefslogtreecommitdiff
path: root/docs/lda.txt
blob: 6e3a686ff02d93e53dd001d832b0151a758373b4 (plain) (blame)
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
What is a Local Delivery Agent?
==============================

!!! This is deprecated

The part of SMLMP that connects to Postfix is a mail delivery agent,
abbreviated as "LDA". Basically, it expects certain environment
variables as described below to be set. SMLMP's LDA expects the
following environment variables to be correctly set by Postfix when it 
is called.

LOCAL                   The local-part of the final recipient address.
DOMAIN                  The domain-part of the final recipient address.
			As a special requirement, this must also be the
			domain-part of all mailing list addresses due to
			a technical limitaiton.
ORIGINAL_RECIPIENT      The original recipient when Postfix is told to
			handle the message.
			Note that this does not include all original
			recipients, it just states the original
			recipient that "caused" Postfix to deliver it
			to our LOCAL.
SENDER                  The SMTP envelope sender, as opposed to the From
			or Sender header in the email content. This is
			used for bouncing.

These are not used by SMLMP as of the time of writing:

RECIPIENT*              Full final recipient address.
MAIL_CONFIG*            Usually just /etc/postfix.
EXTENSION*              The subaddressing extension of the final
			recipient address. We don't actually use this
			environment variable, we care about the
			subaddressing extension in ORIGINAL_RECIPIENT
			instead, which we would parse ourself.
			(For background information on what
			subaddressing is, consult the comment above the
			"recipient_delimiter" option in the example
			smlmp.conf.)

The "finial recipient address" is not standard terminology. Here it
refers to the primary address that SMLMP is in charge of, after postfix
handles all aliases and routing. Our LDA sits at the final recipient
address and processes messages sent to it.

Important: The LDA expects to receive the content of the message to
deliver on standard input.