annotate thesis/tex/1-Introduction.tex @ 274:56cc2f5755f8

cleardoublepage -> clearpage (as the document is single sided)
author meillo@marmaro.de
date Thu, 15 Jan 2009 12:35:19 +0100
parents ddfb228a62a4
children 003410b64739
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
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
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 that are the nodes of the email infrastructure. Here they are explained with references to the snail mail system which is known from everyday's life. Figure \ref{fig:mail-agents} shows the relation between those three mail agents and the way an email message takes trough 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:]
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
24 \name{Mail Tranfer 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
25
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
26 \item[\NAME{MUA}:]
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
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. Also 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
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
29 \item[\NAME{MDA}:]
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
30 \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.
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
31 \end{description}
253
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
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
70 \codeinput{input/sample-email.txt}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
71
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
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 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.
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
73
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
74 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
75
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
76 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.
245
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
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
79
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
80
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
81
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
82
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
83 \section{The \masqmail\ project}
102
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
84 \label{sec:masqmail}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
85
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
86 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. Throughout the next four years, he worked steadily on it, releasing new versions every few weeks. In total it were 53 releases, which is in average a new version every 20 days.
102
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
87
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
88 This thesis bases on the latest release of \masqmail---version 0.2.21 from November 2005. It was released after a 28 month gap. The source code of 0.2.21 is the same as of 0.2.20, only build documents were modified. The release tarball can be retrieved from the \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{debian:packages}. Probably was only put into public in the \debian\ pool because \masqmail's homepage \citeweb{masqmail:homepage2} does not include it.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
89
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
90 \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
91
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
92 \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
93
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
94 The program's new homepage \citeweb{masqmail:homepage} is a collection of available information about this \MTA.
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
95
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
96
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
97
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 \subsection{Target field of \masqmail}
266
ea538a366b7d added label
meillo@marmaro.de
parents: 261
diff changeset
100 \label{sec:masqmail-target-field}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
101
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
102 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
103 \begin{quote}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
104 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
105 \hfill\citeweb{masqmail:homepage2}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
106 \end{quote}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
107 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
108
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
109 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
110 \begin{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
111 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
112 \hfill\citeweb{packages.debian:masqmail}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
113 \end{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
114 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
115
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
116 \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
117
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
118 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
119
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
120 \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
121
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
122
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
123
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
124 \subsubsection*{Typical usage scenarios}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
125
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
126 This section describes three common setups that makes senseful use of \masqmail. The first two are shown in figure \ref{fig:masqmail-typical-usage}.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
127
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
128 \begin{figure}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
129 \begin{center}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
130 \includegraphics[scale=0.75]{img/masqmail-typical-usage.eps}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
131 \end{center}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
132 \caption{Typical usage scenarios for \masqmail}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
133 \label{fig:masqmail-typical-usage}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
134 \end{figure}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
135
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
136 Imagine a home network consisting of some workstations which is connected to the Internet.
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
137
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
138 \begin{description}
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
139 \item[Scenario 1:]
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
140 If no server is present, 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. The configuration of \masqmail\ would be the same on every computer, except different hostnames.
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
141 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.
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
142
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
143 \item[Scenario 2:]
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
144 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, dependent on the desination 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, it can be solved by mounting the users mailbox from the server to the workstation, or by using the \NAME{POP3} or \NAME{IMAP} protocol to fetch the mail in the server's mailbox from the workstations. Mail transfer from the \NAME{ISP} to the local server needs \NAME{POP3} or \NAME{IMAP} as well.
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
145
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
146 \item[Scenario 3:]
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
147 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 gets more and more common. Different networks have different setups: In one network it is best to send mail to an \NAME{ISP} for relay. In another network it might be prefered 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.
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
148 \end{description}
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
149
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
150
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
151
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
152 In general, all kinds of usage scenarios within a trusted network are possible. Important to notice is that mail can not be send 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. This limitation leads to the next section.
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
153
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
154
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
155
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
156
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
157 \subsubsection*{Limitations}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
158
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
159 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 are not as needed for such usage.
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
160
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
161 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:
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
162
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
163 \begin{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
164 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
165 \hfill\citeweb{masqmail:homepage2}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
166 \end{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
167
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
168 The actual problem is not the permanent Internet connection, but listening for incomming mail on it. If a firewall is closed for incoming mail, then the permanent Internet connection is no problem. \masqmail\ should not be used for permanent internet connections. Or at least it needs to be secured with care.
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
169
269
ddfb228a62a4 rework in ch01
meillo@marmaro.de
parents: 266
diff changeset
170 The Internet is the common example for an untrusted network, but this applies to any other untrusted network too.
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
171
245
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
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
176
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
177
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
178
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
179
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
180
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
181
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
182
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
183 \subsection{Features}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
184
248
724cc6057105 complete names are now in small caps
meillo@marmaro.de
parents: 245
diff changeset
185 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
186
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
187
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
188 \subsubsection*{The source code}
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 \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
191
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
192 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
193
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
194 Some functionality of \masqmail\ 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.
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
195
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
196 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 parts of \masqmail's source code; they only add a file with a \verb+main()+ function each.
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
197
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
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
200 \subsubsection*{Features}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
201 \label{sec:masqmail-features}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
202
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
203 \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. Figure \ref{fig:masqmail-channels} shows this as a picture. (The ``online state'' input is explained a bit later.)
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
204
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
205 \begin{figure}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
206 \begin{center}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
207 \includegraphics[scale=0.75]{img/masqmail-channels.eps}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
208 \end{center}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
209 \caption{Incoming and outgoing channels of \masqmail}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
210 \label{fig:masqmail-channels}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
211 \end{figure}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
212
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
213 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
214
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
215 Mail queuing and alias expansion is both supported.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
216
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
217 The \masqmail\ executable can be called under various names for sendmail-compatibility reasons (see section \ref{sec:sendmail-compat}). 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.
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
218 %masqmail: mailq, mailrm, runq, rmail, smtpd/in.smtpd
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
219 %sendmail: hoststat, mailq, newaliases, purgestat, smtpd
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
220
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
221 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
222
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
223
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
224
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
225 \subsubsection*{Online detection and routes}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
226 \label{sec:masqmail-routes}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
227
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
228 \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.
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
229
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
230 \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
231
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
232 \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
233
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
234 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
235 ---
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
236
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
237 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
238
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
239 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
240
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
241 ---
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
242
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
243 \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
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
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
247
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
248
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
249
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
250
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
251
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
252
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
253
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
254 \section{Why \masqmail?}
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
255
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
256 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
257
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
258 Workstations use %FIXME
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
259
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
260 \textbf{Alternatives?}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
261 http://anfi.homeunix.org/sendmail/dialup10.html
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
262
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
263
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
264 << explain why masqmail is old and why it is interesting/important however! >>
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 << why is it worth to revive masqmail? >>
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
267
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
268
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
269
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
270
175
aab8499c9f2f moved ch06s content into other chapters to remove it
meillo@marmaro.de
parents: 160
diff changeset
271
96
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
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
274 \section{Problems to solve}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
275
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
276 << what problems has masqmail? >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
277
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
278 << what's the intention of this document? >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
279
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
280 << why is it worth the effort? >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
281
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
282
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
283
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
284
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
285
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
286 \section{Delimitation}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
287
150
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 142
diff changeset
288 << limit against stuff not covered here >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
289
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
290 pop3 stuff of masqmail is not regarded.
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
291
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
292
150
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 142
diff changeset
293