annotate thesis/tex/1-Introduction.tex @ 394:7d85fd0da3df

remove further shortcuts
author meillo@marmaro.de
date Sat, 07 Feb 2009 12:06:30 +0100
parents 6494832a798c
children 8ef85e22ff7d
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
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
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}\index{rfc} (short: \RFC{}s\index{rfc}) under management of the \name{Internet Engineering Task Force}\index{ietf} (short: \NAME{IETF}). \RFC{}s are highly technical documents and it is not required that the readers of this thesis are familiar with them.
306
7f33aa4eb791 added some last missing texts in ch01
meillo@marmaro.de
parents: 289
diff changeset
13
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
14 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
15
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 \subsubsection{Mail agents}
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
18 \index{mail agents}
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
19
378
c9a6cbce35fd inserted non-break spaces where appropriate
meillo@marmaro.de
parents: 376
diff changeset
20 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
21
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
22 \begin{description}
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
23 \item[\MTA:]
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
24 \index{mta}
378
c9a6cbce35fd inserted non-break spaces where appropriate
meillo@marmaro.de
parents: 376
diff changeset
25 \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
26
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
27 \item[\MUA{}:]
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
28 \index{mua}
393
6494832a798c fixed all half-spaces after RF, RG, TODO
meillo@marmaro.de
parents: 392
diff changeset
29 \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
30
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
31 \item[\MDA{}:]
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
32 \index{mda}
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
33 \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
34 \end{description}
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
35
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
36 \begin{figure}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
37 \begin{center}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
38 \includegraphics[scale=0.75]{img/mail-agents.eps}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
39 \end{center}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
40 \caption{Mail agents and the way a mail message takes}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
41 \label{fig:mail-agents}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
42 \end{figure}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
43
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
44
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
45
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
46
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
47
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
48
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
49 \subsubsection{Mail transfer with SMTP}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
50
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
51 Today most of the email is transferred using the \name{Simple Mail Transfer Protocol}\index{smtp} (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}.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
52
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
53 A selection of important concepts of \SMTP\index{smtp!concepts of} is explained here.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
54
374
3445852ed736 applied comments by henry atting and jochen roth
meillo@marmaro.de
parents: 373
diff changeset
55 First the \name{store and forward}\index{smtp!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.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
56
392
b4611d4e1484 applied comments by henry atting
meillo@marmaro.de
parents: 391
diff changeset
57 This leads to the concept of \name{responsibility}\index{smtp!responsibility}. A mail message is always in the responsibility of one system. First it is the \MUA\index{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.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
58
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
59 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}\index{smtp!rejecting} 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}\index{smtp!bouncing} 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.
245
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
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 \subsubsection{Mail messages}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
64
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
65 Mail messages\index{mail message} consist of text in a specific format. This format is specified in \RFC\,822, and the successors \RFC\,2822 and \RFC\,5322.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
66
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
67 A message has two parts, the \name{header}\index{mail message!header} and the \name{body}\index{mail message!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}\index{mail message!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
68
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
69 The body is the payload\index{mail message!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}\index{ascii} text. But arbitrary content can be included by encoding it to 7-bit \NAME{ASCII}. \NAME{MIME}\index{mime} is the common \SMTP\ extension to handle such conversion automatically in \MUA{}s.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
70
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
71 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
72
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
73 \codeinput{input/sample-email.txt}\index{mail message!example}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
74
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
75 Email messages are put into \name{envelopes}\index{mail message!envelope} 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
76
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
77 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
78
374
3445852ed736 applied comments by henry atting and jochen roth
meillo@marmaro.de
parents: 373
diff changeset
79 The sample message would lead to two envelopes\index{mail message!more 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
80
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
81
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
82
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
83
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
84
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
85
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
86 \section{The \masqmail\ project}
102
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
87 \label{sec:masqmail}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
88
373
d51894e48762 started indexing; mta -> MTA (many small changes)
meillo@marmaro.de
parents: 370
diff changeset
89 The \masqmail\ project\index{masqmail!the 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\index{dial-up}. 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.
102
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
90
393
6494832a798c fixed all half-spaces after RF, RG, TODO
meillo@marmaro.de
parents: 392
diff changeset
91 This thesis is based on the latest release of \masqmail---version 0.2.21, dated November 2005\index{masqmail!latest release}. 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}\index{masqmail!homepage} does not include this latest release, but it can be retrieved from the \name{Debian} package pool\index{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}.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
92
376
ef7db2d0f3a1 applied comments by joachim breitner
meillo@marmaro.de
parents: 375
diff changeset
93 \masqmail\ is covered by the \name{General Public License}\index{gpl} (short: \NAME{GPL}) version two or any later version \cite{fsf:gpl}. This qualifies \masqmail\ as Free Software\index{free software} \cite{fsf:freesw-definition}.
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
94
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
95 \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
96
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
97 The program's new homepage\index{masqmail!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
98
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
99
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
100
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
101
366
80b2e476c2e3 a lot of cleanup
meillo@marmaro.de
parents: 320
diff changeset
102 \subsection{Target field}
266
ea538a366b7d added label
meillo@marmaro.de
parents: 261
diff changeset
103 \label{sec:masqmail-target-field}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
104
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
105 \person{Kurth}'s intention when creating \masqmail\ is best told in his own words:\index{masqmail!design intention}
375
91eb129dd695 rework in ch02 mainly
meillo@marmaro.de
parents: 374
diff changeset
106
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
107 \begin{quote}
366
80b2e476c2e3 a lot of cleanup
meillo@marmaro.de
parents: 320
diff changeset
108 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
109 \hfill\citeweb{masqmail:homepage2}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
110 \end{quote}
375
91eb129dd695 rework in ch02 mainly
meillo@marmaro.de
parents: 374
diff changeset
111
366
80b2e476c2e3 a lot of cleanup
meillo@marmaro.de
parents: 320
diff changeset
112 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
113
393
6494832a798c fixed all half-spaces after RF, RG, TODO
meillo@marmaro.de
parents: 392
diff changeset
114 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:\index{debian!masqmail package}
375
91eb129dd695 rework in ch02 mainly
meillo@marmaro.de
parents: 374
diff changeset
115
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
116 \begin{quote}
366
80b2e476c2e3 a lot of cleanup
meillo@marmaro.de
parents: 320
diff changeset
117 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
118 \hfill\citeweb{packages.debian:masqmail}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
119 \end{quote}
375
91eb129dd695 rework in ch02 mainly
meillo@marmaro.de
parents: 374
diff changeset
120
91eb129dd695 rework in ch02 mainly
meillo@marmaro.de
parents: 374
diff changeset
121 The program is a good replacement ``in these cases'' but not generally, since it lacks essential features for running on publically accessable 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
122
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
123 \masqmail\ is best used in home networks which are non-permanently connected to the Internet\index{non-permanent}. 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}.
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
124
392
b4611d4e1484 applied comments by henry atting
meillo@marmaro.de
parents: 391
diff changeset
125 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.\index{masqmail!sendmail replacement}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
126
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
127 \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
128
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
129
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
130
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
131 \subsubsection*{Typical usage scenarios}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
132
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
133 This section describes three common setups that make sensible use of \masqmail. The first two are shown in figure~\ref{fig:masqmail-typical-usage}.\index{masqmail!common setups}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
134
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
135 \begin{figure}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
136 \begin{center}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
137 \includegraphics[scale=0.75]{img/masqmail-typical-usage.eps}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
138 \end{center}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
139 \caption{Typical usage scenarios for \masqmail}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
140 \label{fig:masqmail-typical-usage}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
141 \end{figure}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
142
375
91eb129dd695 rework in ch02 mainly
meillo@marmaro.de
parents: 374
diff changeset
143 Imagine an Internet-connected home network consisting of some workstations.
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
144
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
145 \begin{description}
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
146 \item[Scenario 1:]
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
147 \label{scenario1}
375
91eb129dd695 rework in ch02 mainly
meillo@marmaro.de
parents: 374
diff changeset
148 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.
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
149 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
150 \index{isp}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
151 \index{pop3}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
152 \index{imap}
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
153
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
154 \item[Scenario 2:]
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
155 \label{scenario2}
378
c9a6cbce35fd inserted non-break spaces where appropriate
meillo@marmaro.de
parents: 376
diff changeset
156 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.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
157 \index{isp}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
158 \index{pop3}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
159 \index{imap}
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
160
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
161 \item[Scenario 3:]
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
162 \label{scenario3}
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
163 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
164 \index{isp}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
165 \index{notebook}
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
166 \end{description}
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
167
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
168
374
3445852ed736 applied comments by henry atting and jochen roth
meillo@marmaro.de
parents: 373
diff changeset
169 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.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
170 \index{untrusted environments}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
171
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
172
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
173
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
174
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
175 \subsubsection*{Limitations}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
176 \index{masqmail!limitations}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
177
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
178 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
179
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
180 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
181 \index{open relay}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
182
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
183 \begin{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
184 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
185 \hfill\citeweb{masqmail:homepage2}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
186 \end{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
187
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
188 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
189 \index{firewall}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
190
392
b4611d4e1484 applied comments by henry atting
meillo@marmaro.de
parents: 391
diff changeset
191 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
192
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
193
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
194
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
195
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
196
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
197
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
198
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
199
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
200
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
201
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
202
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
203
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
204 \subsection{Features}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
205
374
3445852ed736 applied comments by henry atting and jochen roth
meillo@marmaro.de
parents: 373
diff changeset
206 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
207
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
208
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
209 \subsubsection*{The source code}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
210
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
211 \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
212 \index{c}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
213 \index{lines of code}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
214 \index{base64}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
215 \index{md5}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
216 \index{libident}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
217
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
218 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
219 \index{glib}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
220 \index{masqmail!dependencies}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
221
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
222 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.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
223 \index{exclude code}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
224 \index{maildir}
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
225
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
226 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
227 \index{mserver}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
228 \index{test program}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
229
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
230
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
231
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
232 \subsubsection*{Features}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
233 \label{sec:masqmail-features}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
234
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
235 \masqmail\ supports two channels for incoming mail:
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
236 \index{masqmail!incoming channels}
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
237
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
238 \begin{enumerate}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
239 \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
240 \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
241 \end{enumerate}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
242 \index{sendmail!command}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
243 \index{tcp socket}
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
244
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
245 The outgoing channels for mail are:
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
246
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
247 \begin{enumerate}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
248 \item Direct delivery to local mailboxes (in \name{mbox} or \name{maildir} format)
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
249 \item Local pipes to pass mail to a program (e.g.\ to \MDA{}s or to gateways to \NAME{UUCP} or fax)
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
250 \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
251 \end{enumerate}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
252 \index{tcp socket}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
253 \index{local delivery}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
254 \index{mbox}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
255 \index{maildir}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
256 \index{uucp}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
257 \index{fax}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
258 \index{gateway}
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
259
378
c9a6cbce35fd inserted non-break spaces where appropriate
meillo@marmaro.de
parents: 376
diff changeset
260 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
261
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
262 \begin{figure}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
263 \begin{center}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
264 \includegraphics[scale=0.75]{img/masqmail-channels.eps}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
265 \end{center}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
266 \caption{Incoming and outgoing channels of \masqmail}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
267 \label{fig:masqmail-channels}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
268 \index{figure!incoming and outgoing channels of \masqmail}
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
269 \end{figure}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
270
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
271 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}.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
272 \index{auth!smtp-auth}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
273 \index{auth!smtp-after-pop}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
274
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
275 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
276 \index{alias expansion}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
277
376
ef7db2d0f3a1 applied comments by joachim breitner
meillo@marmaro.de
parents: 375
diff changeset
278 The \masqmail\ executable can be called by various names for sendmail-compatibility 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
279 \index{sendmail!compatibility}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
280 \index{symbolic link}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
281 \index{shortcuts}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
282
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
283 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
284 \index{pop3}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
285
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
286
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
287
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
288 \subsubsection*{Online detection and online routes}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
289 \label{sec:masqmail-routes}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
290 \index{masqmail!online routes}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
291
275
003410b64739 new texts and rework in ch01: online routes, why masqmail
meillo@marmaro.de
parents: 269
diff changeset
292 \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.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
293 \index{non-permanent}
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
294
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
295 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
296 \index{isp}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
297
316
f3a86ce788ec spell checking
meillo@marmaro.de
parents: 306
diff changeset
298 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
299 \index{spam}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
300
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
301 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
302 \index{online state}
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
303
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
304 \begin{enumerate}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
305 \item Reading from a file
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
306 \item Reading the output of a command
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
307 \item Querying an \name{mserver} system
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
308 \end{enumerate}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
309 \index{mserver}
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
310
374
3445852ed736 applied comments by henry atting and jochen roth
meillo@marmaro.de
parents: 373
diff changeset
311 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
312
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
313
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
314 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
315
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
316
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
317
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
318
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
319
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
320
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
321
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
322
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
323 \section{Why \masqmail\ is worth it}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
324 \index{masqmail!reasons to revive}
275
003410b64739 new texts and rework in ch01: online routes, why masqmail
meillo@marmaro.de
parents: 269
diff changeset
325
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
326 First of all, \masqmail\ is better suited for its target field of operation (multiple non-permanent online connections) than every other \MTA. Especially is such usage easy to set up because \masqmail\ was designed for that. Many alternative \MTA{}s were not designed for those scenarios at all 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}. ``qmail was designed for well-connected hosts: those with high-speed, always-on network connectivity.'' \cite[page9]{sill02}.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
327 \index{non-permanent}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
328 \index{qmail}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
329 \index{exim}
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
330
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
331 %fixme: hikernet
275
003410b64739 new texts and rework in ch01: online routes, why masqmail
meillo@marmaro.de
parents: 269
diff changeset
332
316
f3a86ce788ec spell checking
meillo@marmaro.de
parents: 306
diff changeset
333 Additionally does \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. %fixme: is that true?
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
334 \index{notebook}
275
003410b64739 new texts and rework in ch01: online routes, why masqmail
meillo@marmaro.de
parents: 269
diff changeset
335
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
336 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
337 \index{masqmail!users}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
338
284
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
339 \begin{quote}
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
340 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
341 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
342 actually done).
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
343
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
344 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
345 it's supported by whereami, and it's really simple :-)
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
346
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
347 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
348 with all of them.
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
349 \hfill\citeweb[post~\#8]{ubuntuforums:simple-mailer}
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
350 \end{quote}
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
351
378
c9a6cbce35fd inserted non-break spaces where appropriate
meillo@marmaro.de
parents: 376
diff changeset
352 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.
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
353
284
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
354 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
355
284
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
356 \begin{quote}
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
357 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
358 \hfill\citeweb{stosberg:low-mem-laptop}
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
359 \end{quote}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
360 \index{isp}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
361 \index{notebook}
284
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
362
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
363
284
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
364
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
365 Although the development on \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
366
393
6494832a798c fixed all half-spaces after RF, RG, TODO
meillo@marmaro.de
parents: 392
diff changeset
367 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.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
368 \index{debian!popcon}
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
369 \index{masqmail!users}
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
370
286
980eb42256ff improved user estimation
meillo@marmaro.de
parents: 284
diff changeset
371 %The increasing number of systems using \masqmail, as it is shown on the \name{popcon} graph \citeweb{popcon.debian:masqmail}, seems to be impressive in the beginning as \masqmail\ was not developed during that time. But it might come from the increasing popularity of \name{popcon} over the time.
284
591217f50f69 rework on why masqmail is worthy
meillo@marmaro.de
parents: 275
diff changeset
372
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
373 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
374
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
375
275
003410b64739 new texts and rework in ch01: online routes, why masqmail
meillo@marmaro.de
parents: 269
diff changeset
376 % alternative: http://anfi.homeunix.org/sendmail/dialup10.html
003410b64739 new texts and rework in ch01: online routes, why masqmail
meillo@marmaro.de
parents: 269
diff changeset
377
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
378
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
379
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
380
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
381
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
382
175
aab8499c9f2f moved ch06s content into other chapters to remove it
meillo@marmaro.de
parents: 160
diff changeset
383
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
384
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
385
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
386 \section{Problems to solve}
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
387 \index{masqmail!problems}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
388
370
664716b256e1 applied changes that were suggested by schaeffter
meillo@marmaro.de
parents: 369
diff changeset
389 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.
391
16d8eacf60e1 created index (it is not finished)
meillo@marmaro.de
parents: 378
diff changeset
390 \index{dial-up connections}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
391
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
392 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
393
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
394
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
395
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
396
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
397
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
398 \section{Delimitation}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
399
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
400 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
401
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
402 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
403 \index{pop3}
369
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
404
63fb9fba6c77 various cleanup
meillo@marmaro.de
parents: 366
diff changeset
405 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
406 \index{mserver}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
407
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
408
150
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 142
diff changeset
409