Mercurial > docs > diploma

annotate thesis/tex/1-Introduction.tex @ 409:ca763bd8c809 default tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added tag final version which I handed in for changeset ee7211546c02
author meillo@marmaro.de
date Wed, 11 Feb 2009 08:55:32 +0100
parents ee7211546c02
children
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
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
4 This chapter introduces some basic email concepts that are essential for understanding the remainder of the thesis. Then \masqmail---the program of interest---is presented. History, typical usage, and the function it provides are described. After an explanation of \masqmail's relevance, its weaknesses are pointed out. Solving these weaknesses is the topics that is covered throughout this thesis.
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
5
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
6
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
7
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
8
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
9
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
10 \section{Email prerequisites}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
11
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
12 Electronic mail is a service on the Internet and thus, like other Internet services, defined and standardized by \name{Requests For Comments} (short: \RFC{}s) under management of the \name{Internet Engineering Task Force} (short: \NAME{IETF}). \RFC{}s are highly technical documents and it is not required that the readers of this thesis are familiar with them.
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
13 \index{ietf}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
14 \index{rfc}
306
7f33aa4eb791 added some last missing texts in ch01
meillo@marmaro.de
parents: 289
diff changeset
15
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
16 This section gives an introduction into the basic internals of the email system in a low-technical language. It is intended to make the reader familiar with the essential concepts of email as they are essential throughout the thesis.
245
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
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
19 \subsubsection{Mail agents}
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
20 \index{mail agents}
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
21
378
c9a6cbce35fd inserted non-break spaces where appropriate
meillo@marmaro.de
parents: 376
diff changeset
22 This thesis will frequently use the three terms: \MTA, \MUA{}, and \MDA{}, naming the three different kinds of nodes of the email infrastructure. Here, they are explained with references to the ``snail mail'' system which is known from everyday life. Figure~\ref{fig:mail-agents} shows the relation between those three mail agents and the way an email message takes when passing through the system.
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
23
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
24 \begin{description}
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
25 \item[\MTA:]
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
26 \index{mta}
378
c9a6cbce35fd inserted non-break spaces where appropriate
meillo@marmaro.de
parents: 376
diff changeset
27 \name{Mail Transfer Agents} are the post offices for electronic mail. The basic job of an \MTA\ is to transport mail from senders to recipients, or more pedantic: from \MTA\ to \MTA. \sendmail, \exim, \qmail, \postfix, and, of course, \masqmail\ are \MTA{}s. \MTA{}s are explained in more detail in chapter~\ref{chap:mail-transfer-agents}.
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
28
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
29 \item[\MUA{}:]
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
30 \index{mua}
393
6494832a798c fixed all half-spaces after RF, RG, TODO
meillo@marmaro.de
parents: 392
diff changeset
31 \name{Mail User Agents} are the software users deal with. A user writes and reads email with it. The \MUA{} passes outgoing mail to the nearest \MTA. Also the \MUA{} displays the contents of the user's mailbox. Well known \MUA{}s are \name{Mozilla Thunderbird} and \name{mutt} on Unix systems, and \name{Microsoft Outlook} on \name{Windows}.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
32
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
33 \item[\MDA{}:]
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
34 \index{mda}
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
35 \name{Mail Delivery Agents} correspond to postmen in the real world. They receive mail, destined to recipients they are responsible for, from an \MTA, and deliver it to the mailboxes of those recipients. Many \MTA{}s include an own \MDA{}, but independent ones exist: \name{procmail} and \name{maildrop} are examples.
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
36 \end{description}
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
37 \index{procmail}
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
38
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
39 \begin{figure}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
40 \begin{center}
397
13e630c5a44d rename img -> fig
meillo@marmaro.de
parents: 396
diff changeset
41 \includegraphics[scale=0.75]{fig/mail-agents.eps}
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
42 \end{center}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
43 \caption{Mail agents and the way a mail message takes}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
44 \label{fig:mail-agents}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
45 \end{figure}
245
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
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
48
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
49
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
50
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
51
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
52 \subsubsection{Mail transfer with SMTP}
396
8ef85e22ff7d again lots of fixes and removed fixmes
meillo@marmaro.de
parents: 393
diff changeset
53 \label{smtp-intro}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
54
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
55 Today most of the email is transferred using the \name{Simple Mail Transfer Protocol} (short: \SMTP), which is defined in \RFC\,821 and the successors \RFC\,2821 and \RFC\,5321. A good entry point for further information is \citeweb{wikipedia:smtp}.
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
56 \index{smtp}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
57 \index{rfc}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
58
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
59 A selection of important concepts of \SMTP\ is explained here.
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
60 \index{smtp!concepts of}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
61
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
62 First the \name{store-and-forward} transfer concept. 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 stored for some time on each \MTA, until it is forwarded to the next \MTA.
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
63 \index{smtp!store-and-forward}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
64
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
65 This leads to the concept of \name{responsibility}. A mail message is always in the responsibility of one system. First it is the \MUA. When it is transferred to an \MTA, this \MTA\ takes over the responsibility for the message, too. The \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 \MDA{}---the message gets transferred and if the transfer was successful, the responsibility for the message is transferred as well. The responsibility chain ends at a user's mailbox where he himself has control on the message.
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
66 \index{mua}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
67 \index{mda}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
68 \index{smtp!responsibility}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
69
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
70 A third concept is about failure handling. At any step on the way an \MTA\ may receive a message it 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 for 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 or if the transfer still was unsuccessful after many tries.
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
71 \index{smtp!bouncing}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
72 \index{smtp!rejecting}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
73
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
74
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
75
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
76 \subsubsection{Mail messages}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
77
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
78 Mail messages consist of text in a specific format. This format is specified in \RFC\,822, and the successors \RFC\,2822 and \RFC\,5322.
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
79 \index{mail message}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
80 \index{rfc}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
81
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
82 A message has two parts, 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 message 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 recipient(s), the date, and possibly further information. Their order is irrelevant. Headers are named like the colon-separated start of those lines, for example the ``\texttt{Date:}'' header. A user may write the header himself but normally the \MUA{} does this job.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
83
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
84 The body is the payload of the message. It is under full control of the user. From the view point of the \SMTP\ protocol, it must consist of only 7-bit \NAME{ASCII} text. But arbitrary content can be included by encoding it to 7-bit \NAME{ASCII}. \NAME{MIME} is the common \SMTP\ extension to handle such conversion automatically in \MUA{}s.
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
85 \index{mua}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
86 \index{mime}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
87 \index{ascii}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
88
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
89 Following is a sample mail message with four header lines (\texttt{From:}, \texttt{To:}, \texttt{Date:}, and \texttt{Subject:}) and three lines of message body.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
90
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
91 \codeinput{input/sample-email.txt}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
92
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
93 Email messages are put into \name{envelopes} for transfer. This concept is also derived from the real world so it is easy to understand. The envelope 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 by \MTA{}s, usually from mail header data. The user has not to deal with them.
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
94
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
95 Each \MTA\ on the way reads envelopes it receives and generates new ones. If a message has recipients on different hosts, then the message gets copied and sent within multiple envelopes, one for each host.
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
96
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
97 The sample message would lead to two envelopes, one from \name{markus@host01} to \name{alice@host02}, the other from \name{markus@host01} to \name{bob@host03}. Both envelopes would contain the same message.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
98
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
99
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
100
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
101
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
102
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
103
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
104 \section{The \masqmail\ project}
102
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
105 \label{sec:masqmail}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
106
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
107 The \masqmail\ project was initiated by \person{Oliver Kurth} in 1999. His aim was to create a small \MTA\ that is especially focused on computers with dial-up Internet connections. Throughout the next four years he worked steadily on it, releasing new versions every few weeks. During the active phase of development 53 version have been released. In average, this is a new version every 20 days.
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
108 \index{masqmail}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
109 \index{dial-up}
102
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
110
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
111 This thesis is based on the latest release of \masqmail---version 0.2.21, dated November 2005. It was released after a 28 month gap of inactivity. The source code of 0.2.21 is the same as of 0.2.20, with only build documents modified. The homepage of \masqmail\ \citeweb{masqmail:homepage2} does not include this latest release, but it can be retrieved from the \name{Debian} package pool\footnote{The \NAME{URL} is:\\\url{http://ftp.de.debian.org/debian/pool/main/m/masqmail/masqmail_0.2.21.orig.tar.gz}} \citeweb{packages.debian}.
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
112 \index{debian!package pool}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
113
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
114 \masqmail\ is covered by the \name{General Public License} (short: \NAME{GPL}) version two or any later version \cite{fsf:gpl}. This qualifies \masqmail\ as Free Software \cite{fsf:freesw-definition}.
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
115 \index{gpl}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
116 \index{Free Software}
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
117
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
118 \person{Kurth} abandoned \masqmail\ after 2005 and no one adopted the project since then. Thus, the author of this thesis decided to take over responsibility for \masqmail\ now. He received \person{Kurth}'s permission to do so in private telephone conversation with \person{Kurth} on September 4, 2008.
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
119
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
120 The program's new homepage \citeweb{masqmail:homepage} includes a collection of available information about this \MTA.
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
121
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
122
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
123
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
124
366
80b2e476c2e3 a lot of cleanup
meillo@marmaro.de
parents: 320
diff changeset
125 \subsection{Target field}
266
ea538a366b7d added label
meillo@marmaro.de
parents: 261
diff changeset
126 \label{sec:masqmail-target-field}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
127
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
128 \person{Kurth}'s intention when creating \masqmail\ is best told in his own words:
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
129 \index{masqmail}
375
91eb129dd695 rework in ch02 mainly
meillo@marmaro.de
parents: 374
diff changeset
130
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
131 \begin{quote}
366
80b2e476c2e3 a lot of cleanup
meillo@marmaro.de
parents: 320
diff changeset
132 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 \NAME{ISP}s. It replaces sendmail or other \MTA{}s such as qmail or exim.
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
133 \hfill\citeweb{masqmail:homepage2}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
134 \end{quote}
375
91eb129dd695 rework in ch02 mainly
meillo@marmaro.de
parents: 374
diff changeset
135
366
80b2e476c2e3 a lot of cleanup
meillo@marmaro.de
parents: 320
diff changeset
136 It is intended to cover a specific niche: non-permanent Internet connection and different \name{Internet Service Providers} (short: \NAME{ISP}s).
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
137
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
138 Although it can basically replace other \MTA{}s it is not \emph{generally} aimed to do so. The package description of \masqmail\ within \name{Debian} states this more clearly by changing the last sentence to:
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
139 \index{debian!masqmail package}
375
91eb129dd695 rework in ch02 mainly
meillo@marmaro.de
parents: 374
diff changeset
140
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
141 \begin{quote}
366
80b2e476c2e3 a lot of cleanup
meillo@marmaro.de
parents: 320
diff changeset
142 In these cases, MasqMail is a slim replacement for full-blown \MTA{}s such as sendmail, exim, qmail or postfix.
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
143 \hfill\citeweb{packages.debian:masqmail}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
144 \end{quote}
375
91eb129dd695 rework in ch02 mainly
meillo@marmaro.de
parents: 374
diff changeset
145
406
1d527ad76c97 spell checking
meillo@marmaro.de
parents: 402
diff changeset
146 The program is a good replacement ``in these cases'' but not generally, since it lacks essential features for running on openly accessible mail servers. It is primarily not secure enough for being accessible from untrusted locations.
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
147
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
148 \masqmail\ is best used in home networks which are non-permanently connected to the Internet. It is easy configurable for situations which are rarely solvable with the common \MTA{}s. Such include different handling of mail to local or remote destination and respecting different routes of online connection. These features are explained in more detail in section~\ref{sec:masqmail-features}.
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
149 \index{non-permanent online connection}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
150
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
151 While many other \MTA{}s are general purpose \MTA{}s, \masqmail\ aims on special situations. Nevertheless, it can be used as general purpose \MTA, too. Especially this was a design goal of \masqmail: To be a replacement for \sendmail\ or similar \MTA{}s.
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
152 \index{masqmail}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
153 \index{sendmail}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
154
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
155 \masqmail\ is designed to run on workstations and on servers in small networks, like they are common in \NAME{SOHO}s (\name{Small Offices/Home Offices}).
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
156
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
157
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
158
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
159 \subsubsection*{Typical usage scenarios}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
160
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
161 This section describes three common setups that make sensible use of \masqmail. The first two are shown in figure~\ref{fig:masqmail-typical-usage}.
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
162 \index{masqmail!common setups}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
163
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
164 \begin{figure}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
165 \begin{center}
397
13e630c5a44d rename img -> fig
meillo@marmaro.de
parents: 396
diff changeset
166 \includegraphics[scale=0.75]{fig/masqmail-typical-usage.eps}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
167 \end{center}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
168 \caption{Typical usage scenarios for \masqmail}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
169 \label{fig:masqmail-typical-usage}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
170 \end{figure}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
171
375
91eb129dd695 rework in ch02 mainly
meillo@marmaro.de
parents: 374
diff changeset
172 Imagine an Internet-connected home network consisting of some workstations.
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
173
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
174 \begin{description}
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
175 \item[Scenario 1:]
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
176 \label{scenario1}
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
177 If no server is present, every workstation would be equipped with \masqmail. Mail transfer within the same machine or within the local net works straight forward using direct transfer. Outgoing mail to the Internet is sent to an \name{Internet Service Provider} (short: \NAME{ISP}) for relaying whenever the router goes online. The configuration of \masqmail\ would be the same on every computer; only host names would differ. To receive mail from the Internet requires a mailbox on the \NAME{ISP}'s mail server. Mail needs to be fetched from the \NAME{ISP}'s server onto the workstation using the \NAME{POP3} or \NAME{IMAP} protocol.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
178 \index{isp}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
179 \index{pop3}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
180 \index{imap}
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
181
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
182 \item[Scenario 2:]
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
183 \label{scenario2}
378
c9a6cbce35fd inserted non-break spaces where appropriate
meillo@marmaro.de
parents: 376
diff changeset
184 In the same network but with a server, one could have \masqmail\ running on the server and using simple forwarders (see section~\ref{subsec:relay-only}) on the workstations to transfer mail to the server. The server would then, dependent on the destination of the message, deliver locally or relay to an \NAME{ISP}'s server for further relay. This setup does only support mail transfer to the server but not back to a workstation. However, this can be solved by mounting the user's mailbox from the server to the workstation or by using \NAME{POP3} or \NAME{IMAP}. Mail transfer from the \NAME{ISP} to the local server needs \NAME{POP3} or \NAME{IMAP} as well.
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
185 \index{relay-only mta}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
186 \index{isp}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
187 \index{pop3}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
188 \index{imap}
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
189
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
190 \item[Scenario 3:]
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
191 \label{scenario3}
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
192 A third scenario is unrelated as it is about notebooks. Notebooks are usually used as mobile workstations. One uses them to work at different locations. With the increasing popularity of wireless networks this becomes more and more common. Different networks demand for different setups: In one network it is best to send mail to an \NAME{ISP} for relay. In another network it might be preferred to use a local mail server. A third network may have no Internet access at all, hence using a local mail server is required. All these different setups can be configured once and then used by simply telling the online state to \masqmail, even automatically within a network setup script.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
193 \index{isp}
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
194 \index{masqmail!on notebooks}
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
195 \end{description}
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
196
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
197
374
3445852ed736 applied comments by henry atting and jochen roth
meillo@marmaro.de
parents: 373
diff changeset
198 In general, all kinds of usage scenarios within a trusted network are possible. Important to notice is that mail can not be sent from outside into the trusted network then. For using \masqmail\ on notebooks it is suggested to only accept mail from local users because notebooks are often in untrusted environments.
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
199 \index{untrusted environment}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
200
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
201
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
202
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
203
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
204 \subsubsection*{Limitations}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
205 \index{masqmail!limitations}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
206
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
207 Although \masqmail\ is seen as a replacement for other general purpose \MTA{}s, it should not be used on large mail servers. The reasons are that it implements only a basic subset of features and that its performance and security is not as good as needed for such usage.
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
208
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
209 The author, \person{Kurth}, warns on the old project's website about using \masqmail\ to accept connections from the Internet because of the risk of being an open relay:
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
210 \index{open relay}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
211
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
212 \begin{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
213 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.
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
214 \hfill\citeweb{masqmail:homepage2}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
215 \end{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
216
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
217 The actual problem is not the permanent Internet connection but listening for incoming mail on it. If a firewall is closed for incoming mail, then the permanent Internet connection is no problem. To use \masqmail\ for permanent Internet connections it needs to be secured with care.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
218 \index{firewall}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
219
392
b4611d4e1484 applied comments by henry atting
meillo@marmaro.de
parents: 391
diff changeset
220 The Internet is the common example for an untrusted network but other networks may be untrusted, too.
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
221
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
222
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
223
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
224
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
225
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
226
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
227
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
228
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
229
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
230
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
231
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
232
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
233 \subsection{Features}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
234
374
3445852ed736 applied comments by henry atting and jochen roth
meillo@marmaro.de
parents: 373
diff changeset
235 This thesis regards version 0.2.21 of \masqmail. This is the last version released by \person{Oliver Kurth}.
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
236
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
237
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
238 \subsubsection*{The source code}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
239
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
240 \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 which contain about 9\,000 lines of code\footnote{Measured with \name{sloccount} by David A.\ Wheeler \citeweb{sloccount}.}. 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.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
241 \index{c}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
242 \index{lines of code}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
243 \index{base64}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
244 \index{md5}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
245 \index{libident}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
246
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
247 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.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
248 \index{glib}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
249 \index{masqmail!dependencies}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
250
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
251 Some parts of \masqmail's functionality can be included or excluded at compile time by defining symbols. To enable maildir support for example, one has to add \verb_--enable-maildir_ to the configure call. Otherwise the concerning code gets removed during preprocessing.
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
252 \index{conditional compilation}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
253 \index{maildir}
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
254
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
255 With \masqmail\ comes the small tool \path{mservdetect}; it helps setting up a configuration that uses the \name{mserver} system for online state detection. Two other binaries get compiled for testing purposes: \path{readtest} and \path{smtpsend}. These three additional programs use parts of \masqmail's source code; they only add a file with a \verb+main()+ function each.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
256 \index{mserver}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
257 \index{test program}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
258
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
259
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
260
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
261 \subsubsection*{Features}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
262 \label{sec:masqmail-features}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
263
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
264 \masqmail\ supports two channels for incoming mail:
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
265
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
266 \begin{enumerate}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
267 \item Standard input which is used when \path{masqmail} (or the \path{sendmail} link) is executed on the command line
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
268 \item A \NAME{TCP} socket which is used by local or remote clients that talk \SMTP
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
269 \end{enumerate}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
270 \index{sendmail!command}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
271 \index{tcp socket}
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
272
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
273 The outgoing channels for mail are:
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
274
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
275 \begin{enumerate}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
276 \item Direct delivery to local mailboxes (in \name{mbox} or \name{maildir} format)
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
277 \item Local pipes to pass mail to a program (e.g.\ to \MDA{}s or to gateways to \NAME{FAX} or \NAME{UUCP})
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
278 \item \NAME{TCP} sockets to transfer mail to other \MTA{}s using the \SMTP\ protocol
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
279 \end{enumerate}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
280 \index{tcp socket}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
281 \index{local delivery}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
282 \index{mbox}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
283 \index{maildir}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
284 \index{uucp}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
285 \index{fax}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
286 \index{gateway}
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
287 \index{mda}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
288 \index{pipe}
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
289
378
c9a6cbce35fd inserted non-break spaces where appropriate
meillo@marmaro.de
parents: 376
diff changeset
290 Figure~\ref{fig:masqmail-channels} shows this as a picture. (The ``online state'' input is explained a bit later.)
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
291
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
292 \begin{figure}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
293 \begin{center}
397
13e630c5a44d rename img -> fig
meillo@marmaro.de
parents: 396
diff changeset
294 \includegraphics[scale=0.75]{fig/masqmail-channels.eps}
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
295 \end{center}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
296 \caption{Incoming and outgoing channels of \masqmail}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
297 \label{fig:masqmail-channels}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
298 \end{figure}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
299
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
300 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}.
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
301 \index{openssl}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
302 \index{wrapper}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
303 \index{auth!smtp-auth}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
304 \index{auth!smtp-after-pop}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
305
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
306 Mail queuing is essential for \masqmail\ and thus supported of course, alias expansion is also supported.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
307 \index{alias expansion}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
308
400
5254a119ad56 fixed all major trashing of the right margin
meillo@marmaro.de
parents: 397
diff changeset
309 The \masqmail\ executable can be called by various names for sendmail-com\-pa\-ti\-bi\-li\-ty reasons. As many programs expect the \MTA\ to be located at \path{/usr/lib/sendmail} or \path{/usr/sbin/sendmail}, symbolic links are pointing from there to the \masqmail\ executable. Furthermore does \sendmail\ support calling it with a different name instead of supplying command line arguments. The best known of these 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 yet 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 strict requirements.} \path{hoststat} and \path{purgestat} are missing for complete sendmail-compatibility.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
310 \index{sendmail!compatibility}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
311
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
312 Additional to the \MTA\ job, \masqmail\ also offers mail retrieval services by acting as a \NAME{POP3} client. It can fetch mail from different remote locations, also dependent on the active online connection. Such functionality is especially useful in a setup like \name{Scenario 2} on page~\pageref{scenario2}.
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
313 \index{pop3}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
314
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
315
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
316
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
317 \subsubsection*{Online detection and online routes}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
318 \label{sec:masqmail-routes}
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
319 \index{online routes}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
320
275
003410b64739 new texts and rework in ch01: online routes, why masqmail
meillo@marmaro.de
parents: 269
diff changeset
321 \masqmail\ focuses on handling different 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. Mail to destinations outside the local network gets queued until a suitable online connections is available.
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
322 \index{non-permanent online connection}
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
323
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
324 The idea behind this concept is sending mail to the Internet through the mail server of the same \NAME{ISP} over which one had dialed in. It was quite common that \NAME{ISP}s accepted mail for relay only if it came from a online connection they managed. This means, it was not possible to relay mail through the mail server of one \NAME{ISP} while being online through the connection of another \NAME{ISP}. \masqmail\ is a solution to the wish of switching the relaying mail server easily.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
325 \index{isp}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
326
316
f3a86ce788ec spell checking
meillo@marmaro.de
parents: 306
diff changeset
327 Related is \masqmail's ability to rewrite the sender's email address dependent on which \NAME{ISP} is used. This prevents mail from being likely classified as spam.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
328 \index{spam}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
329
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
330 To react on the different situations, \masqmail\ needs to query the current online state. Is an online connection available? And if it is: Which one? Three methods are implemented:
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
331 \index{online state}
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
332
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
333 \begin{enumerate}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
334 \item Reading from a file
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
335 \item Reading the output of a command
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
336 \item Querying an \name{mserver} system
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
337 \end{enumerate}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
338 \index{mserver}
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
339
374
3445852ed736 applied comments by henry atting and jochen roth
meillo@marmaro.de
parents: 373
diff changeset
340 Each method may return a string naming the route that is online or returning nothing to indicate offline state.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
341
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
342
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
343 Mail for hosts inside the local network or for users on the local machine is not touched by this concept; such mail is always sent immediately.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
344
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
345
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
346
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
347
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
348
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
349
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
350
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
351
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
352 \section{Why \masqmail\ is worth it}
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
353 \index{masqmail}
275
003410b64739 new texts and rework in ch01: online routes, why masqmail
meillo@marmaro.de
parents: 269
diff changeset
354
406
1d527ad76c97 spell checking
meillo@marmaro.de
parents: 402
diff changeset
355 First of all, \masqmail\ is better suited for its target field of operation (multiple non-permanent online connections) than any other \MTA. Especially is such usage easy to set up because \masqmail\ was designed for it. Many alternative \MTA{}s were not designed for those scenarios as the following two example show: ``Exim is designed for use on a network where most messages can be delivered at the first attempt.'' \cite[page~30]{hazel01}. And: ``qmail was designed for well-connected hosts: those with high-speed, always-on network connectivity.'' \cite[page9]{sill02}.
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
356 \index{non-permanent online connection}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
357 \index{qmail}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
358 \index{exim}
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
359
406
1d527ad76c97 spell checking
meillo@marmaro.de
parents: 402
diff changeset
360 \masqmail\ make it easy to run an \MTA\ on workstations or notebooks. There is no need to do complex configuration or to be a mail server expert. Only a handful of options need to be set; the host name, the local networks, and one route for relaying are sufficient in most times.
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
361 \index{masqmail!on notebooks}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
362 \index{configuration}
275
003410b64739 new texts and rework in ch01: online routes, why masqmail
meillo@marmaro.de
parents: 269
diff changeset
363
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
364 Probably users say it best; in this case \person{Derek Broughton}:
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
365 \index{masqmail!users}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
366
284
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
367 \begin{quote}
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
368 No kidding. The whole point is that you \_have\_ to have an \MTA\ and you don't
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
369 want to configure Postfix/Exim/Sendmail/Qmail (almost all of which I've
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
370 actually done).
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
371
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
372 I now use masqmail -- it's really simple, my configuration is all in debconf,
284
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
373 it's supported by whereami, and it's really simple :-)
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
374
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
375 I'm sure you can make any \MTA\ behave nicely when offline, but it was a chore
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
376 with all of them.
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
377 \hfill\citeweb[post~\#8]{ubuntuforums:simple-mailer}
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
378 \end{quote}
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
379
378
c9a6cbce35fd inserted non-break spaces where appropriate
meillo@marmaro.de
parents: 376
diff changeset
380 Not to forget \masqmail's size. \masqmail\ is much smaller than full-blown \MTA{}s like \sendmail, \postfix, or \exim, and still smaller than \qmail. (See section~\ref{sec:mta-comparison} for details.) This makes \masqmail\ a good choice for workstations or even embedded computers.
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
381 \index{qmail}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
382
284
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
383 Again words of a user who chose \masqmail\ as \MTA\ on his old laptop with a 75 megahertz processor and eight megabytes of \NAME{RAM}:
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
384
284
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
385 \begin{quote}
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
386 Masqmail appears to be a great sendmail replacement in this case. It's small and is built to support sending mail ``off-line'', and to connecting to the \SMTP\ servers of several \NAME{ISP}s.
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
387 \hfill\citeweb{stosberg:low-mem-laptop}
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
388 \end{quote}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
389 \index{isp}
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
390 \index{sendmail}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
391 \index{masqmail!on notebooks}
284
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
392
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
393
408
ee7211546c02 added paragraph about hikernet; fixed some bib entries
meillo@marmaro.de
parents: 407
diff changeset
394 \masqmail\ is also used in a scientific project: \person{Wolfgang Leister} chose \masqmail\ for the prototype implementation of the \name{HikerNet} \cite{leister04}. The \name{HikerNet} is an ad-hoc network for peer-to-peer communication in otherwise network-less areas. Unfortunately, the usage of \masqmail\ for the prototype is not documented. The author of this thesis received the information in private email communication with \person{Leister} in October 2008. \person{Leister} stated, he chose \masqmail\ as email-to-hikernet gateway because it was well suited and easy to set up for this particular usage. Other \MTA{}s would have been possible choices, but it was easier with \masqmail.
ee7211546c02 added paragraph about hikernet; fixed some bib entries
meillo@marmaro.de
parents: 407
diff changeset
395 \index{HikerNet}
ee7211546c02 added paragraph about hikernet; fixed some bib entries
meillo@marmaro.de
parents: 407
diff changeset
396 \index{gateway}
284
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
397
406
1d527ad76c97 spell checking
meillo@marmaro.de
parents: 402
diff changeset
398
1d527ad76c97 spell checking
meillo@marmaro.de
parents: 402
diff changeset
399 Although the development of \masqmail\ has been stopped in 2003, \masqmail\ still has its users. Having users is already reason enough for further development and maintenance. This applies especially when the software covers a niche and when requirements for such software in general changed. Both is the case for \masqmail.
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
400
393
6494832a798c fixed all half-spaces after RF, RG, TODO
meillo@marmaro.de
parents: 392
diff changeset
401 It is difficult to get numbers about users of Free Software because no one needs to tell anyone when he uses some software. \name{Debian}'s \name{popcon} statistics \citeweb{popcon.debian} are a try to provided numbers. For January 2009, the statistics report 60 \masqmail\ installations of which 49 are in active use. If it is assumed that one third of all \name{Debian} users report their installed software\footnote{One third is a high guess as it means there would be only about 230 thousand \name{Debian} installations in total. But according to the \name{Linux Counter} \citeweb{counter.li.org} between 490 thousand and 12 million \name{Debian} users can be estimated.}, there would be in total around 150 active \masqmail\ installations in \name{Debian}. \name{Ubuntu} which also does \name{popcon} statistics \citeweb{popcon.ubuntu}, counts 82 installations with 13 active ones. If here also one third of all systems submit their data, 40 active installations can be added. Including a guessed amount of additional 30 installations on other Unix operating systems makes about 220 \masqmail\ installations in total. Of course one person may have \masqmail\ installed on more than one computer, but a total of 150 different users seems to be realistic.
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
402 \index{Free Software}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
403 \index{debian!popcon}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
404 \index{masqmail!users}
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
405 \index{Linux Counter}
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
406 \index{Unix}
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
407
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
408 One thing became clear now: \masqmail\ has users. And software that is used should be developed and maintained.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
409
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
410
275
003410b64739 new texts and rework in ch01: online routes, why masqmail
meillo@marmaro.de
parents: 269
diff changeset
411
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
412
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
413
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
414
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
415
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
416
175
aab8499c9f2f moved ch06s content into other chapters to remove it
meillo@marmaro.de
parents: 160
diff changeset
417
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
418
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
419
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
420 \section{Problems to solve}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
421 \index{masqmail!problems}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
422
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
423 A program that is neglected for more than five years in a field of operation that changed during this time surely needs improvement. Security and spam have highly increased in importance since 2003. Dial-up connections became rare, instead broadband flat rates are common now. Other \MTA{}s evolved in respect to theses changes---\masqmail\ did not.
402
e57129f57faa finished the indexing in a huge last effort
meillo@marmaro.de
parents: 400
diff changeset
424 \index{dial-up}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
425
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
426 The current market situation and trends for the future need to be identified. Looks at other \MTA{}s need to be taken. Required work on \masqmail\ needs to be defined in combination with the evaluation of strategies to do this work. And a plan for further development should be created.
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
427
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
428
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
429
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
430
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
431
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
432 \section{Delimitation}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
433
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
434 This thesis is neither a installation guide for \masqmail\ nor a detailed explanation of \masqmail's source code. Installation and setup guides can be found on \masqmail's homepage \citeweb{masqmail:homepage}.
275
003410b64739 new texts and rework in ch01: online routes, why masqmail
meillo@marmaro.de
parents: 269
diff changeset
435
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
436 The \NAME{POP3} functionality of \masqmail\ receives few regard in this document because it is not directly related to the core of \masqmail\ which is being an \MTA.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
437 \index{pop3}
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
438
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
439 The \name{mserver} system to query the online state is also only mentioned but not regarded further. It seems best to move this functionality into a separate program which is run through the shell command interface, anyway.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
440 \index{mserver}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
441
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
442
150
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 142
diff changeset
443