annotate thesis/tex/1-Introduction.tex @ 259:5db159540ba8

moved some text
author meillo@marmaro.de
date Wed, 14 Jan 2009 12:28:06 +0100
parents f4966e84815d
children 4931d56b61ea
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
26
fb9ba63f6957 changed to new thesis structure; moved text pieces away; updated project plan
meillo@marmaro.de
parents:
diff changeset
1 \chapter{Introduction}
42
ac4ce4de4154 minor stuff
meillo@marmaro.de
parents: 34
diff changeset
2 \label{chap:introduction}
26
fb9ba63f6957 changed to new thesis structure; moved text pieces away; updated project plan
meillo@marmaro.de
parents:
diff changeset
3
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
4 << say what you want to say >>
27
433df94d5476 added pices to thesis ... need rework!
meillo@marmaro.de
parents: 26
diff changeset
5
102
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
6 << the overall goal of the document >>
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
7
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
8
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
9
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
10
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
11
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
12
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
13 \section{Email prerequisites}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
14
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
15 email and everything is defined in RFCs
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
16
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
17
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
18 \subsubsection{Mail agents}
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
19
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
20 This thesis will frequently use the three terms: \MTA, \NAME{MUA}, and \NAME{MDA}. The name the three different kinds of software on which the email system depends. Here they are explained with references to the snail mail system one knows from everyday's life. Figure \ref{fig:mail-agents} shows the relation between them and the way an email message takes trough the system.
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
21
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
22 \paragraph{MTA}
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
23 \name{Mail Tranfer Agents} are for electronic mail what post offices are for snail mail. The basic job of an \MTA\ is to transport mail from senders to recipients, or more pedantic: from \MTA\ to \MTA. This is the definition of such kind of software, and this is how \MTA{}s are generally seen \cite[page 19]{dent04} \cite[pages 3-5]{hafiz05}. \MTA{}s are explained in more detail in chapter \ref{chap:mail-transfer-agents}.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
24
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
25
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
26 \paragraph{MUA}
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
27 \name{Mail User Agents} are the software the user deals with. He writes and reads email with it. The \NAME{MUA} passes outgoing mail to the nearest \MTA, and the \NAME{MUA} displays the contents of the user's mailbox. Well known \NAME{MUA}s are \name{Mozilla Thunderbird} and \name{mutt} on \unix\ systems, and \name{Microsoft Outlook} on \name{Windows}.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
28
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
29
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
30 \paragraph{MDA}
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
31 \name{Mail Delivery Agents} correspond to postmen in the real world. They receive mail, destinated to recipients they are responsible for, from an \MTA, and deliver it to the mailboxes of those recipients. Many \MTA{}s include an own \NAME{MDA}, but specialized ones exist: \name{procmail} and \name{maildrop} are examples.
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
32
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
33 \begin{figure}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
34 \begin{center}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
35 \includegraphics[scale=0.75]{img/mail-agents.eps}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
36 \end{center}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
37 \caption{Mail agents and the way a mail message takes}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
38 \label{fig:mail-agents}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
39 \end{figure}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
40
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
41
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
42
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
43
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
44
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
45
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
46 \subsubsection{Mail transfer with SMTP}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
47
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
48 Today most of the email is transfered using the \name{Simple Mail Transfer Protocol} (short: \SMTP), which is defined in \RFC821 and the successors \RFC2821 and \RFC5321. A good entry point for further information is \citeweb{wikipedia:smtp}.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
49
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
50 A selection of important concepts of \SMTP\ is explained here.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
51
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
52 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 gets 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
53
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
54 This leads to the concept of \name{responsibility}. A mail message is always in the responsibility of one system. First it is the \NAME{MUA}. After it was transfered to the first \MTA, it takes the responsibility for the message over. The \NAME{MUA} can then delete its copy of the message. This is the same for each transfer, from \MTA\ to \MTA\ and finally from \MTA\ to the \NAME{MDA}, the message gets transfered and if the transfer was successful, the responsibility for the message is transfered 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
55
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
56 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.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
57
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
58
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
59
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
60 \subsubsection{Mail messages}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
61
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
62 Mail messages consist of two parts with defined format. This format is specified in \RFC822, and the successors \RFC2822 and \RFC5322.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
63
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
64 The two parts of a message are 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 address(es) of the recipient(s), the date, and possibly further information. Their order is irrelevant. Headers are named after the colon separated start of those lines, for example the ``\texttt{Date:}'' header. A user may write the header himself, but normally the \NAME{MUA} does this job.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
65
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
66 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 convertion automatically in \NAME{MUA}s.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
67
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
68 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
69
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
70 \input{input/sample-email.txt}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
71
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
72 Email messages are put into envelopes for transfer. This concept is derived from the real world, so it is easy to understand. The envelope is what is used to route the message from sender to recipient. It contains the sender's address and addresses of one or more recipients. Envelopes are generated by \MTA{}s, usually by using mail header data. The user has not to deal with them.
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
73
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
74 The sample message would 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. There is no difference to how it would be done for snail mail.
245
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
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
77
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
78
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
79
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
80
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
81 \section{The \masqmail\ project}
102
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
82 \label{sec:masqmail}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
83
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
84 The \masqmail\ project was 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. Thoughout the next four years, he worked steadily on it, releasing new versions very few weeks. In total it were 53 releases, which means a new version in less than every 20 days in average.
102
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
85
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
86 This thesis bases on the latest release of \masqmail\ that was found---version 0.2.21 from November 2005. It was a release without source code changes to 0.2.20; only build documents were changed. One may retrieve it from the \debian\ package pool\footnote{The distribution tarball of \masqmail\ version 0.2.21 is located at: \url{http://ftp.de.debian.org/debian/pool/main/m/masqmail/masqmail\_0.2.21.orig.tar.gz}\,.} \citeweb{debian:packages}. It probably was never put into public anywhere else, including its homepage \citeweb{masqmail:homepage2}.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
87
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
88 \masqmail\ is covered by the \name{General Public License} (short: \GPL), which qualifies it as \freesw.
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
89
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
90 \person{Kurth} abandonned \masqmail\ after 2005, and no one addopted the project since then. Thus, the author of this thesis decided to take responsibility for \masqmail\ now. He received \person{Kurth}'s permission to do so.
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
91
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
92 The program's new homepage is a collection of available information about this \MTA\ \citeweb{masqmail:homepage}.
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
93
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
94
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
95
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
96
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
97 \subsection{Target field of \masqmail}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
98
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
99 The intention \person{Kurth} had when creating \masqmail\ is best told in his own words:
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
100 \begin{quote}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
101 MasqMail is a mail server designed for hosts that do not have a permanent internet connection eg. a home network or a single host at home. It has special support for connections to different ISPs. It replaces sendmail or other MTAs such as qmail or exim.
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
102 \hfill\citeweb{masqmail:homepage2}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
103 \end{quote}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
104 It is inteded to cover a specific niche: non-permanent internet connection and different \NAME{ISP}s.
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
105
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
106 Although it can basically replace other \MTA{}s, it is not \emph{generally} aimed to do so. The package description of \debian\ states this more clearly by changing the last sentence to:
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
107 \begin{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
108 In these cases, MasqMail is a slim replacement for full-blown MTAs such as sendmail, exim, qmail or postfix.
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
109 \hfill\citeweb{packages.debian:masqmail}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
110 \end{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
111 The program is a good replacement ``in these cases'', but not generally, since is lacks essential features for running on mail servers. It is primarily not secure enough for being accessable from untrusted locations.
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
112
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
113 \masqmail\ is best used in home networks, which are non-permanently connected to the Internet. It is easy configurable for situations which are rarely solveable with the common \MTA{}s. Such include different handling of mail to local or remote destination and respecting different routes of being online connection. These features are explained in more detail in the following \name{Features} section on page \ref{sec:masqmail-features}. %fixme: is it still called ``features''?
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
114
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
115 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 well known \MTA{}s.
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
116
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
117 \masqmail\ is designed to run on workstations and on servers in small networks, like home networks.
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
118
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
119
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
120
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
121 \subsubsection*{A typical usage scenario}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
122
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
123 This section describes two common setups that makes senseful use of \masqmail.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
124
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
125 Imagine a home network consisting of some workstations without a server. The network is connected to the internet by dial-up or broadband. Going online is initiated by computers inside the local network. \NAME{IP} addresses change at least once every day.
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
126
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
127 Every workstation would be equiped with \masqmail. Mail transfer within the same machine or within the local net works straight forward using direkt transfer. Outgoing mail to the internet is sent, to an \name{Internet Service Provider} (short: \NAME{ISP}) for relaying whenever the router goes online. 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. The configuration of \masqmail\ would be the same on every computer, except different hostnames.
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
128
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
129 In the same network but with a server, one could have \masqmail\ running on the server and using simple forwarders (see \ref{subsec:relay-only}) on the workstations to tranfer mail to the server. The server would then deliver locally or relay to an \NAME{ISP}'s server for further relay, dependent on the destination of the message. This setup does only support mail transfer to the server, but not back to a workstation. This transfer from the server to the workstations can be solvable by mounting the users mailbox from the server to the workstation, or by making the workstations fetch mail from the server.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
130
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
131 %fixme: what about notebooks?
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
132 << notebooks >>
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
133
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
134 Figure \ref{fig:masqmail-typical-usage} despicts the two scenarios.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
135
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
136 \begin{figure}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
137 \begin{center}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
138 \includegraphics[scale=0.75]{img/masqmail-typical-usage.eps}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
139 \end{center}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
140 \caption{Typical usage scenarios for \masqmail}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
141 \label{fig:masqmail-typical-usage}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
142 \end{figure}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
143
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
144 In general, all kinds of usage scenarios within a trusted network are possible.
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
145
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
146
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
147
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
148
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
149 \subsubsection*{Limitations}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
150
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
151 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, also its performance and security are not as good as provided by alternative \MTA{}s.
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
152
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
153 The author, \person{Kurth}, warns on the old project's website about using it to accept connections from the Internet, because of the risk of being an open relay:
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
154
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
155 \begin{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
156 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
157 \hfill\citeweb{masqmail:homepage2}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
158 \end{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
159
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
160 Even if some relay control will be added, ``is not designed to'' is a clear indicator for being careful. Issues like high memory consumption, low performance, and denial-of-service attacks---things not regarded by design---may cause serious problems.
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
161
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
162 Hence, \masqmail\ should not be used for permanent internet connections. Or at least it needs to be secured with care.
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
163
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
164
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
165
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
166
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
167
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
168
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
169
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
170
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
171
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
172
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
173
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
174
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
175 \subsection{Features}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
176
248
724cc6057105 complete names are now in small caps
meillo@marmaro.de
parents: 245
diff changeset
177 Here regarded is version 0.2.21 of \masqmail. This is the last version released by \person{Oliver Kurth}, and the basis for my thesis.
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
178
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
179
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
180 \subsubsection*{The source code}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
181
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
182 \masqmail\ is written in the C programming language. The program, as of version 0.2.21, consists of 34 source code and eight header files, containing about 9,000 lines of code\footnote{Measured with \name{sloccount} by David A.\ Wheeler.}. Additionally, it includes a \name{base64} implementation (about 300 lines) and \name{md5} code (about 150 lines). For systems that do not provide \name{libident}, this library is distributed as well (circa 600 lines); an available shared library has higher precedence in linking, though.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
183
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
184 The only mandatory dependency is \name{glib}---a cross-platform software utility library, originated in the \NAME{GTK+} project. It provides safe replacements for many standard library functions, especially for the string functions. It also offers handy data containers, easy-to-use implementations of data structures, and much more.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
185
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
186 With \masqmail\ comes the small tool \path{mservdetect}; it helps setting up a configuration that uses the \name{mserver} system to detect the online state. Two other binaries get compiled for testing purposes: \path{readtest} and \path{smtpsend}. All three programs use \masqmail\ source code; they only add a file with a \verb+main()+ function each.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
187
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
188
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
189
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
190 \subsubsection*{Features}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
191 \label{sec:masqmail-features}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
192
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
193 \masqmail\ supports two channels for incoming mail: (1) Standard input, used when \path{masqmail} is executed on the command line and (2) a \NAME{TCP} socket, used by local or remote clients that talk \SMTP. The outgoing channels for mail are: (1) direct delivery to local mailboxes (in \name{mbox} or \name{maildir} format), (2) local pipes to pass mail to a program (e.g.\ gateways to \NAME{UUCP}, gateways to fax, or \NAME{MDA}s), and (3) \NAME{TCP} sockets to transfer mail to other \MTA{}s using the \SMTP\ protocol.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
194
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
195 Outgoing \SMTP\ connections feature \SMTP-\NAME{AUTH} and \SMTP-after-\NAME{POP} authentication, but incoming connections do not. Using wrappers for outgoing connections is supported. This allows encrypted communication through a gateway application like \name{openssl}.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
196
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
197 Mail queuing and alias expansion is both supported.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
198
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
199 \masqmail\ focuses on non-permanent online connections, thus a concept of online routes is used. One may configure any number of routes to send mail. Each route can have criteria to determine if some message is allowed to be sent over it. This concept is explained in section \ref{sec:masqmail-routes} in detail. Mail to destinations outside the local network gets queued until an online connections is available.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
200
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
201 The \masqmail\ executable can be called under various names for sendmail-compatibility reasons. This is organized by symbolic links with different names pointing to the \masqmail\ executable. The \sendmail\ names are \path{/usr/lib/sendmail} and \path{/usr/sbin/sendmail} because many programs expect the \mta\ to be located there. Further more \sendmail\ supports calling it with a different name instead of supplying command line arguments. The best known of this shortcuts is \path{mailq}, which is equivalent to calling it with the argument \verb+-bq+. \masqmail\ recognizes the shortcuts \path{mailq}, \path{smtpd}, \path{mailrm}, \path{runq}, \path{rmail}, and \path{in.smtpd}. The first two are inspired by \sendmail. Not implemented is the shortcut \path{newaliases} because \masqmail\ does not generate binary representations of the alias file.\footnote{A shell script named \path{newaliases}, that invokes \texttt{masqmail -bi}, can provide the command to satisfy other software needing it.} \path{hoststat} and \path{purgestat} are missing for complete sendmail-compatibility.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
202 %masqmail: mailq, mailrm, runq, rmail, smtpd/in.smtpd
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
203 %sendmail: hoststat, mailq, newaliases, purgestat, smtpd
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
204
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
205 Additional to the \mta\ job, \masqmail\ also offers mail retrieval services by being a \NAME{POP3} client. It can fetch mail from different remote locations, dependent on the active online connection.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
206
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
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
209 \subsubsection*{Online detection and routes}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
210 \label{sec:masqmail-routes}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
211
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
212 \masqmail\ queues mail for destinations outside the local network if no connection to the internet is online. If the machine goes online, this mail is sent. Mail to local machines is sent immediately.
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
213
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
214 \masqmail\ sends mail to local destinations, like users on the same machine and on other machines in the local net, immediately. Email to recipients outside the local net are queued when offline and sent when a online connection gets established.
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
215
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
216 Further more does \masqmail\ respect online connections through different \NAME{ISP}s; a common thing for dial-up connections. In particular can different sender addresses be set, dependent on the \NAME{ISP} that is used. This prevents mail to be likely classified as spam.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
217 ---
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
218
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
219 As \masqmail\ is focused on non-permanent Internet connections, online state can be queried by three methods: reading from a file, reading the output of a command, or by asking an \name{mserver}. Each method may return a string indicating one of the available routes being online, or returning nothing to indicate offline state.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
220
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
221 Delivery to recipients on the local host or in local nets is done at once; delivery to recipients on the Internet is only done when being online, and queued otherwise. Each online route may have a different mail server to which mail is relayed. Return address headers are modified appropriate if wished.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
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 \masqmail\ focuses on non-permanent online connections, thus a concept of online routes is used. One may configure any number of routes to send mail. Each route can have criteria, like matching \texttt{From:} or \texttt{To:} headers, to determine if some message is allowed to be sent over it. Mail to destinations outside the local network gets queued until an online connections is available.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
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
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
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
233
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
234
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
235
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
236 \section{Why \masqmail?}
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
237
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
238 As main advantage, \masqmail\ makes it easy to set up an \MTA\ on workstations or notebooks without the need to do complex configuration or to be an mail server expert.
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
239
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
240 Workstations use %FIXME
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
241
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
242 \textbf{Alternatives?}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
243 http://anfi.homeunix.org/sendmail/dialup10.html
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
244
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
246 << explain why masqmail is old and why it is interesting/important however! >>
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
247
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
248 << why is it worth to revive masqmail? >>
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
249
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
250
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
251
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
252
175
aab8499c9f2f moved ch06s content into other chapters to remove it
meillo@marmaro.de
parents: 160
diff changeset
253
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
254
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
255
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
256 \section{Problems to solve}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
257
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
258 << what problems has masqmail? >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
259
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
260 << what's the intention of this document? >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
261
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
262 << why is it worth the effort? >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
263
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
264
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
265
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
266
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
267
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
268 \section{Delimitation}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
269
150
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 142
diff changeset
270 << limit against stuff not covered here >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
271
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
272
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
273
150
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 142
diff changeset
274