annotate thesis/tex/1-Introduction.tex @ 266:ea538a366b7d

added label
author meillo@marmaro.de
date Wed, 14 Jan 2009 21:39:50 +0100
parents b390fb627f10
children ddfb228a62a4
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
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
22 \paragraph{MTA}
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
23 \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
24
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
25 \paragraph{MUA}
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
26 \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
27
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
28 \paragraph{MDA}
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
29 \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
30
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
31 \begin{figure}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
32 \begin{center}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
33 \includegraphics[scale=0.75]{img/mail-agents.eps}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
34 \end{center}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
35 \caption{Mail agents and the way a mail message takes}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
36 \label{fig:mail-agents}
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
37 \end{figure}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
38
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
39
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
40
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
41
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
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
44 \subsubsection{Mail transfer with SMTP}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
45
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
46 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
47
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
48 A selection of important concepts of \SMTP\ is explained here.
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
49
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
50 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
51
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
52 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
53
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
54 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
55
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
56
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
57
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
58 \subsubsection{Mail messages}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
59
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
60 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
61
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
62 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
63
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
64 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
65
253
4dacd0d50342 work on intro and preface
meillo@marmaro.de
parents: 248
diff changeset
66 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
67
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
68 \begin{quote}
261
b390fb627f10 changed formating of verbatim blocks
meillo@marmaro.de
parents: 260
diff changeset
69 \footnotesize
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
70 \input{input/sample-email.txt}
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
71 \end{quote}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
72
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
73 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
74
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
75 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
76
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
77 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
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
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
81
229
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
82
c5f44219bc5d added text parts to intro
meillo@marmaro.de
parents: 175
diff changeset
83
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
84 \section{The \masqmail\ project}
102
95ebdfe51a55 moved some old text about masqmail
meillo@marmaro.de
parents: 97
diff changeset
85 \label{sec:masqmail}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
86
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
87 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
88
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
89 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
90
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
91 \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
92
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
93 \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
94
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
95 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
96
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
97
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
98
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
99
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
100 \subsection{Target field of \masqmail}
266
ea538a366b7d added label
meillo@marmaro.de
parents: 261
diff changeset
101 \label{sec:masqmail-target-field}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
102
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
103 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
104 \begin{quote}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
105 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
106 \hfill\citeweb{masqmail:homepage2}
160
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
107 \end{quote}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
108 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
109
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
110 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
111 \begin{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
112 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
113 \hfill\citeweb{packages.debian:masqmail}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
114 \end{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
115 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
116
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
117 \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
118
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
119 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
120
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
121 \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
122
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
123
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
124
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
125 \subsubsection*{Typical usage scenarios}
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
126
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
127 This section describes two common setups that makes senseful use of \masqmail. They are shown in figure \ref{fig:masqmail-typical-usage}.
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
128
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
129 \paragraph{Scenario 1}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
130 Imagine a home network consisting of some workstations without a server. The network is connected to the Internet.
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
131
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
132 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.
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
133 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. % pop3/imap
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
134
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
135 \paragraph{Scenario 2}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
136 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 making the workstations fetch mail from the server. % pop3/imap
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
137
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
138 \begin{figure}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
139 \begin{center}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
140 \includegraphics[scale=0.75]{img/masqmail-typical-usage.eps}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
141 \end{center}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
142 \caption{Typical usage scenarios for \masqmail}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
143 \label{fig:masqmail-typical-usage}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
144 \end{figure}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
145
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
146 %fixme: what about notebooks?
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
147 << notebooks >>
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
148
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
149 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 local network. 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
150
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
151
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
152
d8ad54f11e88 added text segment about the main goal of masqmail
meillo@marmaro.de
parents: 150
diff changeset
153
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
154 \subsubsection*{Limitations}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
155
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
156 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
157
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
158 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
159
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
160 \begin{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
161 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
162 \hfill\citeweb{masqmail:homepage2}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
163 \end{quote}
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
164
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
165 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.
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
166
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
167 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
168
245
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
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 \subsection{Features}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
181
248
724cc6057105 complete names are now in small caps
meillo@marmaro.de
parents: 245
diff changeset
182 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
183
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
184
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
185 \subsubsection*{The source code}
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 \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
188
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
189 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
190
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
191 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
192
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
193 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
194
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
195
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 \subsubsection*{Features}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
198 \label{sec:masqmail-features}
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
199
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
200 \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
201
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
202 \begin{figure}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
203 \begin{center}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
204 \includegraphics[scale=0.75]{img/masqmail-channels.eps}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
205 \end{center}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
206 \caption{Incoming and outgoing channels of \masqmail}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
207 \label{fig:masqmail-channels}
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
208 \end{figure}
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
209
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
210 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
211
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
212 Mail queuing and alias expansion is both supported.
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
213
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
214 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
215 %masqmail: mailq, mailrm, runq, rmail, smtpd/in.smtpd
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
216 %sendmail: hoststat, mailq, newaliases, purgestat, smtpd
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
217
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
218 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
219
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
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
222 \subsubsection*{Online detection and routes}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
223 \label{sec:masqmail-routes}
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
224
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
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 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
226
257
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
227 \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
228
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
229 \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
230
f4966e84815d rework in ch01
meillo@marmaro.de
parents: 253
diff changeset
231 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
232 ---
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
233
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
234 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
235
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
236 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
237
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
238 ---
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
239
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
240 \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
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
238
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
244
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
245
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
246
d60e5843db7f moved text from ch04 to ch01
meillo@marmaro.de
parents: 229
diff changeset
247
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
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
251 \section{Why \masqmail?}
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
252
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
253 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
254
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
255 Workstations use %FIXME
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
256
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
257 \textbf{Alternatives?}
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
258 http://anfi.homeunix.org/sendmail/dialup10.html
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
259
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
260
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
261 << explain why masqmail is old and why it is interesting/important however! >>
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 << why is it worth to revive masqmail? >>
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
264
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
265
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
266
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
267
175
aab8499c9f2f moved ch06s content into other chapters to remove it
meillo@marmaro.de
parents: 160
diff changeset
268
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
269
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
270
92
e050221efd38 much restructuring again
meillo@marmaro.de
parents: 89
diff changeset
271 \section{Problems to solve}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
272
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
273 << what problems has masqmail? >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
274
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
275 << what's the intention of this document? >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
276
245
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
277 << why is it worth the effort? >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
278
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
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
281
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
282
da83360f8442 restructurated and added content
meillo@marmaro.de
parents: 238
diff changeset
283 \section{Delimitation}
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
284
150
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 142
diff changeset
285 << limit against stuff not covered here >>
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
286
260
4931d56b61ea rework in ch01
meillo@marmaro.de
parents: 257
diff changeset
287 pop3 stuff of masqmail is not regarded.
96
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
288
8db526d7a678 reorganized preface and introduction (feels better now)
meillo@marmaro.de
parents: 93
diff changeset
289
150
0d097f4300ce moved typographic conventions from ch01 to preface
meillo@marmaro.de
parents: 142
diff changeset
290