annotate thesis/tex/1-Introduction.tex @ 247:50240b753a46

added a sample email
author meillo@marmaro.de
date Sun, 11 Jan 2009 20:26:33 +0100
parents da83360f8442
children 724cc6057105
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
26
fb9ba63f6957 changed to new thesis structure; moved text pieces away; updated project plan
meillo@marmaro.de
parents:
diff changeset
1 \chapter{Introduction}
42
ac4ce4de4154 minor stuff
meillo@marmaro.de
parents: 34
diff changeset
2 \label{chap:introduction}
26
fb9ba63f6957 changed to new thesis structure; moved text pieces away; updated project plan
meillo@marmaro.de
parents:
diff changeset
3
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
4 << say what you want to say >>
27
433df94d5476 added pices to thesis ... need rework!
meillo@marmaro.de
parents: 26
diff changeset
5
102
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
6 << the overall goal of the document >>
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
7
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
8
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
9
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
10
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
11
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
12
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
13 \section{Email prerequisites}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
14
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
15 email and everything is defined in RFCs
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
16
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
17
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
18 \subsubsection{Mail agents}
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
19
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
20 \paragraph{MTA}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
21 \name{Mail Tranfer Agents} are for electronic mail what post offices are for snail mail. The basic job is to transport mail from senders to recipients, or more pedantic: from \MTA\ to \MTA. This is the definition of such kind of software, and this is how \MTA{}s are generally seen \cite[page 19]{dent04} \cite[pages 3-5]{hafiz05}. \MTA{}s are explained in more detail in chapter \ref{chap:mail-transfer-agents}.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
22
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
23
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
24 \paragraph{MUA}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
25 \name{Mail User Agents} the software the user deals with. It is the program he uses to write and read email. The \NAME{MUA} passes outgoing mail to the next \MTA, and it displays the contents of the user's mailbox. Well known \NAME{MUA}s are \name{Mozilla Thunderbird} and \name{mutt} on \unix\ systems, and \name{Microsoft Outlook} on \name{Windows}.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
26
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
27
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
28 \paragraph{MDA}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
29 \name{Mail Delivery Agents} correspond to postmen in the real world. They receive mail, to recipients they are responsible for, from an \MTA, and deliver it to the mailboxes of the recipients. Many \MTA{}s include an own \NAME{MDA}, but specialized ones exist: \name{procmail} and \name{maildrop} are examples.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
30
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
31
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
32
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
33 << structure diagram of an MTA (and of masqmail) >>
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
34
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
35
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
36
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
37 \subsubsection{Mail transfer with SMTP}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
38
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
39 Today most of the email is transfered using the \name{Simple Mail Transfer Protocol} (short: \SMTP), which is defined in \RFC821 and the successors \RFC2821 and \RFC5321. A good entry point for further information is \citeweb{wikipedia:smtp}.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
40
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
41 A selection of important concepts of \SMTP\ is explained here.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
42
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
43 First the \name{store and forward} transfer method. This means mail messages are sent from \MTA\ to \MTA\ until the final \MTA\ (the one which is responsible for the recipient) is reached. The message is gets stored for some time on each \MTA, until it is forwarded to the next \MTA.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
44
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
45 This leads to the concept of \name{responsibility}. A mail message is always in the responsibility of one system. First it is the \NAME{MUA}. After it was transfered to the first \MTA, he takes the responsibility for the message over. The \NAME{MUA} can then delete its copy of the message. This is the same for each transfer, from \MTA\ to \MTA\ and finally from \MTA\ to the \NAME{MDA}, the message gets transfered and if this was successful, the responsibility for the message is transfered as well. The responsibility chain ends at the user's mailbox, where he himself has control on the message again.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
46
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
47 A third concept is about failure handling. At any step on the way, an \MTA\ may get a message he is unable to handle. In such a case, this receiving \MTA\ will \name{reject} the message before it takes responsibility for it. The sending \MTA\ still has responsibility for the message and may try other ways of sending the message. If none succeeds, the \MTA\ will send a \name{bounce message} back to the original sender with information on the type of failure. Bounces are only sent if the failure is expected to be permanent, and if after many tries the transfer still was not successful.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
48
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
49
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
50
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
51 \subsubsection{Mail messages}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
52
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
53 Mail messages consist of three parts that with defined format. It is defined in \RFC822, and the successors \RFC2822 and \RFC5322.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
54
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
55 A message consists of \name{envelope} and \name{content}. This concept is derived from the real world, so it is easy to understand. The envelope is what is used to route the message from sender to recipient. It contains the sender's address and addresses of one or more recipients. Envelopes are generated (using mail header data) by \MTA{}s, the user has not to deal with them.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
56
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
57 The content of the message is again split into two part: The \name{header} and the \name{body}. The header of an email message is similar to the header of a (formal) letter. It spans the first lines of the content up to the first empty line. The header consists of several lines, called \name{header lines} or simply \name{headers}. They specify the sender, the address(es) of the recipient(s), the date, and possibly further information. Their order is irrelevant. Headers are named after the colon separated start of those lines, for example the \texttt{Date:} header. This header can write the header himself, but normally the \NAME{MUA} does this job.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
58
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
59 Finally the body is the payload of the message. It is under full control of the user. From the view point of the \SMTP\ protocol, only 7-bit \NAME{ASCII} is allowed to in it, but arbitrary content can be included by encoding it to 7-bit \NAME{ASCII}. \NAME{MIME} is the common \SMTP\ extension to handle such convertion automatically in \NAME{MUA}s.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
60
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
61 Following is a sample mail message.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
62
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
63 \input{input/sample-email.txt}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
64
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
65
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
66
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
67
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
68
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
69
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
70
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
71 \section{The \masqmail\ project}
102
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
72 \label{sec:masqmail}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
73
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
74 << about masqmail (some history) >>
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
75
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
76 (include history of email, definition of MTA and sendmail-compatibility in text)
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
77
142
1b0ba5151d1b person names in small caps
meillo@marmaro.de
parents: 135
diff changeset
78 The \masqmail\ program was written by Oliver \person{Kurth}, starting in 1999. His aim was to create a small \mta\ which is especially focused on computers with dial-up connections to the internet. \masqmail\ is easy configurable for situations which are rarely solveable with the common \MTA{}s.
102
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
79
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
80 \masqmail\ queues mail for destinations outside the local network if no connection to the internet is online. If the machine goes online, this mail is sent. Mail to local machines is sent immediately.
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
81
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
82 While the other \MTA{}s are more general purpose \MTA{}s, \masqmail\ aims on special situations only. Nevertheless can it handle ordinary mail transfers too.
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
83
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
84 \masqmail\ is released under the \GPL, which makes it \freesw. The latest stable version is 0.2.21 from November 2005.
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
85
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
86 The program's new homepage \citeweb{masqmail:homepage} provides further information about this \MTA.
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
87
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
88 << specify the really important external documents here >> %FIXME
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
89
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
90
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
91
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
92 \subsection{Target field / When to use \masqmail}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
93
142
1b0ba5151d1b person names in small caps
meillo@marmaro.de
parents: 135
diff changeset
94 Its original author, Oliver \person{Kurth}, sees \masqmail\ so:
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
95 \begin{quote}
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
96 MasqMail is a mail server designed for hosts that do not have a permanent internet connection eg. a home network or a single host at home. It has special support for connections to different ISPs. It replaces sendmail or other MTAs such as qmail or exim.
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
97 \end{quote}
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
98
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
99 \masqmail\ is inteded to cover a specific niche: non-permanent internet connection and different \NAME{ISP}s.
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
100
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
101 Although it can basically replace other \MTA{}s, it is not generally aimed to do so. The package description of \debian\citeweb{packages.debian:masqmail} states this more clearly by changing the last sentence to:
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
102 \begin{quote}
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
103 In these cases, MasqMail is a slim replacement for full-blown MTAs such as sendmail, exim, qmail or postfix.
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
104 \end{quote}
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
105 \masqmail\ is a good replacement ``in these cases'', but not generally, since is lacks features essential for running on mail servers. It is primarily not secure enough for being accessable from untrusted locations.
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
106
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
107 The program is best used in home networks, which are non-permanently connected to the internet. \masqmail\ sends mail to local destinations, like users on the same machine and on other machines in the local net, immediately. Email to recipients outside the local net are queued when offline and sent when a online connection gets established.
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
108
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
109 Further more does \masqmail\ respect online connections through different \NAME{ISP}s; a common thing for dial-up connections. In particular can different sender addresses be set, dependent on the \NAME{ISP} that is used. This prevents mail to be likely classified as spam.
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
110
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
111
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
112
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
113
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
114 \subsubsection*{\masqmail's main goal}
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
115
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
116 \masqmail\ does have similar requirements, by being a \sendmail\ replacement, which is a basic goal of the project. The main difference is that \masqmail\ is intended to be used on workstations and in small networks, but \sendmail, \qmail, and \postfix\ are designed to run on large mail servers to handle masses of email. The author of \masqmail, \person{Kurth}, in contrast, warns on the old project's website \citeweb{masqmail:homepage2} about using it to accept connections from the Internet, because of the risk to be an open relay:
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
117 \begin{quote}
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
118 MasqMail is not designed to run on a host with a permanent internet connection. It does not have the ability to check for spam mail and it will relay everything from everywhere to everywhere. Use another mail server such as exim for permanent connections.
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
119 \end{quote}
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
120 Even if some relay control will be added, ``is not designed to'' is a clear indicator for being careful. Issues like high memory consumption, low performance, and denial-of-service attacks---things not regarded by design---may cause serious problems.
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
121
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
122 Here shows a misfit off: On the one hand does \masqmail\ want to be a \sendmail\ replacement. But on the other hand, is it not designed to be used like \sendmail. If \masqmail\ is inteded to replace other \MTA{}s, then one may replace another one with it. Hence it must be secure enough. It either needs the security features or must drop the unsecure funtionality. The second option, however, leads to being \emph{no} replacement for other \MTA{}s. It is a valid decision to not be a replacement for \sendmail\ or thelike, but this is a design decision---the change of a primary goal.
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
123
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
124 If \masqmail\ should be an \MTA\ to replace others, a switch to a better suited architecture that provides good security and extendability by design, seems required. But if \masqmail\ is wanted to cover some special jobs, not to replace common \MTA{}s, then its architecture depends on the special requirements of the specific job; \MTA\ architectures, like discussed by \person{Hafiz}, may be inadequate.
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
125
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
126
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
127 \subsubsection*{Full featured or stripped down}
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
128
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
129 What future is to choose for \masqmail---one to be a full featured \MTA, or one to be a stipped down \MTA\ for special jobs?
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
130
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
131 The critical point to discuss upon is surely the listening on a port to accepte messages from outside via \NAME{SMTP} (herafter also refered to as the \NAME{SMTP}-in channel). This feature is required for an \MTA\ to be a \name{smart host}, to relay mail. But running as deamon and listening on a port requires much more security effort, because the program is put in direct contact with attackers and other bad guys.
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
132
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
133 \MTA{}s without \SMTP-in channels can not receive mail from arbitrary outside hosts. They are only invoked by local users. This lowers the security need a lot---however, security is a general goal and still required, but on a lower level. Unfortunately, as they do not receive mail anymore (except by local submission), they are just better \name{forwarders} that are able to send mail directly to the destination.
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
134
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
135 This is not what \masqmail\ was intended to be. Programs that cover this purpose are available; one is \name{msmtp}.
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
136
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
137 \masqmail\ shall be a complete \mta. It shall be able to replace ones like \sendmail.
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
138
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
139
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
140
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
141 \subsubsection*{Typical usage}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
142 This section describes situations that make senseful use of \masqmail.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
143
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
144 A home network consisting of some workstations without a server. The network is connected to the internet by dial-up or broadband. Going online is initiated by computers inside the local net. \NAME{IP} addresses change at least once every day.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
145
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
146 Every workstation would be equiped with \masqmail. Mail transfer within the same machine or within the local net works straight forward. Outgoing mail to the internet is sent, to the concerning \NAME{ISP} for relaying, whenever the router goes online. Receiving of mail from outside needs to be done by a mail fetch program, like the \masqmail\ internal \NAME{POP3} client or \name{fetchmail} for example. The configuration for \masqmail\ would be the same on every computer, except the hostname.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
147
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
148 For the same network but having a server, one could have \masqmail\ running on the server and using simple forwarders (see \ref{subsec:relay-only}) to the server on the workstations. This setup does only support mail transfer to the server, but not back to a workstation; also sending mail to another user on the same workstation is not possible.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
149
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
150 A better setup is to run \masqmail\ on every machine %FIXME
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
151
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
152
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
153
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
154
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
155
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
156
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
157 \subsection{When not to use \masqmail}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
158
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
159 ...
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
160
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
161
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
162
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
163
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
164
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
165
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
166
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
167
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
168
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
169
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
170 \subsection{Features}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
171
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
172 Here regarded is version 0.2.21 of \masqmail. This is the last version released by Oliver \person{Kurth}, and the basis for my thesis.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
173
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
174
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
175 \subsubsection*{The source code}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
176
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
177 \masqmail\ is written in the C programming language. The program, as of version 0.2.21, consists of 34 source code and eight header files, containing about 9,000 lines of code\footnote{Measured with \name{sloccount} by David A.\ Wheeler.}. Additionally, it includes a \name{base64} implementation (about 300 lines) and \name{md5} code (about 150 lines). For systems that do not provide \name{libident}, this library is distributed as well (circa 600 lines); an available shared library has higher precedence in linking, though.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
178
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
179 The only mandatory dependency is \name{glib}---a cross-platform software utility library, originated in the \NAME{GTK+} project. It provides safe replacements for many standard library functions, especially for the string functions. It also offers handy data containers, easy-to-use implementations of data structures, and much more.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
180
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
181 With \masqmail\ comes the small tool \path{mservdetect}; it helps setting up a configuration that uses the \name{mserver} system to detect the online state. Two other binaries get compiled for testing purposes: \path{readtest} and \path{smtpsend}. All three programs use \masqmail\ source code; they only add a file with a \verb+main()+ function each.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
182
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
183 \masqmail\ lacks an interface to plug in modules with additional functionality. There exists no add-on or module system. The code is only separated by function to the various source files. Some functional parts can be included or excluded by defining symbols at compile time. Adding maildir support, means giving the option \verb+--enable-maildir+ to the \path{configure} call. This preserves the concerning code to get removed by the preprocessor. Unfortunately the \verb+#ifdef+s are scattered through all the source, leading to a code that is hard to read.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
184 %fixme: refer to ifdef-considered-harmful ?
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
185
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
186
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
187
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
188 \subsubsection*{Features}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
189 \label{sec:masqmail-features}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
190
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
191 \masqmail\ supports two channels for incoming mail: (1) Standard input, used when \path{masqmail} is executed on the command line and (2) a \NAME{TCP} socket, used by local or remote clients that talk \SMTP. The outgoing channels for mail are: (1) direct delivery to local mailboxes (in \name{mbox} or \name{maildir} format), (2) local pipes to pass mail to a program (e.g.\ gateways to \NAME{UUCP}, gateways to fax, or \NAME{MDA}s), and (3) \NAME{TCP} sockets to transfer mail to other \MTA{}s using the \SMTP\ protocol.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
192
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
193 Outgoing \SMTP\ connections feature \SMTP-\NAME{AUTH} and \SMTP-after-\NAME{POP} authentication, but incoming connections do not. Using wrappers for outgoing connections is supported. This allows encrypted communication through a gateway application like \name{openssl}.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
194
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
195 Mail queuing and alias expansion is both supported.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
196
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
197 \masqmail\ focuses on non-permanent online connections, thus a concept of online routes is used. One may configure any number of routes to send mail. Each route can have criteria to determine if some message is allowed to be sent over it. This concept is explained in section \ref{sec:masqmail-routes} in detail. Mail to destinations outside the local network gets queued until an online connections is available.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
198
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
199 The \masqmail\ executable can be called under various names for sendmail-compatibility reasons. This is organized by symbolic links with different names pointing to the \masqmail\ executable. The \sendmail\ names are \path{/usr/lib/sendmail} and \path{/usr/sbin/sendmail} because many programs expect the \mta\ to be located there. Further more \sendmail\ supports calling it with a different name instead of supplying command line arguments. The best known of this shortcuts is \path{mailq}, which is equivalent to calling it with the argument \verb+-bq+. \masqmail\ recognizes the shortcuts \path{mailq}, \path{smtpd}, \path{mailrm}, \path{runq}, \path{rmail}, and \path{in.smtpd}. The first two are inspired by \sendmail. Not implemented is the shortcut \path{newaliases} because \masqmail\ does not generate binary representations of the alias file.\footnote{A shell script named \path{newaliases}, that invokes \texttt{masqmail -bi}, can provide the command to satisfy other software needing it.} \path{hoststat} and \path{purgestat} are missing for complete sendmail-compatibility.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
200 %masqmail: mailq, mailrm, runq, rmail, smtpd/in.smtpd
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
201 %sendmail: hoststat, mailq, newaliases, purgestat, smtpd
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
202
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
203 Additional to the \mta\ job, \masqmail\ also offers mail retrieval services by being a \NAME{POP3} client. It can fetch mail from different remote locations, dependent on the active online connection.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
204
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
205
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
206
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
207 \subsubsection*{Online detection and routes}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
208 \label{sec:masqmail-routes}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
209
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
210 ---
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
211
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
212 As \masqmail\ is focused on non-permanent Internet connections, online state can be queried by three methods: reading from a file, reading the output of a command, or by asking an \name{mserver}. Each method may return a string indicating one of the available routes being online, or returning nothing to indicate offline state.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
213
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
214 Delivery to recipients on the local host or in local nets is done at once; delivery to recipients on the Internet is only done when being online, and queued otherwise. Each online route may have a different mail server to which mail is relayed. Return address headers are modified appropriate if wished.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
215
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
216 ---
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
217
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
218 \masqmail\ focuses on non-permanent online connections, thus a concept of online routes is used. One may configure any number of routes to send mail. Each route can have criteria, like matching \texttt{From:} or \texttt{To:} headers, to determine if some message is allowed to be sent over it. Mail to destinations outside the local network gets queued until an online connections is available.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
219
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
220
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
221
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
222
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
223
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
224
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
225
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
226
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
227
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
228
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
229 \section{Why \masqmail?}
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
230
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
231 As main advantage, \masqmail\ makes it easy to set up an \MTA\ on workstations or notebooks without the need to do complex configuration or to be an mail server expert.
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
232
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
233 Workstations use %FIXME
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
234
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
235 \textbf{Alternatives?}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
236 http://anfi.homeunix.org/sendmail/dialup10.html
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
237
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
238
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
239 << explain why masqmail is old and why it is interesting/important however! >>
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
240
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
241 << why is it worth to revive masqmail? >>
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
242
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
243
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
244
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
245
175
aab8499c9f2f moved ch06s content into other chapters to remove it
meillo@marmaro.de
parents: 160
diff changeset
246
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
247
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
248
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
249 \section{Problems to solve}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
250
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
251 << what problems has masqmail? >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
252
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
253 << what's the intention of this document? >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
254
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
255 << why is it worth the effort? >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
256
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
257
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
258
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
259
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
260
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
261 \section{Delimitation}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
262
150
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 142
diff changeset
263 << limit against stuff not covered here >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
264
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
265
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
266
150
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 142
diff changeset
267